Skip to content

Latest commit

 

History

History
174 lines (135 loc) · 5.86 KB

README_JEDI.md

File metadata and controls

174 lines (135 loc) · 5.86 KB
Raw

README_JEDI.md

Created October 23, 2020 Updated October 27, 2020 Released October 28, 2020

The README.md file contains a lot of general information about this repository and the legacy build system based on autotools.

CRTM REL-2.4.0 JEDI environment build instructions

Preamble

CRTM v2.4.0 release (REL-2.4.0)

This is a fully functional release of CRTM v2.4.0.

Basic requirements:
(1) A Fortran 2003 compatible compiler.
(2) A netCDF4 / HDF5 library.
(3) A linux, macOS, or unix-style environment. This has not been tested under any Windows Fortran environments. (4) Bash shell is preferred. (5) A suitable JCSDA JEDI environment: either HPC enabled, a JEDI container, JEDI-stacks, or at a bare minimum ecbuild from ectools (google it).

=========================================================

Important Note: If reading this, you're cloning the CRTM development repository. The development repository is structured in a way that makes it less user friendly, but more amenable to development and testing. You're also reading about the JEDI Environment instructions. Please see README.md for all other uses.

In most cases, you'll be running CRTM inside of a JEDI bundle (e.g. fv3-bundle, ufo-bundle, etc.) so you'll have no need to follow any directions here. However, if you're interested in build CRTM stand-alone using a JEDI environment (i.e., for testing purposes, running the ctests, etc. ) continue reading.

=========================================================

Contents

  1. Configuration
  2. Building the library
  3. Testing the library
  4. Installing the library
    a. GNU Install
    • Linking to the library
      b. Uninstalling the library
  5. Cleaning up
  6. Feedback and contact info

Configuration, building, and testing the library

JCSDA CRTM v2.4.x Build Instructions

The CRTM development repository directory structure looks like:

 .
  ├── LICENSE  (CC0 license)
  ├── COPYING  (CC0 legal document)
  ├── NOTES
  ├── README.md 
  ├── Set_CRTM_Environment.sh
  ├── Get_CRTM_Binary_Data.sh  (gets the fix/ directory "manually")
  ├── CMakeLists.txt           (top-level configuration file for ecbuild)
  ├── configuration/
  ├── documentation/
  ├── fix/
  │   ├── AerosolCoeff/
  │   ├── CloudCoeff/
  │   ├── EmisCoeff/
  │   ├── SpcCoeff/
  │   └── TauCoeff/
  ├── scripts/
  │   └── shell/
  ├── src/
  │   ├── Ancillary/
  │   ├── AntennaCorrection/
  │   ├── AtmAbsorption/
  │   ├── AtmOptics/
  │   ├── AtmScatter/
  │   ├── Atmosphere/
  │   ├── CRTM_Utility/
  │   ├── ChannelInfo/
  │   ├── Coefficients/
  │   ├── GeometryInfo/
  │   ├── InstrumentInfo/
  │   ├── Interpolation/
  │   ├── NLTE/
  │   ├── Options/
  │   ├── RTSolution/
  │   ├── SensorInfo/
  │   ├── SfcOptics/
  │   ├── Source_Functions/
  │   ├── Statistics/
  │   ├── Surface/
  │   ├── TauProd/
  │   ├── TauRegress/
  │   ├── Test_Utility/
  │   ├── User_Code/
  │   ├── Utility/
  │   ├── Validation/
  │   ├── Zeeman/
  └── test/
      └── Main/

In the above list, the directories highlighted in bold (bold in markdown), are the key directories of interest to the casual developer.

JEDI Configuration

Note By default, the "fix/" directory is not provided in the CRTM. It is obtainable by running the Get_CRTM_Binary_Data.sh script, see steps below.

Configuration git clone https://github.com/JCSDA/crtm (you've probably done this already)
cd crtm/ git fetch git pull sh Get_CRTM_Binary_Data.sh

Build Instructions

    mkdir build
    cd build
    ecbuild pathtocrtm

where pathrocrtm is where the crtm/ diretory is located. In this example if you're in the crtm/build directory, typing ecbuild .. will work.

    make -j8     (-j8 means 8 parallel make processes, adjust the number to your machine)
    ctest

This should compile all of the source codes, create a libcrtm.so file, compile the tests, and finally run the various ctests. If you're making changes to code, simply running the make command will detect your code changes and rebuild everything for you.

Linking to the library

You'll find the library file (libcrtm.so) in build/lib and the module files (e.g., *.mod) in module/crtm/**. You can link to these files using any codes that call the CRTM.

Uninstalling the library

To "uninstall" the library (assuming you haven't moved the installation directory contents somewhere else) you can type: cd build/ rm -rf * (make sure you do this in the build/ directory where you ran ecbuild)

Cleaning Up

cd build/
rm -rf *  (make sure you do this in the build/ directory where you ran `ecbuild`)

Additional options You can modify the various compiler flags, etc in the crtm/cmake/ directory. There you will find several configuration files based on differen compilers.

Feedback and Contact Information

CRTM SUPPORT EMAIL: crtm-support@googlegroups.com OR visit https://forums.jcsda.org/

If you have problems building the library please include the generated "config.log" file in your email correspondence.

Known Issues

(1) Any "Transmitance Coefficient" generation codes included in src/ are not functional. Contact CRTM support above for details.
(2) Testing was only done on modern gfortran compilers.

Troubleshooting

TBD