rst link .DATA_FILE

equinor · Nov 16, 2023 · 4e73845 · 4e73845
1 parent 971331a
commit 4e73845
Show file tree

Hide file tree

Showing 11 changed files with 21 additions and 21 deletions.
diff --git a/docs/csv2res.rst b/docs/csv2res.rst
@@ -1,9 +1,9 @@
 csv2res
 =======
 
-Some of the modules inside res2df is able to write .DATA files
+Some of the modules inside res2df is able to write :term:`.DATA file`s
 from dataframes (in the format dumped by res2df). This makes it possible
-to produce .DATA files in any application that can write CSV files,
+to produce :term:`.DATA file`s in any application that can write CSV files,
 and use this tool to convert it into reservoir simulator files, or it can
 facilitate operations/manipulations of an existing deck using any tool
 that can work on CSV files, by first running res2csv on an input file,

diff --git a/docs/glossary.rst b/docs/glossary.rst
@@ -14,7 +14,7 @@ Glossary
 
     include file
         Files that provide inputs to reservoir simulators by using the INCLUDE statement
-        in .DATA files. By convention, these files often have the extension .INC/.inc
+        in :term:`.DATA file`s. By convention, these files often have the extension .INC/.inc
         (generally) or .GRDECL/.grdecl (for files included into the grid section).
 
     reservoir simulator output file

diff --git a/docs/introduction.rst b/docs/introduction.rst
@@ -127,14 +127,14 @@ More documentation on :doc:`usage/satfunc`.
 ^^^^^^^^^
 
 Extracts the information in the `EQUIL` table, `RSVD` and `RVVD` in the
-.DATA file. Can write back to include files.
+:term:`.DATA file`. Can write back to include files.
 
 More documentation on :doc:`usage/equil`.
 
 ``compdat``
 ^^^^^^^^^^^
 
-Extracts well connection data from the `COMPDAT` keyword in the .DATA file.
+Extracts well connection data from the `COMPDAT` keyword in the :term:`.DATA file`.
 For multi-segment wells, `WELSEGS` and `COMPSEGS` is also parsed. The
 data is available as three different dataframes, which can be merged.
 
@@ -147,7 +147,7 @@ More documentation on :doc:`usage/compdat`.
 ^^^^^^^^^^^^
 
 Extracts the information from the `GRUPTREE` and `WELSPECS` keyword, at
-all timesteps, from the .DATA file. The tree structure at each relevant
+all timesteps, from the :term:`.DATA file`. The tree structure at each relevant
 date can be returned as a dataframe of the edges, as a nested dictionary
 or as a `treelib` tree.
 
@@ -156,7 +156,7 @@ More documentation on :doc:`usage/gruptree`.
 ``pvt``
 ^^^^^^^
 
-Extracts PVT data from a .DATA file, from the keywords `PVTO`, `PVDG`,
+Extracts PVT data from a :term:`.DATA file`, from the keywords `PVTO`, `PVDG`,
 `DENSITY`, `ROCK` etc. Can write data back to include files.
 
 More documentation on :doc:`usage/pvt`.
@@ -173,7 +173,7 @@ More documentation on :doc:`usage/wcon`.
 ^^^^^^^^^^^^^^^^
 
 This is an internal helper module in order to represent finished or
-unfinished .DATA files and runs. The class ResdataFiles can cache binary
+unfinished :term:`.DATA file`s and runs. The class ResdataFiles can cache binary
 files that are recently read, and is able to locate the various output
 files based on the basename or the `.DATA` filename.
 
@@ -183,7 +183,7 @@ Metadata support
 parameters.txt
 ^^^^^^^^^^^^^^
 
-Metadata for each .DATA file are sometimes added in a text file named
+Metadata for each :term:`.DATA file` are sometimes added in a text file named
 ``parameters.txt``, alongside the Eclipse DATA file or one or two directory levels
 above it.
 

diff --git a/docs/res2csv.rst b/docs/res2csv.rst
@@ -4,7 +4,7 @@ res2csv
 Most of the functionality in res2df is exposed to the command line through
 the script *res2csv*. The first argument to this script is always
 the submodule (subcommand) from which you want functionality. Mandatory argument is
-always a .DATA file or sometimes individual include files, and
+always a :term:`.DATA file` or sometimes individual include files, and
 there is usually an ``--output`` option to specify which file to dump
 the CSV to. If you want output to your terminal, use ``-`` as the output filename.
 

diff --git a/docs/usage/compdat.rst b/docs/usage/compdat.rst
@@ -1,7 +1,7 @@
 compdat
 ^^^^^^^
 
-This module extracts COMPDAT, WELSEGS and COMPSEGS from a .DATA file.
+This module extracts COMPDAT, WELSEGS and COMPSEGS from a :term:`.DATA file`.
 
 Additionally, it will parse WELOPEN statements and emit new COMPDAT
 statements from the actions in WELOPEN.
@@ -26,7 +26,7 @@ for each of COMPDAT, and the segmentation keywords.
 .. warning:: When WELOPEN is in use, the dataframe can differ from Eclipse
   behaviour in certain circumstances. The dataframe representation from
   ``compdat`` does not separate from a "shut" well and the open-ness of its
-  connections. So in a .DATA FILE it is possible to shut a well, and then
+  connections. So in a :term:`.DATA file` it is possible to shut a well, and then
   reopen it, and get back the original open/shut state of individual
   connections prior to well shut.  The dataframe format will display `all`
   connections as open if a well is opened with defaulted indices.

diff --git a/docs/usage/equil.rst b/docs/usage/equil.rst
@@ -2,7 +2,7 @@ equil
 -----
 
 This is the res2df module for processing the ``SOLUTION`` section of
-the .DATA file.
+the :term:`.DATA file`.
 
 Supported keywords are ``EQUIL``, ``RSVD``, ``RVVD``, ``PBVD`` and
 ``PDVD``. Typical usage is

diff --git a/docs/usage/gruptree.rst b/docs/usage/gruptree.rst
@@ -1,13 +1,13 @@
 gruptree
 --------
 
-Extracts data from the GRUPTREE, GRUPNET and WELSPECS keywords from a .DATA file
+Extracts data from the GRUPTREE, GRUPNET and WELSPECS keywords from a :term:`.DATA file`
 and presents the production network either as pretty-printed ASCII or in a
 dataframe-representation.
 
-The GRUPTREE section of your .DATA file defines the production network
+The GRUPTREE section of your :term:`.DATA file` defines the production network
 from wells and up to the platform (and possibly also to a field having
-many platforms). In the .DATA file it be as simple as this::
+many platforms). In the :term:`.DATA file` it be as simple as this::
 
     START
       01 'JAN' 2000 /

diff --git a/docs/usage/pvt.rst b/docs/usage/pvt.rst
@@ -1,7 +1,7 @@
 pvt
 ---
 
-Extracts PVT related keyword data from the PROPS section in a .DATA file,
+Extracts PVT related keyword data from the PROPS section in a :term:`.DATA file`,
 typically the keywords ``PVTO``, ``PVDG``, ``DENSITY`` and ``ROCK``. Data from
 all keywords will be merged into one common dataframe.
 
@@ -76,7 +76,7 @@ When you are done with the table, you can generate new include files from your m
 
    pvt.df2res(dframe, filename="pvt.inc")
 
-When injecting this produced ``pvt.inc`` into any new .DATA file, ensure you
+When injecting this produced ``pvt.inc`` into any new :term:`.DATA file`, ensure you
 check which keywords have been written out, compared to what you gave in to
 `res2df.pvt` above. Any non-supported keywords will get lost in the import phase
 and need to be catered for outside res2df.

diff --git a/docs/usage/satfunc.rst b/docs/usage/satfunc.rst
@@ -1,7 +1,7 @@
 satfunc
 -------
 
-satfunc will extract saturation functions from .DATA files or from
+satfunc will extract saturation functions from :term:`.DATA file`s or from
 include files, these are the keywords ``SWOF``, ``SGOF``, ``SGWFN``, ``SWFN``,
 ``SOF2``, ``SGFN``, ``SOF3`` and  ``SLGOF``.
 

diff --git a/docs/usage/trans.rst b/docs/usage/trans.rst
@@ -6,7 +6,7 @@ from a simulation grid.
 
 Python API: :func:`res2df.trans.df`
 
-Applied on a .DATA file, the *trans* module will give out a dataframe of neighbour
+Applied on a :term:`.DATA file`, the *trans* module will give out a dataframe of neighbour
 connections
 
 .. code-block:: python

diff --git a/docs/usage/wcon.rst b/docs/usage/wcon.rst
@@ -2,7 +2,7 @@ wcon
 ^^^^
 
 This module extracts information from WCONHIST, WCONINJE, WCONINJH and
-WCONPROD from a .DATA file.
+WCONPROD from a :term:`.DATA file`.
 
 ..
   wcon.df(ResdataFiles('tests/data/reek/eclipse/model/2_R001_REEK-0.DATA')).head(15).to_csv('docs/usage/wcon.csv', index=False)