From 0a5df499943848ae7832c37a720ef0f2da30ac69 Mon Sep 17 00:00:00 2001 From: Xylar Asay-Davis Date: Sat, 18 Jan 2025 10:29:13 -0600 Subject: [PATCH] Fix several errors in the docs Some RST files have incorrect title underlining (good reason to switch to Markdown!). Some link names were not quite right. Some other formatting issues needed attention. --- docs/tutorials/dev_getting_started.rst | 1 + docs/users_guide/tasks/antshipTransects.rst | 3 +- .../tasks/climatologyMapSeaIceAlbedoNH.rst | 2 +- ...atologyMapSeaIceVolumeTendencyThermoNH.rst | 2 +- ...atologyMapSeaIceVolumeTendencyThermoSH.rst | 2 +- ...atologyMapSeaIceVolumeTendencyTranspNH.rst | 2 +- ...atologyMapSeaIceVolumeTendencyTranspSH.rst | 2 +- docs/users_guide/tasks/osnapTransects.rst | 6 +- mpas_analysis/obs/observational_datasets.xml | 57 ++++++++++--------- 9 files changed, 41 insertions(+), 36 deletions(-) diff --git a/docs/tutorials/dev_getting_started.rst b/docs/tutorials/dev_getting_started.rst index 487b71b06..8ff064578 100644 --- a/docs/tutorials/dev_getting_started.rst +++ b/docs/tutorials/dev_getting_started.rst @@ -442,6 +442,7 @@ following: If you find that new jobs are being lanuched for ncremap tasks, set: .. code-block:: ini + [execute] ... diff --git a/docs/users_guide/tasks/antshipTransects.rst b/docs/users_guide/tasks/antshipTransects.rst index a8694bbca..05856f0e6 100644 --- a/docs/users_guide/tasks/antshipTransects.rst +++ b/docs/users_guide/tasks/antshipTransects.rst @@ -1,7 +1,7 @@ .. _task_antshipTransects: antshipTransects -============= +================ An analysis task for interpolating MPAS fields to transects from ship-based observations around Antarctica and comparing them. @@ -15,7 +15,6 @@ Configuration Options The following configuration options are available for this task:: - [antshipTransects] [antshipTransects] ## options related to plotting model ship CTD transects. diff --git a/docs/users_guide/tasks/climatologyMapSeaIceAlbedoNH.rst b/docs/users_guide/tasks/climatologyMapSeaIceAlbedoNH.rst index 4b9c23a84..ae81357eb 100644 --- a/docs/users_guide/tasks/climatologyMapSeaIceAlbedoNH.rst +++ b/docs/users_guide/tasks/climatologyMapSeaIceAlbedoNH.rst @@ -1,7 +1,7 @@ .. _task_climatologyMapSeaIceAlbedoNH: climatologyMapSeaIceAlbedoNH -========================== +============================ An analysis task for plotting maps of Arctic sea ice broadband albedo. Care must be taken when evaluating albedo - long-time averages do not diff --git a/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyThermoNH.rst b/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyThermoNH.rst index 79ffee66a..fa86cf92c 100644 --- a/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyThermoNH.rst +++ b/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyThermoNH.rst @@ -1,7 +1,7 @@ .. _task_climatologyMapSeaIceVolumeTendencyThermoNH: climatologyMapSeaIceVolumeTendencyThermoNH -======================================== +========================================== An analysis task for plotting maps of Arctic sea ice volume tendency due to thermodynamics. diff --git a/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyThermoSH.rst b/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyThermoSH.rst index 3367c1c96..202c66a54 100644 --- a/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyThermoSH.rst +++ b/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyThermoSH.rst @@ -1,7 +1,7 @@ .. _task_climatologyMapSeaIceVolumeTendencyThermoSH: climatologyMapSeaIceVolumeTendencyThermoSH -======================================== +========================================== An analysis task for plotting maps of Antarctic sea ice volume tendency due to thermodynamics. diff --git a/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyTranspNH.rst b/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyTranspNH.rst index dcf97f6cb..56f5ca213 100644 --- a/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyTranspNH.rst +++ b/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyTranspNH.rst @@ -1,7 +1,7 @@ .. _task_climatologyMapSeaIceVolumeTendencyTranspNH: climatologyMapSeaIceVolumeTendencyTranspNH -======================================== +========================================== An analysis task for plotting maps of Arctic sea ice volume tendency due to transport. diff --git a/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyTranspSH.rst b/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyTranspSH.rst index 80166b2a0..ab59dae28 100644 --- a/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyTranspSH.rst +++ b/docs/users_guide/tasks/climatologyMapSeaIceVolumeTendencyTranspSH.rst @@ -1,7 +1,7 @@ .. _task_climatologyMapSeaIceVolumeTendencyTranspSH: climatologyMapSeaIceVolumeTendencyTranspSH -======================================== +========================================== An analysis task for plotting maps of Antarctic sea ice volume tendency due to transport. diff --git a/docs/users_guide/tasks/osnapTransects.rst b/docs/users_guide/tasks/osnapTransects.rst index 843c5b89f..73b599761 100644 --- a/docs/users_guide/tasks/osnapTransects.rst +++ b/docs/users_guide/tasks/osnapTransects.rst @@ -1,10 +1,10 @@ .. _task_osnapTransects: osnapTransects -============= +============== An analysis task for interpolating MPAS fields to -`Overturning in the Subpolar North Atlantic Program (OSNAP)`_ transects +`Overturning in the Subpolar North Atlantic Program (OSNAP)`_ transects and comparing them with ship-based observations. Component and Tags:: @@ -121,7 +121,7 @@ For details on these configuration options, see: Observations ------------ -:ref:`osnap` +:ref:`osnap_t_s` Example Result -------------- diff --git a/mpas_analysis/obs/observational_datasets.xml b/mpas_analysis/obs/observational_datasets.xml index 180686686..97e276b5c 100755 --- a/mpas_analysis/obs/observational_datasets.xml +++ b/mpas_analysis/obs/observational_datasets.xml @@ -1042,11 +1042,16 @@ ocean - AntShip - ---- - Southern Ocean (90°S-45°S) conservative temperature and absolute salinity profiles compilation (OCEAN ICE D1.1) + Southern Ocean (90°S-45°S) conservative temperature and absolute salinity + profiles compilation (OCEAN ICE D1.1) - This profile compilation contains conservative temperature and absolute salinity profiles computed from ship CTD, Argo floats and seal-borne profilers in the Southern Ocean (90°S-45°S) since 1972, using the GSW toolbox. It provides with an opportunity to investigate the broad scale climatology of the Southern Ocean hydrography on and off the continental shelf and facilitate localized timeseries analysis of the variability across various timescales. + This profile compilation contains conservative temperature and absolute + salinity profiles computed from ship CTD, Argo floats and seal-borne + profilers in the Southern Ocean (90°S-45°S) since 1972, using the GSW + toolbox. It provides with an opportunity to investigate the broad scale + climatology of the Southern Ocean hydrography on and off the continental + shelf and facilitate localized timeseries analysis of the variability + across various timescales. @@ -1605,27 +1610,27 @@ ocean - OSNAP is designed to provide a continuous record of the full-water - column, trans-basin fluxes of heat, mass and freshwater in the subpolar - North Atlantic. It consists of two legs: one extending from southern - Labrador to the southwestern tip of Greenland across the mouth of the - Labrador Sea (OSNAP West), and the second from the southeastern tip of - Greenland to Scotland (OSNAP East). The observing system also includes - subsurface floats (OSNAP Floats) in order to trace the pathways of - overflow waters in the basin and to assess the connectivity of currents - crossing the OSNAP line. The location of the OSNAP East and West legs - purposefully melds with a number of long-term observational efforts in - the North Atlantic: the Canadian repeat AR7W program in the Labrador - Sea; the German Labrador Sea western boundary array at 53°N; the - global Ocean Observatories Initiative node to be placed in the - southwestern Irminger Sea; the repeat A1E/AR7E hydrographic sections - across the Irminger and Iceland basins; and the Ellett line in the - Rockall region. Importantly, this observing system, in conjunction with - the RAPID/MOCHA array at 26ºN and the EU THOR/NACLIM program, will - provide a comprehensive measure of the Atlantic Meridional Overturning - Circulation (AMOC) and provide a means to evaluate intergyre - connectivity in the North Atlantic. OSNAP is a collaborative effort, - which includes several countries including US, Canada, China, France, + OSNAP is designed to provide a continuous record of the full-water + column, trans-basin fluxes of heat, mass and freshwater in the subpolar + North Atlantic. It consists of two legs: one extending from southern + Labrador to the southwestern tip of Greenland across the mouth of the + Labrador Sea (OSNAP West), and the second from the southeastern tip of + Greenland to Scotland (OSNAP East). The observing system also includes + subsurface floats (OSNAP Floats) in order to trace the pathways of + overflow waters in the basin and to assess the connectivity of currents + crossing the OSNAP line. The location of the OSNAP East and West legs + purposefully melds with a number of long-term observational efforts in + the North Atlantic: the Canadian repeat AR7W program in the Labrador + Sea; the German Labrador Sea western boundary array at 53°N; the + global Ocean Observatories Initiative node to be placed in the + southwestern Irminger Sea; the repeat A1E/AR7E hydrographic sections + across the Irminger and Iceland basins; and the Ellett line in the + Rockall region. Importantly, this observing system, in conjunction with + the RAPID/MOCHA array at 26ºN and the EU THOR/NACLIM program, will + provide a comprehensive measure of the Atlantic Meridional Overturning + Circulation (AMOC) and provide a means to evaluate intergyre + connectivity in the North Atlantic. OSNAP is a collaborative effort, + which includes several countries including US, Canada, China, France, Germany, Netherlands and the UK. @@ -1646,7 +1651,7 @@ - preprocess_observations/preprocessingOSNAP30day.ipynb - - climatologyMapOSNAP + - osnapTransects Ocean/OSNAP