Merge branch 'main' into CatalogBuilder-2025.01.01

Author: Ciheim

doc/generation.rst

@@ -208,18 +208,33 @@ Refer to this `notebook <https://github.com/aradhakrishnanGFDL/canopy-cats/blob/
 Using FRE-CLI (GFDL only)
 -------------------------
 
-Follow the `fre-cli setup documentation <https://noaa-gfdl.readthedocs.io/projects/fre-cli/en/latest/setup.html>`_ to gain access to fre-cli.
+**1. Setup FRE-CLI**
+Setup FRE-CLI through Lmod following `their setup documentation <https://noaa-gfdl.readthedocs.io/projects/fre-cli/en/latest/setup.html>`_.
 
-Catalogs are generated by the following command: *fre catalog buildcatalog <INPUT_PATH> <OUTPUT_PATH>*
+.. code-block:: console
+
+  # find the most recent version of fre
+  module avail fre
+  # load the fre module. replace <NN> with the latest version
+  module load fre/2025.<NN>
+
+**2. Call the builder**
+
+
+Generate a catalog by running:
+
+.. code-block:: console
+
+  fre catalog build $INPUT_PATH $OUTPUT_PATH
 
 (OUTPUT_PATH should end with the desired output filename WITHOUT a file ending) See example below.
 
 .. code-block:: console
 
- fre catalog buildcatalog --overwrite /archive/path_to_data_dir ~/output
+ fre catalog build --overwrite /archive/path_to_data_dir ~/output
 
 
-See `Flags`_ here.
+See `additional options here. <https://noaa-gfdl.github.io/CatalogBuilder/generation.html#arguments-options>`_
 
 See `Fre-CLI Documentation here <https://noaa-gfdl.readthedocs.io/projects/fre-cli/en/latest/>`_