diff --git a/NCARtips.md b/NCARtips.md index 15b6f7d..822f9bf 100644 --- a/NCARtips.md +++ b/NCARtips.md @@ -38,5 +38,5 @@ and can be accessed via the following steps: 1. Open a default desktop icon. 1. Select the browser client. 1. Type `xterm` and hit enter to open a terminal. -1. In the terminal, run `cd ${CUPID_ROOT}/examples/coupled_model/computed_notebooks/quick-run/_build/html` to enter the `html` directory. +1. In the terminal, run `cd ${CUPID_ROOT}/examples/key_metrics/computed_notebooks/_build/html` to enter the `html` directory. 1. From the updated directory, run `firefox index.html &` to open a web browser pointed at the generated web page. diff --git a/README.md b/README.md index 56ca5b9..8be2e31 100644 --- a/README.md +++ b/README.md @@ -53,18 +53,18 @@ please see the [Contributor's Guide](https://ncar.github.io/CUPiD/contributors_g ## Running CUPiD currently provides an example for generating diagnostics. -To test the package out, try to run `examples/coupled-model`: +To test the package out, try to run `examples/key-metrics`: ``` bash $ conda activate cupid-dev -$ cd examples/coupled_model +$ cd examples/key_metrics $ # machine-dependent: request multiple compute cores $ cupid-run $ cupid-build # Will build HTML from Jupyter Book ``` -After the last step is finished, you can use Jupyter to view generated notebooks in `${CUPID_ROOT}/examples/coupled-model/computed_notebooks/quick-run` -or you can view `${CUPID_ROOT}/examples/coupled-model/computed_notebooks/quick-run/_build/html/index.html` in a web browser. +After the last step is finished, you can use Jupyter to view generated notebooks in `${CUPID_ROOT}/examples/key-metrics/computed_notebooks` +or you can view `${CUPID_ROOT}/examples/key-metrics/computed_notebooks/_build/html/index.html` in a web browser. Notes: diff --git a/cupid/build.py b/cupid/build.py index 21fe6ee..f5a4bf3 100755 --- a/cupid/build.py +++ b/cupid/build.py @@ -39,12 +39,11 @@ def build(config_path): with open(config_path) as fid: control = yaml.safe_load(fid) - sname = control["data_sources"]["sname"] run_dir = control["data_sources"]["run_dir"] - subprocess.run(["jupyter-book", "clean", f"{run_dir}/computed_notebooks/{sname}"]) + subprocess.run(["jupyter-book", "clean", f"{run_dir}/computed_notebooks"]) subprocess.run( - ["jupyter-book", "build", f"{run_dir}/computed_notebooks/{sname}", "--all"], + ["jupyter-book", "build", f"{run_dir}/computed_notebooks", "--all"], ) for component in control["compute_notebooks"]: for notebook in control["compute_notebooks"][component]: @@ -57,7 +56,7 @@ def build(config_path): ): shutil.copytree( f"{run_dir}/ADF_output", - f"{run_dir}/computed_notebooks/{sname}/_build/html/ADF", + f"{run_dir}/computed_notebooks/_build/html/ADF", ) # Originally used this code to copy jupyter book HTML to a location to host it online @@ -69,7 +68,7 @@ def build(config_path): # remote_dir = control["publish_location"]["remote_dir"] # this seems more complicated than expected...people have mentioned paramiko library? # subprocess.run(["mkdir", "-p", remote_dir]) - # subprocess.run(["scp", "-r", f"{run_dir}/computed_notebooks/{sname}/_build/html/*", + # subprocess.run(["scp", "-r", f"{run_dir}/computed_notebooks/_build/html/*", # f"{user}@{remote_mach}:{remote_dir}"]) return None diff --git a/cupid/run.py b/cupid/run.py index d791669..8ed31a0 100755 --- a/cupid/run.py +++ b/cupid/run.py @@ -192,7 +192,7 @@ def run( # Grab paths run_dir = os.path.realpath(os.path.expanduser(control["data_sources"]["run_dir"])) - output_dir = run_dir + "/computed_notebooks/" + control["data_sources"]["sname"] + output_dir = run_dir + "/computed_notebooks/" temp_data_path = run_dir + "/temp_data" nb_path_root = os.path.realpath( os.path.expanduser(control["data_sources"]["nb_path_root"]), diff --git a/cupid/util.py b/cupid/util.py index 851303e..26044ae 100644 --- a/cupid/util.py +++ b/cupid/util.py @@ -141,7 +141,7 @@ def setup_book(config_path): os.makedirs(output_root, exist_ok=True) - output_dir = f'{output_root}/{control["data_sources"]["sname"]}' + output_dir = f"{output_root}" os.makedirs(output_dir, exist_ok=True) diff --git a/docs/addingnotebookstocollection.md b/docs/addingnotebookstocollection.md index 5ff9e0d..1369a08 100644 --- a/docs/addingnotebookstocollection.md +++ b/docs/addingnotebookstocollection.md @@ -6,7 +6,6 @@ Generally, a good fit for a diagnostic notebook is one that reads in CESM output 1. Install the `environments/cupid-analysis.yml` environment (see [installation instructions](https://ncar.github.io/CUPiD/index.html#installing)). Make sure that your notebook runs properly in this environment. If there are conflicts or missing dependencies, open an issue or talk to CUPiD developers so we can find a solution. 2. In your notebook, move all variables you might want to change (paths to data, dates to select, etc.) to a cell near the top. For example: - sname = "run_name" data_path = "path/to/data" dates = {"start_date" = "01/01/01", "end_date" = "01/01/02"} diff --git a/docs/config.md b/docs/config.md index 07290f5..4dc3bec 100644 --- a/docs/config.md +++ b/docs/config.md @@ -5,8 +5,6 @@ This page describes the fields in the configuration file that might commonly be CUPiD Config 1 The data sources section of the configuration file describes general data sources and expected directory structure for running CUPiD. -`sname`: nickname for this configuration as a string. This will be used as the name of the folder your computed notebooks are put in - CUPiD Config 2 The computation config section of the configuration file supplies the default kernel for running CUPiD. This should usually be `cupid-analysis`. If a contributor wants to include additional packages, please create an issue describing the packages you'd like to add to this conda environment. diff --git a/examples/coupled_model/config.yml b/examples/coupled_model/config.yml index 42fd8d5..b8e1380 100644 --- a/examples/coupled_model/config.yml +++ b/examples/coupled_model/config.yml @@ -4,10 +4,6 @@ # Data Sources # ################ data_sources: - # sname is any string used as a nickname for this configuration. It will be - ### used as the name of the folder your computed notebooks are put in - sname: quick-run - # run_dir is the path to the folder you want ### all the files associated with this configuration ### to be created in @@ -17,7 +13,7 @@ data_sources: ### look for your template notebooks in. It doesn't have to ### be inside run_dir, or be specific to this project, as ### long as the notebooks are there - nb_path_root: nblibrary + nb_path_root: ../../nblibrary ###################### # Computation Config # diff --git a/examples/external_diag_packages/config.yml b/examples/external_diag_packages/config.yml index 3e99304..53bd758 100644 --- a/examples/external_diag_packages/config.yml +++ b/examples/external_diag_packages/config.yml @@ -4,10 +4,6 @@ # Data Sources # ################ data_sources: - # sname is any string used as a nickname for this configuration. It will be - ### used as the name of the folder your computed notebooks are put in - sname: external_diag_packages - # run_dir is the path to the folder you want ### all the files associated with this configuration ### to be created in @@ -17,7 +13,7 @@ data_sources: ### look for your template notebooks in. It doesn't have to ### be inside run_dir, or be specific to this project, as ### long as the notebooks are there - nb_path_root: nblibrary + nb_path_root: ../../nblibrary ###################### # Computation Config # diff --git a/examples/key_metrics/config.yml b/examples/key_metrics/config.yml index 48273df..a913e24 100644 --- a/examples/key_metrics/config.yml +++ b/examples/key_metrics/config.yml @@ -4,10 +4,6 @@ # Data Sources # ################ data_sources: - # sname is any string used as a nickname for this configuration. It will be - ### used as the name of the folder your computed notebooks are put in - sname: key_metrics - # run_dir is the path to the folder you want ### all the files associated with this configuration ### to be created in @@ -17,7 +13,7 @@ data_sources: ### look for your template notebooks in. It doesn't have to ### be inside run_dir, or be specific to this project, as ### long as the notebooks are there - nb_path_root: nblibrary + nb_path_root: ../../nblibrary ###################### # Computation Config # diff --git a/nblibrary/atm/link_to_ADF.ipynb b/nblibrary/atm/link_to_ADF.ipynb index 3e6e3fb..75adc48 100644 --- a/nblibrary/atm/link_to_ADF.ipynb +++ b/nblibrary/atm/link_to_ADF.ipynb @@ -61,7 +61,7 @@ "base_case_name = None\n", "case_year_range = None\n", "base_case_year_range = None\n", - "# adf_root will be external_diag_packages/computed_notebooks/external_diag_packages/ADF/" + "# adf_root will be external_diag_packages/computed_notebooks/ADF/" ] }, {