Switch from WOA18 to WOA23

docs/users_guide/tasks/climatologyMapWoa.rst

@@ -4,7 +4,7 @@ climatologyMapWoa
 =================
 
 An analysis task for comparing potential temperature and salinity
-at various depths against WOA18 climatology.
+at various depths against WOA23 climatology.
 
 Component and Tags::
 
@@ -40,7 +40,7 @@ The following configuration options are available for this task::
   [climatologyMapWoaTemperature]
   ## options related to plotting climatology maps of potential temperature
   ## at various levels, including the sea floor against control model results
-  ## and WOA18 climatological data
+  ## and WOA23 climatological data
 
   # colormap for model/observations
   colormapNameResult = RdYlBu_r
@@ -66,8 +66,8 @@ The following configuration options are available for this task::
 
   [climatologyMapWoaSalinity]
   ## options related to plotting climatology maps of salinity
-  ## at various levels, including the sea floor against control model results 
-  ## and WOA18 climatological data
+  ## at various levels, including the sea floor against control model results
+  ## and WOA23 climatological data
 
   # colormap for model/observations
   colormapNameResult = haline
@@ -98,14 +98,14 @@ For more details, see:
 
 The option ``depths`` is a list of (approximate) depths at which to sample
 the temperature and salinity fields.  A value of ``'top'`` indicates the sea
-surface. Note that, for the annual climatology, WOA18 data is available down
-to 5500 m, whereas, for the seasonal or monthly climatologies, WOA18 data
+surface. Note that, for the annual climatology, WOA23 data is available down
+to 5500 m, whereas, for the seasonal or monthly climatologies, WOA23 data
 is only available down to 1500 m.
 
 Observations
 ------------
 
-:ref:`woa18_t_s`
+:ref:`woa23_t_s`
 
 Example Result
 --------------

docs/users_guide/tasks/regionalTSDiagrams.rst

@@ -80,7 +80,7 @@ The following configuration options are available for this task:
     # volMax = 1e12
 
     # Obserational data sets to compare against
-    obs = ['SOSE', 'WOA18']
+    obs = ['SOSE', 'WOA23']
 
     [TSDiagramsForOceanBasins]
     ## options related to plotting T/S diagrams of major ocean basins
@@ -119,7 +119,7 @@ The following configuration options are available for this task:
     zmax = 0
 
     # Obserational data sets to compare against
-    obs = ['WOA18']
+    obs = ['WOA23']
 
 Similar config sections are included for other region groups.
 
@@ -193,11 +193,11 @@ default is to read them from geojson file.
 Observations
 ------------
 The ``obs`` option contains a list of the names of observational data sets.
-Currently, "SOSE" and "WOA18" are the only data sets available, but we
+Currently, "SOSE" and "WOA23" are the only data sets available, but we
 anticipate adding several additional data sets in the near future.
 
 :ref:`sose`
-:ref:`woa18_t_s`
+:ref:`woa23_t_s`
 
 Other Config Options
 --------------------

docs/users_guide/tasks/timeSeriesOceanRegions.rst

@@ -58,7 +58,7 @@ The following configuration options are available for this task:
     # zmax = -400
 
     # Observational data sets to compare against
-    obs = ['SOSE', 'WOA18']
+    obs = ['SOSE', 'WOA23']
 
 Region Groups
 -------------
@@ -121,12 +121,12 @@ Observations
 ------------
 
 ``obs`` is a list of the observational data sets to plot as reference lines
-(constant in time).  Possible values are ``'SOSE'`` and ``'WOA18'``.  An empty
+(constant in time).  Possible values are ``'SOSE'`` and ``'WOA23'``.  An empty
 list can be provided if no observations should be plotted.
 
 :ref:`sose`
 
-:ref:`woa18_t_s`
+:ref:`woa23_t_s`
 
 Example Result
 --------------

mpas_analysis/default.cfg

@@ -517,7 +517,7 @@ meltSubdirectory = Melt
 soseSubdirectory = SOSE
 sshSubdirectory = SSH
 argoSubdirectory = ARGO
-woa18Subdirectory = WOA18
+woa23Subdirectory = WOA23
 schmidtkoSubdirectory = Schmidtko
 woceSubdirectory = WOCE
 no3Subdirectory = BGC/NO3
@@ -1716,7 +1716,7 @@ zmin = -1000
 zmax = 0
 
 # Observational data sets to compare against
-obs = ['WOA18']
+obs = ['WOA23']
 
 
 [timeSeriesAntarcticRegions]
@@ -1758,7 +1758,7 @@ variables = [{'name': 'temperature',
 # zmax = -400
 
 # Observational data sets to compare against
-obs = ['SOSE', 'WOA18']
+obs = ['SOSE', 'WOA23']
 
 
 [timeSeriesTransport]
@@ -1874,7 +1874,7 @@ normType = log
 # volMax = 1e12
 
 # Obserational data sets to compare against
-obs = ['SOSE', 'WOA18']
+obs = ['SOSE', 'WOA23']
 
 [TSDiagramsForGreenlandRegions]
 ## options related to plotting T/S diagrams of Greenland regions
@@ -1917,7 +1917,7 @@ zmax = 0
 #volMax = 1e12
 
 # Obserational data sets to compare against
-obs = ['WOA18']
+obs = ['WOA23']
 
 [TSDiagramsForArcticOceanRegions]
 ## options related to plotting T/S diagrams of Arctic regions
@@ -1960,7 +1960,7 @@ zmax = 0
 #volMax = 1e12
 
 # Obserational data sets to compare against
-obs = ['WOA18']
+obs = ['WOA23']
 
 [TSDiagramsForOceanBasins]
 ## options related to plotting T/S diagrams of major ocean basins
@@ -1999,7 +1999,7 @@ zmin = -1000
 zmax = 0
 
 # Obserational data sets to compare against
-obs = ['WOA18']
+obs = ['WOA23']
 
 
 [climatologyMapVel]
@@ -2463,7 +2463,7 @@ shallowVsDeepColormapDepth = -1000
 [climatologyMapWoaTemperatureShallow]
 ## options related to plotting climatology maps of potential temperature
 ## at various levels, including the sea floor against control model results
-## and WOA18 climatological data
+## and WOA23 climatological data
 
 # colormap for model/observations
 colormapNameResult = RdYlBu_r
@@ -2490,7 +2490,7 @@ normArgsDifference = {'vmin': -5., 'vmax': 5.}
 [climatologyMapWoaTemperatureDeep]
 ## options related to plotting climatology maps of potential temperature
 ## at various levels, including the sea floor against control model results
-## and WOA18 climatological data
+## and WOA23 climatological data
 
 # colormap for model/observations
 colormapNameResult = RdYlBu_r
@@ -2518,7 +2518,7 @@ normArgsDifference = {'vmin': -2., 'vmax': 2.}
 [climatologyMapWoaSalinityShallow]
 ## options related to plotting climatology maps of salinity
 ## at various levels, including the sea floor against control model results
-## and WOA18 climatological data
+## and WOA23 climatological data
 
 # colormap for model/observations
 colormapNameResult = haline
@@ -2545,7 +2545,7 @@ normArgsDifference = {'vmin': -1.5, 'vmax': 1.5}
 [climatologyMapWoaSalinityDeep]
 ## options related to plotting climatology maps of salinity
 ## at various levels, including the sea floor against control model results
-## and WOA18 climatological data
+## and WOA23 climatological data
 
 # colormap for model/observations
 colormapNameResult = haline

mpas_analysis/obs/observational_datasets.xml

@@ -188,6 +188,73 @@
     </nameInDocs>
   </observation>
 
+  <observation>
+    <name>
+      WOA23 Temperature and Salinity Climatology
+    </name>
+    <component>
+      ocean
+    </component>
+    <description>
+      The World Ocean Atlas 2023 (WOA23) was released on February 14, 2024 and
+      includes temperature, salinity, oxygen (and parameters Apparent Oxygen
+      Utilization and percent oxygen saturation) and inorganic nutrients
+      (phosphate, silicate, and nitrate). WOA23 includes approximately 1.8
+      million new oceanographic casts added to the WOD since WOA18’s release,
+      as well as renewed and updated quality controls.
+    </description>
+    <source>
+      [NOAA National Centers for Environmental Information (NCEI) website]
+      (https://www.ncei.noaa.gov/products/world-ocean-atlas)
+    </source>
+    <releasePolicy>
+      These data are openly available to the public. Please acknowledge the
+      use of these data with the text given in the acknowledgment attribute.
+    </releasePolicy>
+    <references>
+      - [Locarnini et al. (2024)](https://repository.library.noaa.gov/view/noaa/60599)
+      - [Reagan et al. (2024)](https://repository.library.noaa.gov/view/noaa/60600)
+    </references>
+    <bibtex>
+      @manual{locarnini_world_nodate,
+      title = {World Ocean Atlas 2023, Volume 1: Temperature},
+      url = {https://repository.library.noaa.gov/view/noaa/60599},
+      shorttitle = {World Ocean Atlas 2023, Volume 1},
+      year = {2024},
+      author = {Locarnini, Ricardo A. and Mishonov, Alexey V. and Baranova,
+      Olga K. and Reagan, James R. and Boyer, Timothy P. and Seidov, Dan and
+      Wang, Zhankun and Garcia, Hernan E. and Bouchard, Courtney and Cross,
+      Scott L. and Paver, Christopher R. and Dukhovskoy, Dmitry},
+      }
+
+      @manual{reagan_world_nodate,
+      title = {World Ocean Atlas 2023, Volume 2: Salinity},
+      url = {https://repository.library.noaa.gov/view/noaa/60600},
+      shorttitle = {World Ocean Atlas 2023, Volume 2},
+      author = {Reagan, James R. and Seidov, Dan and Wang, Zhankun and
+      Dukhovskoy, Dmitry and Boyer, Timothy P. and Locarnini, Ricardo A. and
+      Baranova, Olga K. and Mishonov, Alexey V. and Garcia, Hernan E. and
+      Bouchard, Courtney and Cross, Scott L. and Paver, Christopher R.},
+      year = {2024},
+      }
+    </bibtex>
+    <dataUrls>
+      - https://www.ncei.noaa.gov/access/world-ocean-atlas-2023/
+    </dataUrls>
+    <preprocessing>
+      - preprocess_observations/preprocess_woa23.py
+    </preprocessing>
+    <tasks>
+      - climatologyMapWoa
+    </tasks>
+    <subdirectory>
+      Ocean/WOA23
+    </subdirectory>
+    <nameInDocs>
+      woa23_t_s
+    </nameInDocs>
+  </observation>
+
   <observation>
     <name>
       AVISO Absolute Dynamic Topography