.. DO NOT EDIT. .. THIS FILE WAS AUTOMATICALLY GENERATED BY SPHINX-GALLERY. .. TO MAKE CHANGES, EDIT THE SOURCE PYTHON FILE: .. "generated/model_applications/s2s_soil_moisture/PcpCombine_obsERA5_obsOnly_soilMoisturePreProcessing.py" .. LINE NUMBERS ARE GIVEN BELOW. .. only:: html .. note:: :class: sphx-glr-download-link-note :ref:`Go to the end ` to download the full example code. .. rst-class:: sphx-glr-example-title .. _sphx_glr_generated_model_applications_s2s_soil_moisture_PcpCombine_obsERA5_obsOnly_soilMoisturePreProcessing.py: PCP-Combine: Compute 1m Soil Moisture and 30 year Climatology ============================================================= model_applications/s2s_soil_moisture/PcpCombine_obsERA5_obsOnly_soilMoisturePreProcessing.conf .. GENERATED FROM PYTHON SOURCE LINES 10-20 Scientific Objective -------------------- This use case performs pre-processing on Soil Moisture data to prepare it to be run through Grid-Stat or another program for verification. As part of that pre-processing, 1 m soil moisture is calculated by adding the soil moisture for the top three layers (0-7cm, 7-28 cm, 28-100 cm), each multipled by the layer thickness. After 1m soil moisture is calculated for each month, a 30 year climatology is calculated by computing the mean and standard deviation for each month between 1991 and 2020. .. GENERATED FROM PYTHON SOURCE LINES 22-26 Version Added ------------- METplus version 6.1 .. GENERATED FROM PYTHON SOURCE LINES 28-45 Datasets -------- **Forecast:** None **Observation:** ERA-5 Land Soil Moisture top 3 layers **Climatology:** None **Location:** The input data required for PCP-Combine in this use case can be found in a sample data tarball. Each use case category will have one or more sample data tarballs. It is only necessary to download the tarball with the use case’s dataset and not the entire collection of sample data. Click here to access the METplus releases page and download sample data for the appropriate release: https://github.com/dtcenter/METplus/releases This tarball should be unpacked into the directory that you will set the value of INPUT_BASE. See :ref:`running-metplus` section for more information. .. GENERATED FROM PYTHON SOURCE LINES 47-51 METplus Components ------------------ This use case calls Regrid-Data-Plane once and PCP-Combine twice. .. GENERATED FROM PYTHON SOURCE LINES 53-74 METplus Workflow ---------------- **Beginning time (VALID_BEG):** 1991-01-01 **End time (VALID_END):** 2020-12-01 **Increment between beginning and end times (VALID_INCREMENT):** 1 month **Sequence of forecast leads to process (LEAD_SEQ):** 0 The call to Regrid-Data-Plane regrids the data to a 1 degree latitude/longitude grid. It loops over valid time, running once for each month between 1991 and 2020, for a total of 360 runs. The first PCP-Combine run computes the sum of soil moisture of the top three layers multiplied by the thickness of each layer. Like the call to Regrid-Data-Plane, it loops over valid time, running once for each valid time which is monthly data for 1991 through 2020. This is a total of 360 PCP-Combine runs. The second call to PCP-Combine computes a 30 year mean and standard deviation. It runs once for each month, for a total of 12 runs. .. GENERATED FROM PYTHON SOURCE LINES 76-85 METplus Configuration --------------------- METplus first loads all of the configuration files found in parm/metplus_config, then it loads any configuration files passed to METplus via the command line, i.e. parm/use_cases/model_applications/s2s_soil_moisture/PcpCombine_obsERA5_obsOnly_soilMoisturePreProcessing.conf .. highlight:: bash .. literalinclude:: ../../../../parm/use_cases/model_applications/s2s_soil_moisture/PcpCombine_obsERA5_obsOnly_soilMoisturePreProcessing.conf .. GENERATED FROM PYTHON SOURCE LINES 87-91 MET Configuration --------------------- There are no MET configuration files in this use case. .. GENERATED FROM PYTHON SOURCE LINES 93-97 Python Embedding ---------------- This use case does not use Python embedding. .. GENERATED FROM PYTHON SOURCE LINES 99-103 User Scripting -------------- There are no user scripts in this use case. .. GENERATED FROM PYTHON SOURCE LINES 105-114 Running METplus --------------- Pass the use case configuration file to the run_metplus.py script along with any user-specific system configuration files if desired:: run_metplus.py /path/to/METplus/parm/use_cases/model_applications/s2s_soil_moisture/PcpCombine_obsERA5_obsOnly_soilMoisturePreProcessing.conf /path/to/user_system.conf See :ref:`running-metplus` for more information. .. GENERATED FROM PYTHON SOURCE LINES 116-173 Expected Output --------------- A successful run will output the following both to the screen and to the logfile:: INFO: METplus has successfully finished running. Refer to the value set for **OUTPUT_BASE** to find where the output data was generated. Output for this use case will be found in {OUTPUT_BASE}/model_applications/s2s_soil_moisture/PcpCombine_obsERA5_obsOnly_soilMoisturePreProcessing. Output for the Regrid-Data-Plane run will be in the ERA5_land_regrid subdirectory and will contain 360 files, one for each month, with the format shown below (for January and February 1991):: * ERA5_soilm_1x1_layers_mon_199101.nc * ERA5_soilm_1x1_layers_mon_199102.nc Output from the first PCP-Combine call will be in the ERA5_land_soilm1m subdirectory and will contain 360 files, one for each month, with the format shown below (for January and February 1991):: * ERA5_soilm1m_1x1_mon_199101.nc * ERA5_soilm1m_1x1_mon_199102.nc Output from the second call to PCP-Combine will be in the ERA5_land_clim subdirectory and will contain 12 files:: * ERA5_soilm1m_1x1_30year_1991_2020_01_mean_stdev.nc * ERA5_soilm1m_1x1_30year_1991_2020_02_mean_stdev.nc * ERA5_soilm1m_1x1_30year_1991_2020_03_mean_stdev.nc * ERA5_soilm1m_1x1_30year_1991_2020_04_mean_stdev.nc * ERA5_soilm1m_1x1_30year_1991_2020_05_mean_stdev.nc * ERA5_soilm1m_1x1_30year_1991_2020_06_mean_stdev.nc * ERA5_soilm1m_1x1_30year_1991_2020_07_mean_stdev.nc * ERA5_soilm1m_1x1_30year_1991_2020_08_mean_stdev.nc * ERA5_soilm1m_1x1_30year_1991_2020_09_mean_stdev.nc * ERA5_soilm1m_1x1_30year_1991_2020_10_mean_stdev.nc * ERA5_soilm1m_1x1_30year_1991_2020_11_mean_stdev.nc * ERA5_soilm1m_1x1_30year_1991_2020_12_mean_stdev.nc The netCDF output files for the Regrid-Data-Plane run contain three variables (not including the lat/lon fields):: * swvl1(lat, lon) * swvl2(lat, lon) * swvl3(lat, lon) The netCDF output files for the first PCP-Combine run contains one variable (not including the lat/lon fields):: * soilm1m(lat, lon) The netCDF output files for the second PCP-Combine run contains two variables (not including the lat/lon fields):: * soilm1m_mean(lat, lon) * soilm1m_stdev(lat, lon) .. GENERATED FROM PYTHON SOURCE LINES 175-189 Keywords -------- .. note:: * S2SAppUseCase * S2SSoilMoistureAppUseCase * PCPCombineToolUseCase * RegridDataPlaneToolUseCase * NetCDFFileUseCase Navigate to the :ref:`quick-search` page to discover other similar use cases. .. _sphx_glr_download_generated_model_applications_s2s_soil_moisture_PcpCombine_obsERA5_obsOnly_soilMoisturePreProcessing.py: .. only:: html .. container:: sphx-glr-footer sphx-glr-footer-example .. container:: sphx-glr-download sphx-glr-download-jupyter :download:`Download Jupyter notebook: PcpCombine_obsERA5_obsOnly_soilMoisturePreProcessing.ipynb ` .. container:: sphx-glr-download sphx-glr-download-python :download:`Download Python source code: PcpCombine_obsERA5_obsOnly_soilMoisturePreProcessing.py ` .. container:: sphx-glr-download sphx-glr-download-zip :download:`Download zipped: PcpCombine_obsERA5_obsOnly_soilMoisturePreProcessing.zip ` .. only:: html .. rst-class:: sphx-glr-signature `Gallery generated by Sphinx-Gallery `_