From 94a74346d486d1cf3d4a4193b4cfce6706d4c88b Mon Sep 17 00:00:00 2001 From: Charlotte Merchant Date: Tue, 12 Mar 2024 19:26:29 -0600 Subject: [PATCH 01/10] Basic updates to obs_impact_tool docs --- .../programs/obs_impact_tool/obs_impact_tool.rst | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst index 5299da8916..13cbda8607 100644 --- a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst +++ b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst @@ -136,7 +136,20 @@ namelist. | debug | logical | If true print out debugging info. | +-----------------+--------------------+-----------------------------------------------------------------------------+ -| +| + +Filter Use +-------- +The following namelist options are required to use the obs_impact_tool code during the filter because ''obs_impact_tool'' is used to create the ''control_impact_runtime.txt'' file. + +:: + + &assim_tools_nml + adjust_obs_impact = .true. + obs_impact_filename = 'control_impact_runtime.txt' + / + +| Examples -------- From 3c8ef27312723a0c5cdcb07313d8787991905e6d Mon Sep 17 00:00:00 2001 From: Charlotte Merchant Date: Wed, 13 Mar 2024 10:58:30 -0600 Subject: [PATCH 02/10] Added table with namelist options to specify for filter and fixed typo. --- .../modules/assimilation/assim_tools_mod.rst | 2 +- .../obs_impact_tool/obs_impact_tool.rst | 19 ++++++++++++++++++- 2 files changed, 19 insertions(+), 2 deletions(-) diff --git a/assimilation_code/modules/assimilation/assim_tools_mod.rst b/assimilation_code/modules/assimilation/assim_tools_mod.rst index 502e2419de..f392f69f2a 100644 --- a/assimilation_code/modules/assimilation/assim_tools_mod.rst +++ b/assimilation_code/modules/assimilation/assim_tools_mod.rst @@ -289,7 +289,7 @@ Description of each namelist entry *type:* character(len=256) If adjust_obs_impact is true, the name of the file with the observation types and quantities and state quantities - that should have have an additional factor applied to the correlations during assimilation. + that should have an additional factor applied to the correlations during assimilation. ``allow_any_impact_values`` *type:* logical diff --git a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst index 13cbda8607..4563620340 100644 --- a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst +++ b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst @@ -140,7 +140,7 @@ namelist. Filter Use -------- -The following namelist options are required to use the obs_impact_tool code during the filter because ''obs_impact_tool'' is used to create the ''control_impact_runtime.txt'' file. +To use the ``obs_impact_tool`` code during the filter, the following namelist options are required because ``obs_impact_tool`` is used to create the ``control_impact_runtime.txt`` file as specified above. :: @@ -151,6 +151,23 @@ The following namelist options are required to use the obs_impact_tool code duri | +.. container:: + + +-------------------+--------------------+-----------------------------------------------------------------------------+ + | Item | Type | Description | + +===================+====================+=============================================================================+ + | adjust_obs_impact | logical | Name of an ascii text file which describes how the interaction of | + | | | observations to state vector values and observations to other observations | + | | | should be controlled. See the Overview section for details about the format | + | | | of the input file entries. | + +-------------------+--------------------+-----------------------------------------------------------------------------+ + |obs_impact_filename| character(len=512) | If adjust_obs_impact is true, the name of the file with the observation | + | | | types and quantities and state quantities that should have an additional | + | | | factor applied to the correlations during assimilation. | + +-------------------+--------------------+-----------------------------------------------------------------------------+ + +| + Examples -------- From 39c2207e0368189b69802d372385cf6dfb58ca6a Mon Sep 17 00:00:00 2001 From: Charlotte Merchant Date: Wed, 13 Mar 2024 13:05:58 -0600 Subject: [PATCH 03/10] Added building section to docs. --- .../programs/obs_impact_tool/obs_impact_tool.rst | 14 ++++++-------- 1 file changed, 6 insertions(+), 8 deletions(-) diff --git a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst index 4563620340..4a4f1a7675 100644 --- a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst +++ b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst @@ -30,14 +30,6 @@ between 0 and 1 to be specified. This tool allows related collections of observation types and state vector quantities to be named and then express the relationship of the named groups to each other in a concise way. It can also define relationships by exceptions. -All the listed observation types and state vector quantities must be known by the system. -If they are not, look at the -&preprocess_nml :: input_items namelist which specifies which *obs_def_xxx_mod.f90* files -are included, which is where observation types are defined. -Quantities for different regimes (atmosphere, ocean, land, etc.) are defined in -``assimilation_code/modules/observations/xxx_quantities_mod.f90`` and explained in -:doc:`../../modules/observations/obs_kind_mod` - Format of the input file can be any combination of these types of sections: .. container:: @@ -168,6 +160,12 @@ To use the ``obs_impact_tool`` code during the filter, the following namelist op | +Building +-------- +In the quickbuild.sh script, add ``obs_impact_tool`` to the list of serial_programs. + +All the listed observation types and state vector quantities must be known by the system. If they are not, look at the &preprocess_nml :: input_items namelist which specifies which *obs_def_xxx_mod.f90* files are included, which is where observation types are defined. Quantities for different regimes (atmosphere, ocean, land, etc.) are defined in ``assimilation_code/modules/observations/xxx_quantities_mod.f90`` and explained in :doc:`../../modules/observations/obs_kind_mod` + Examples -------- From d32dd767cf9ea7bf13bf72dcce0bc4f5fc99fa50 Mon Sep 17 00:00:00 2001 From: Charlotte Merchant Date: Wed, 13 Mar 2024 18:20:27 -0400 Subject: [PATCH 04/10] Update obs_impact_tool.rst wording Co-authored-by: nancy collins --- assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst index 4a4f1a7675..4385d47e24 100644 --- a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst +++ b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst @@ -132,7 +132,7 @@ namelist. Filter Use -------- -To use the ``obs_impact_tool`` code during the filter, the following namelist options are required because ``obs_impact_tool`` is used to create the ``control_impact_runtime.txt`` file as specified above. +To use the output file from the ``obs_impact_tool`` during the run of filter, the following namelist options are required because ``obs_impact_tool`` is used to create the ``control_impact_runtime.txt`` file as specified above. :: From 452554a10af54bfea490ec85b67af3097e7292c1 Mon Sep 17 00:00:00 2001 From: Charlotte Merchant Date: Sun, 17 Mar 2024 17:16:22 -0600 Subject: [PATCH 05/10] Updates with specifics on how to use the code. --- .../obs_impact_tool/obs_impact_tool.rst | 20 +++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst index 4385d47e24..360c1002b3 100644 --- a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst +++ b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst @@ -30,7 +30,13 @@ between 0 and 1 to be specified. This tool allows related collections of observation types and state vector quantities to be named and then express the relationship of the named groups to each other in a concise way. It can also define relationships by exceptions. -Format of the input file can be any combination of these types of sections: +Building +-------- +Begin by building ``obs_impact_tool`` by adding ``obs_impact_tool`` to the list of serial_programs in the quickbuild.sh script. + +All the listed observation types and state vector quantities must be known by the system. If they are not, look at the &preprocess_nml :: input_items namelist which specifies which *obs_def_xxx_mod.f90* files are included, which is where observation types are defined. Quantities for different regimes (atmosphere, ocean, land, etc.) are defined in ``assimilation_code/modules/observations/xxx_quantities_mod.f90`` and explained in :doc:`../../modules/observations/obs_kind_mod` + +Next, you should create an input file, ``cross_correlations.txt``, where you define the impacts of specific observations. The format of the input file can be any combination of these types of sections: .. container:: @@ -93,6 +99,10 @@ Format of the input file can be any combination of these types of sections: Namelist interface ``&obs_impact_tool_nml`` must be read from file ``input.nml``. +Then, you should run the ``obs_impact_tool`` with the input file ``cross_correlations.txt`` to create an output file ``control_impact_runtime.txt``. For specific formatting, refer to the details in the Namelist subsection. + +After you have the output file to control the impact of observations on state vector items and other observation values, you can use this in your assimilation at filter run time by setting the ``obs_impact_filename`` field in ``assim_tools_nml`` to the name of your output file. Specific syntax is provided in the Filter Use subsection. + Namelist -------- @@ -160,16 +170,10 @@ To use the output file from the ``obs_impact_tool`` during the run of filter, th | -Building --------- -In the quickbuild.sh script, add ``obs_impact_tool`` to the list of serial_programs. - -All the listed observation types and state vector quantities must be known by the system. If they are not, look at the &preprocess_nml :: input_items namelist which specifies which *obs_def_xxx_mod.f90* files are included, which is where observation types are defined. Quantities for different regimes (atmosphere, ocean, land, etc.) are defined in ``assimilation_code/modules/observations/xxx_quantities_mod.f90`` and explained in :doc:`../../modules/observations/obs_kind_mod` - Examples -------- -To prevent chemistry species from impacting the meterological variables in the model state, and vice versa: +The following is an example of an input file to prevent chemistry species from impacting the meterological variables in the model state, and vice versa: .. container:: From a8330053a6d0d03ccd13ac8cd1600832d7b10854 Mon Sep 17 00:00:00 2001 From: Charlotte Merchant Date: Tue, 19 Mar 2024 11:00:23 -0600 Subject: [PATCH 06/10] Tighten up docs, remove filter use and last section --- .../obs_impact_tool/obs_impact_tool.rst | 62 +++---------------- 1 file changed, 10 insertions(+), 52 deletions(-) diff --git a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst index 360c1002b3..96e66027ad 100644 --- a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst +++ b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst @@ -101,7 +101,15 @@ Namelist interface ``&obs_impact_tool_nml`` must be read from file ``input.nml`` Then, you should run the ``obs_impact_tool`` with the input file ``cross_correlations.txt`` to create an output file ``control_impact_runtime.txt``. For specific formatting, refer to the details in the Namelist subsection. -After you have the output file to control the impact of observations on state vector items and other observation values, you can use this in your assimilation at filter run time by setting the ``obs_impact_filename`` field in ``assim_tools_nml`` to the name of your output file. Specific syntax is provided in the Filter Use subsection. +After you have the output file to control the impact of observations on state vector items and other observation values, you can use this in your assimilation at filter run time by setting the ``obs_impact_filename`` field in ``assim_tools_nml`` to the name of your output file. +:: + + &assim_tools_nml + adjust_obs_impact = .true. + obs_impact_filename = 'control_impact_runtime.txt' + / + +| Namelist -------- @@ -140,36 +148,6 @@ namelist. | -Filter Use --------- -To use the output file from the ``obs_impact_tool`` during the run of filter, the following namelist options are required because ``obs_impact_tool`` is used to create the ``control_impact_runtime.txt`` file as specified above. - -:: - - &assim_tools_nml - adjust_obs_impact = .true. - obs_impact_filename = 'control_impact_runtime.txt' - / - -| - -.. container:: - - +-------------------+--------------------+-----------------------------------------------------------------------------+ - | Item | Type | Description | - +===================+====================+=============================================================================+ - | adjust_obs_impact | logical | Name of an ascii text file which describes how the interaction of | - | | | observations to state vector values and observations to other observations | - | | | should be controlled. See the Overview section for details about the format | - | | | of the input file entries. | - +-------------------+--------------------+-----------------------------------------------------------------------------+ - |obs_impact_filename| character(len=512) | If adjust_obs_impact is true, the name of the file with the observation | - | | | types and quantities and state quantities that should have an additional | - | | | factor applied to the correlations during assimilation. | - +-------------------+--------------------+-----------------------------------------------------------------------------+ - -| - Examples -------- @@ -190,24 +168,4 @@ The following is an example of an input file to prevent chemistry species from i IMPACT chem met 0.0 met chem 0.0 - END IMPACT - -Modules used ------------- - -:: - - types_mod - utilities_mod - parse_args_mod - -Files ------ - -- two text files, one input and one output. -- obs_impact_tool.nml - -References ----------- - -- none + END IMPACT \ No newline at end of file From c303bb098f3d8f86a82af4421740de457f5b3121 Mon Sep 17 00:00:00 2001 From: Charlotte Merchant Date: Tue, 19 Mar 2024 11:05:10 -0600 Subject: [PATCH 07/10] Tighten up overview --- .../obs_impact_tool/obs_impact_tool.rst | 28 ++++++++----------- 1 file changed, 12 insertions(+), 16 deletions(-) diff --git a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst index 96e66027ad..4553243cf0 100644 --- a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst +++ b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst @@ -4,27 +4,23 @@ PROGRAM ``obs_impact_tool`` Overview -------- -The standard DART algorithms compute increments for an observation and then compute corresponding increments for each +Standard DART algorithms compute increments for an observation then compute corresponding increments for each model state variable due to that observation. To do this, DART computes a sample regression coefficient using the prior ensemble distributions of a state variable and the observation. The increments for each member of the observation are -multiplied by this regression coefficient and then added to the corresponding prior ensemble member for the state -variable. However, in many cases, it is appropriate to reduce the impact of an observation on a state variable; this is -called localization. The standard DART algorithms allow users to specify a localization that is a function of the +multiplied by this regression coefficient and added to the corresponding prior ensemble member for the state +variable. However, it may be appropriate to use localization, to reduce the impact of an observation on a state variable. +The standard DART algorithms allow users to specify a localization that is a function of the horizontal (and optionally vertical) distance between the observation and the state variable. The localization is a value between 0 and 1 and multiplies the regression coefficient when updating state ensemble members. +You may also want to do an additional localization that is a function of the type of observation and the state vector quantity. -Sometimes, it may be desirable to do an additional localization that is a function of the -type of observation and the -state vector quantity. This program allows users to construct a table that is read by -filter at run-time to localize the -impact of sets of observation types on sets of state vector quantities. Users can create -named sets of observation types -and sets of state vector quantities and specify a localization for the impact of the -specified observation types on the state vector quantities. - -An example would be to create a subset of observations of tracer concentration for a variety of tracers, and a subset of -dynamic state variable quantities like temperatures and wind components. It has been common to set this localization -value to 0 so that tracer observations have no impact on dynamic state quantities, however, the tool allows values +This program allows users to construct a table that is read by filter at run-time to localize the impact of sets of observation +types on sets of state vector quantities. Users can create named sets of observation types and sets of state vector quantities +and specify a localization for the impact of the specified observation types on the state vector quantities. + +An example would be to create a subset of observations of tracer concentration for a variety of tracers and a subset of +dynamic state variable quantities like temperatures and wind components. It is common to set this localization +value to 0 so that tracer observations have no impact on dynamic state quantities; however, the tool allows values between 0 and 1 to be specified. This tool allows related collections of observation types and state vector quantities to be named and then express the From 6f59ba61b14659da6351ec90ac67daa57f0fc97b Mon Sep 17 00:00:00 2001 From: Charlotte Merchant Date: Tue, 19 Mar 2024 11:10:40 -0600 Subject: [PATCH 08/10] Add anchors --- .../programs/obs_impact_tool/obs_impact_tool.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst index 4553243cf0..7f1eb16b09 100644 --- a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst +++ b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst @@ -95,9 +95,9 @@ Next, you should create an input file, ``cross_correlations.txt``, where you def Namelist interface ``&obs_impact_tool_nml`` must be read from file ``input.nml``. -Then, you should run the ``obs_impact_tool`` with the input file ``cross_correlations.txt`` to create an output file ``control_impact_runtime.txt``. For specific formatting, refer to the details in the Namelist subsection. +Then, you should run the ``obs_impact_tool`` with the input file ``cross_correlations.txt`` to create an output file ``control_impact_runtime.txt``. For specific formatting, refer to the details in the `Namelist`_ subsection. -After you have the output file to control the impact of observations on state vector items and other observation values, you can use this in your assimilation at filter run time by setting the ``obs_impact_filename`` field in ``assim_tools_nml`` to the name of your output file. +After you have the output file to control the impact of observations on state vector items and other observation values, you can use this in your assimilation at filter run time by setting the ``obs_impact_filename`` field in ``assim_tools_nml`` to the name of your output file. Descriptions of these fields are available at :doc:`../../modules/assimilation/assim_tools_mod`. :: &assim_tools_nml From f02e628f3678d634c9e6607dbc0fc463e52dea8d Mon Sep 17 00:00:00 2001 From: Helen Kershaw Date: Mon, 22 Apr 2024 16:12:48 -0400 Subject: [PATCH 09/10] step by step instructions for obs_impact_tool following google documentation style guide(ish) --- .../modules/assimilation/assim_tools_mod.rst | 2 + .../obs_impact_tool/obs_impact_tool.rst | 122 +++++++++--------- 2 files changed, 60 insertions(+), 64 deletions(-) diff --git a/assimilation_code/modules/assimilation/assim_tools_mod.rst b/assimilation_code/modules/assimilation/assim_tools_mod.rst index f392f69f2a..daac0cac12 100644 --- a/assimilation_code/modules/assimilation/assim_tools_mod.rst +++ b/assimilation_code/modules/assimilation/assim_tools_mod.rst @@ -1,3 +1,5 @@ +.. _assim_tools: + MODULE assim_tools_mod ====================== diff --git a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst index 7f1eb16b09..f081a4197e 100644 --- a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst +++ b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst @@ -4,41 +4,33 @@ PROGRAM ``obs_impact_tool`` Overview -------- -Standard DART algorithms compute increments for an observation then compute corresponding increments for each -model state variable due to that observation. To do this, DART computes a sample regression coefficient using the prior -ensemble distributions of a state variable and the observation. The increments for each member of the observation are -multiplied by this regression coefficient and added to the corresponding prior ensemble member for the state -variable. However, it may be appropriate to use localization, to reduce the impact of an observation on a state variable. -The standard DART algorithms allow users to specify a localization that is a function of the -horizontal (and optionally vertical) distance between the observation and the state variable. The localization is a -value between 0 and 1 and multiplies the regression coefficient when updating state ensemble members. -You may also want to do an additional localization that is a function of the type of observation and the state vector quantity. - -This program allows users to construct a table that is read by filter at run-time to localize the impact of sets of observation -types on sets of state vector quantities. Users can create named sets of observation types and sets of state vector quantities -and specify a localization for the impact of the specified observation types on the state vector quantities. - -An example would be to create a subset of observations of tracer concentration for a variety of tracers and a subset of -dynamic state variable quantities like temperatures and wind components. It is common to set this localization -value to 0 so that tracer observations have no impact on dynamic state quantities; however, the tool allows values -between 0 and 1 to be specified. - -This tool allows related collections of observation types and state vector quantities to be named and then express the -relationship of the named groups to each other in a concise way. It can also define relationships by exceptions. - -Building --------- -Begin by building ``obs_impact_tool`` by adding ``obs_impact_tool`` to the list of serial_programs in the quickbuild.sh script. +The standard DART algorithms work by calculating increments for an observation and then determining corresponding +increments for each variable in the state due to that observation. This is done by computing a sample regression +coefficient using the prior ensemble distributions of a state variable and the observation. The increments for each member +of the ensemble are multiplied by this coefficient and then added to the corresponding prior ensemble member for the variable. -All the listed observation types and state vector quantities must be known by the system. If they are not, look at the &preprocess_nml :: input_items namelist which specifies which *obs_def_xxx_mod.f90* files are included, which is where observation types are defined. Quantities for different regimes (atmosphere, ocean, land, etc.) are defined in ``assimilation_code/modules/observations/xxx_quantities_mod.f90`` and explained in :doc:`../../modules/observations/obs_kind_mod` +However, in many cases it is necessary to limit the influence of an observation on a variable; this is known as localization. +DART provides a way to specify a localization, known as cutoff, based on the horizontal and vertical distance between the observation +and the variable. -Next, you should create an input file, ``cross_correlations.txt``, where you define the impacts of specific observations. The format of the input file can be any combination of these types of sections: +In some situations, you may want additional localization based on the type of observation and the state quanity. +``obs_impact_tool`` allows users to create a table that filter reads during runtime to localize the impact of certain types of +observations on specific state vector quantities. Users can define sets of observation types and state vector quantities, and +specify localization for the impact of those observation types on the state vector quantities. -.. container:: +For example, you can create a subset of observations related to tracer concentration for various tracers, and a subset of +dynamic state variables like temperatures and wind components. Typically, it is common practice to set this localization value +to 0 to prevent tracer observations from affecting dynamic state quantities. However, ``obs_impact_tool`` allows you to specify values +between 0 and 1. - :: +#. Build ``obs_sequence_tool`` by adding ``obs_impact_tool`` to the list of serial_programs in the quickbuild.sh script for the model you are using. + Run ./quickbuild.sh to build all the DART programs. +#. Create an input file for ``obs_sequence_tool`` to define the impacts of observations. In the examples on this page, the input file + is called `cross_correlations.txt`. + The format of the input file can be any combination of the following types of sections: + .. code:: bash # hash mark starts a comment. @@ -93,22 +85,48 @@ Next, you should create an input file, ``cross_correlations.txt``, where you def groupname1 groupname1 0.0 END IMPACT -Namelist interface ``&obs_impact_tool_nml`` must be read from file ``input.nml``. + The following is an example of an input file to prevent chemistry species from impacting the meterological variables in the model state, and vice versa: -Then, you should run the ``obs_impact_tool`` with the input file ``cross_correlations.txt`` to create an output file ``control_impact_runtime.txt``. For specific formatting, refer to the details in the `Namelist`_ subsection. + .. code:: bash -After you have the output file to control the impact of observations on state vector items and other observation values, you can use this in your assimilation at filter run time by setting the ``obs_impact_filename`` field in ``assim_tools_nml`` to the name of your output file. Descriptions of these fields are available at :doc:`../../modules/assimilation/assim_tools_mod`. -:: + GROUP chem + QTY_CO QTY_NO QTY_C2H4 + END GROUP - &assim_tools_nml - adjust_obs_impact = .true. - obs_impact_filename = 'control_impact_runtime.txt' - / + GROUP met + ALLQTYS EXCEPT chem + END GROUP -| + IMPACT + chem met 0.0 + met chem 0.0 + END IMPACT -Namelist --------- + +#. Run ``obs_impact_tool`` using your `cross_correlations.txt` as input. ``obs_impact_tool`` will create an output file, + named `control_impact_runtime.txt` in this example. + + .. code:: text + + &obs_impact_tool_nml + input_filename = 'cross_correlations.txt' + output_filename = 'control_impact_runtime.txt' + / + + +#. Set the following namelist options in :ref:`&assim_tools_nml` to use `control_impact_runtime.txt` in filter. + Filter will apply your selected observation impacts during assimilation. + + .. code:: text + + &assim_tools_nml + adjust_obs_impact = .true. + obs_impact_filename = 'control_impact_runtime.txt' + / + + +obs_impact_tool Namelist +------------------------ This namelist is read from the file ``input.nml``. Namelists start with an ampersand '&' and terminate with a slash '/'. Character strings that contain a '/' must be enclosed in quotes to prevent them from prematurely terminating the @@ -141,27 +159,3 @@ namelist. +-----------------+--------------------+-----------------------------------------------------------------------------+ | debug | logical | If true print out debugging info. | +-----------------+--------------------+-----------------------------------------------------------------------------+ - -| - -Examples --------- - -The following is an example of an input file to prevent chemistry species from impacting the meterological variables in the model state, and vice versa: - -.. container:: - - :: - - GROUP chem - QTY_CO QTY_NO QTY_C2H4 - END GROUP - - GROUP met - ALLQTYS EXCEPT chem - END GROUP - - IMPACT - chem met 0.0 - met chem 0.0 - END IMPACT \ No newline at end of file From 1ba4106c18036416abf4a12e4e9f6838ac776cb5 Mon Sep 17 00:00:00 2001 From: Helen Kershaw Date: Mon, 22 Apr 2024 16:17:18 -0400 Subject: [PATCH 10/10] change 'users' to you and clarify state variable --- .../programs/obs_impact_tool/obs_impact_tool.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst index f081a4197e..d84cd53f14 100644 --- a/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst +++ b/assimilation_code/programs/obs_impact_tool/obs_impact_tool.rst @@ -11,11 +11,11 @@ of the ensemble are multiplied by this coefficient and then added to the corresp However, in many cases it is necessary to limit the influence of an observation on a variable; this is known as localization. DART provides a way to specify a localization, known as cutoff, based on the horizontal and vertical distance between the observation -and the variable. +and the state variable. In some situations, you may want additional localization based on the type of observation and the state quanity. -``obs_impact_tool`` allows users to create a table that filter reads during runtime to localize the impact of certain types of -observations on specific state vector quantities. Users can define sets of observation types and state vector quantities, and +``obs_impact_tool`` allows you to create a table that filter reads during runtime to localize the impact of certain types of +observations on specific state vector quantities. You can define sets of observation types and state vector quantities, and specify localization for the impact of those observation types on the state vector quantities. For example, you can create a subset of observations related to tracer concentration for various tracers, and a subset of