diff --git a/environment-scheme-sim.yml b/environment-suite-sim.yml similarity index 100% rename from environment-scheme-sim.yml rename to environment-suite-sim.yml diff --git a/scm/doc/TechGuide/chap_hsd.tex b/scm/doc/TechGuide/chap_hsd.tex index 2ae75dca7..3ecf01901 100644 --- a/scm/doc/TechGuide/chap_hsd.tex +++ b/scm/doc/TechGuide/chap_hsd.tex @@ -31,6 +31,21 @@ \subsection{About the CCPP Suite Simulator} The CCPP Suite Simulator (CSS) emulates the evolution of the internal physics state provided by the SDF. There are different deployments of the scheme simulator, depending on the role(s) and order of the physical processes in the SDF we are emulating (e.g. time vs. process-split), that need further attention. For instance, SDFs consisting of only process-split physics schemes can be handled simply by adding the simulator to the end of the SDF, since for process-split schemes the order is not critical to the evolution of the internal physics state. On the other hand, for SDFs that contain time-split processes, where the simulator is added is important to preserve the order of the internal state evolution. +\subsection{Python Dependencies} +\label{subsection: pydepend} +The scripts here require a few python packages that may not be found by default in all python installations. There is a YAML file with the python environment needed to run the script in \execout{ccpp-scm/scm\_suite\_sim.yml}. To create and activate this environment using conda: + +Create environment (only once): + +\execout{> conda env create -f environment-suite-sim.yml} + +This will create the conda environment \execout{scm\_suite\_sim} + + +Activate environment: + +\execout{> conda activate scm\_suite\_sim} + \subsection{Enabling the CCPP Suite Simulator} To use the CSS in the CCPP-SCM two modifications need to be made: @@ -79,7 +94,7 @@ \subsection{Creating Custom Data for Simulator} Navigate to \execout{ccpp-scm/scm/etc/scripts/ccpp\_scheme\_sim} -Provided with the SCM are scripts to generate data for the suite simulator using output from a previous SCM run. The first script, \execout{create\_1D\_simdata.py}, extracts the physics tendencies from a user specified time interval, which are used for constant forcing in the suite simulator. The other script, \execout{create\_2D\_simdata.py}, creates a two-dimensional forcing dataset. The suite simulator interpoaltes these forcings in time. +Provided with the SCM are scripts to generate data for the suite simulator using output from a previous SCM run. The first script, \execout{create\_1D\_CSSdata.py}, extracts the physics tendencies from a user specified time interval, which are used for constant forcing in the suite simulator. The other script, \execout{create\_2D\_CSSdata.py}, creates a two-dimensional forcing dataset. The suite simulator interpoaltes these forcings in time. \begin{enumerate} \item Run the SCM, using TWPICE case with \execout{GFS\_v17\_p8} suite. @@ -90,12 +105,12 @@ \subsection{Creating Custom Data for Simulator} \item Create 2D forcing data for the CSS, using SCM output from TWPICE case with \execout{GFS\_v17\_p8} suite. \begin{lstlisting}[language=bash] cd ccpp-scm/scm/etc/scripts/ccpp_scheme_sim -./create_2D_simdata.py --cases twpice --suites SCM_GFS_v17_p8 +./create_2D_CSSdata.py --cases twpice --suites SCM_GFS_v17_p8 \end{lstlisting} \item Create constant forcing data for the CSS, using SCM output, at forecast time 3600s, from TWPICE case with \execout{GFS\_v17\_p8} suite. \begin{lstlisting}[language=bash] cd ccpp-scm/scm/etc/scripts/ccpp_scheme_sim -./create_1D_simdata.py --cases twpice --suites SCM_GFS_v17_p8 --time 3600 +./create_1D_CSSdata.py --cases twpice --suites SCM_GFS_v17_p8 --time 3600 \end{lstlisting} \end{enumerate} diff --git a/scm/doc/TechGuide/css_nml_ex2.txt b/scm/doc/TechGuide/css_nml_ex2.txt new file mode 100644 index 000000000..01c8bd0f9 --- /dev/null +++ b/scm/doc/TechGuide/css_nml_ex2.txt @@ -0,0 +1,10 @@ +&ccpp_suite_sim_nml + suite_sim_file = 'ccpp-scm/scm/etc/scripts/ccpp_scheme_sim/data_scheme_sim_1D.twpice.SCM_GFS_v16.nc' + nprc_sim = 7 + prc_LWRAD_cfg = 1, 0, 1 + prc_SWRAD_cfg = 1, 0, 2 + prc_PBL_cfg = 1, 0, 3 + prc_GWD_cfg = 1, 0, 4 + prc_SCNV_cfg = 1, 1, 5 + prc_DCNV_cfg = 1, 1, 6 + prc_cldMP_cfg = 0, 1, 7 diff --git a/scm/doc/TechGuide/main.pdf b/scm/doc/TechGuide/main.pdf index 75b868912..33ce81a83 100644 Binary files a/scm/doc/TechGuide/main.pdf and b/scm/doc/TechGuide/main.pdf differ