Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology

A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

Juelich Rapid Spectral Simulation Code

The Juelich Rapid Spectral Simulation Code (JURASSIC) is a fast infrared radiative transfer model for the analysis of atmospheric remote sensing measurements.
https://github.com/slcs-jsc/jurassic

Category: Atmosphere
Sub Category: Radiative Transfer

Keywords

atmosphere atmospheric-science high-performance-computing infrared meteorology radiative-transfer remote-sensing stratosphere troposphere

Keywords from Contributors

measurements

Last synced: about 14 hours ago
JSON representation

Repository metadata

The Juelich Rapid Spectral Simulation Code (JURASSIC) is a fast infrared radiative transfer model for the analysis of atmospheric remote sensing measurements.

README.md

Juelich Rapid Spectral Simulation Code

The Juelich Rapid Spectral Simulation Code (JURASSIC) is a fast
infrared radiative transfer model for the analysis of atmospheric
remote sensing measurements.

logo

release (latest by date)
commits since latest release (by SemVer)
last commit
top language
code size
repo size
codacy
codecov
tests
docs
license
doi

Features

  • JURASSIC uses the emissivity growth approximation (EGA) or the
    Curtis-Godson approximation (CGA) to conduct infrared radiative
    transfer calculations. Band transmittances are obtained from
    pre-calculated look-up tables from line-by-line calculations.
  • The model was carefully tested in intercomparisons with the
    Karlsruhe Optimized and Precise Radiative Transfer Algorithm
    (KOPRA), the Reference Forward Model (RFM), and the Stand-alone AIRS
    Radiative Transfer Algorithm (SARTA).
  • JURASSIC features an MPI-OpenMP hybrid parallelization for efficient
    use on HPC systems.
  • Distributed open source under the terms and conditions of the
    GNU GPL.

Getting started

Prerequisites

This documentation describes the installation of JURASSIC on a Linux
system. A number of standard tools (gcc, git, make) and software
libraries are needed to install JURASSIC. The GNU Scientific
Library is required for numerical
calculations. A copy of this library can be found in the git
repository.

Start by downloading the source code from the git repository:

git clone https://github.com/slcs-jsc/jurassic.git

To update an existing installation use:

git pull https://github.com/slcs-jsc/jurassic.git

Installation

First, compile the GSL library needed for JURASSIC by using the build
script:

cd [jurassic_directory]/libs ./build.sh

Next, change to the source directory, edit the Makefile according to
your needs, and try to compile the code:

cd [jurassic_directory]/src
emacs Makefile
make

The binaries will be linked statically, i.e., they can be copied and
run on other machines. Sometimes this causes problems. In this case
remove the '-static' flag from the CFLAGS in the Makefile and compile
again.

By default we use rather strict compiler warnings. All warning
messages will be turned into errors and no binaries will be
produced. This behavior is enforced by the flag '-Werror'.

The binaries will remain in the jurassic/src/ directory.

To run the test cases to check the installation, please use:

make check

This will run sequentially through a set of tests. The execution of
the tests will stop if any of the tests fails. Please inspect the log
messages.

Run the examples

JURASSIC provides a project directory for testing the examples and
also to store other experiments:

cd [jurassic_directory]/projects

This shows how to run the example for the nadir sounder:

cd nadir ./run.sh

This shows how to run the example for the limb sounder:

cd ../limb ./run.sh

In both examples, we generate an observation geometry file,

cat obs.tab

a standard atmosphere for mid-latitudes,

cat atm.tab

and conduct radiative transfer calculations for two or three detector
channels:

cat rad.tab

The output of the simulation is verified by comparing it to reference
data. Additionally, gnuplot is used to create plots of the radiance
data:

Kernel functions are calculated using a finite difference method:

Further information

More detailed information for new users and developers of JURASSIC is
collected in the GitHub wiki.

These are the main references for citing the JURASSIC model in
scientific publications:

  • Baumeister, P. F. and Hoffmann, L.: Fast infrared radiative transfer
    calculations using graphics processing units: JURASSIC-GPU v2.0,
    Geosci. Model Dev., 15, 1855–1874,
    https://doi.org/10.5194/gmd-15-1855-2022, 2022.

  • Hoffmann, L., and M. J. Alexander, Retrieval of stratospheric
    temperatures from Atmospheric Infrared Sounder radiance measurements
    for gravity wave studies, J. Geophys. Res., 114, D07105,
    https://doi.org/10.1029/2008JD011241, 2009.

  • Hoffmann, L., Kaufmann, M., Spang, R., Müller, R., Remedios, J. J.,
    Moore, D. P., Volk, C. M., von Clarmann, T., and Riese, M.: Envisat
    MIPAS measurements of CFC-11: retrieval, validation, and
    climatology, Atmos. Chem. Phys., 8, 3671-3688,
    https://doi.org/10.5194/acp-8-3671-2008, 2008.

  • You can cite the source code of JURASSIC by using the DOI
    https://doi.org/10.5281/zenodo.4572889. This DOI represents all
    versions, and will always resolve to the latest one. Specific DOIs
    for each release of JURASSIC can be found on the zenodo web site.

Please see the citation file
for further information.

Contributing

We are interested in sharing JURASSIC for operational or research
applications. Please do not hesitate to contact us, if you have any
further questions or need support.

License

JURASSIC is distributed under the
GNU General Public License v3.0.

Contact

Dr. Lars Hoffmann

Jülich Supercomputing Centre, Forschungszentrum Jülich

e-mail: [email protected]

Citation (CITATION.cff)

# This CITATION.cff file was generated with cffinit.
# Visit https://bit.ly/cffinit to generate yours today!

cff-version: 1.2.0
title: Juelich Rapid Spectral Simulation Code (JURASSIC)
message: >-
  If you use this software, please cite it using the
  metadata from this file.
type: software
authors:
  - given-names: Lars
    family-names: Hoffmann
    email: [email protected]
    affiliation: Forschungszentrum Jülich
    orcid: 'https://orcid.org/0000-0003-3773-4377'
identifiers:
  - type: doi
    value: 10.5194/gmd-15-1855-2022
    description: Reference paper.
  - type: doi
    value: 10.1029/2008JD011241
    description: Reference paper.
  - type: doi
    value: 10.5194/acp-8-3671-2008
    description: Reference paper.
  - type: doi
    value: 10.5281/zenodo.4572889
    description: Latest release on Zenodo.
  - type: url
    value: 'https://github.com/slcs-jsc/jurassic'
    description: Software repository on GitHub.
abstract: >-
  The Juelich Rapid Spectral Simulation Code
  (JURASSIC) is a fast infrared radiative transfer
  model for the analysis of atmospheric remote
  sensing measurements.
keywords:
  - atmospheric science
  - remote sensing
  - radiative transfer
  - infrared
license: GPL-3.0

Owner metadata

GitHub Events

Total
Last Year

Committers metadata

Last synced: 5 days ago

Total Commits: 217
Total Committers: 2
Avg Commits per committer: 108.5
Development Distribution Score (DDS): 0.005

Commits in past year: 45
Committers in past year: 1
Avg Commits per committer in past year: 45.0
Development Distribution Score (DDS) in past year: 0.0

Name Email Commits
Lars Hoffmann l****n@f****e 216
The Codacy Badger b****r@c****m 1

Committer domains:

Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 0
Total pull requests: 2
Average time to close issues: N/A
Average time to close pull requests: 2 minutes
Total issue authors: 0
Total pull request authors: 1
Average comments per issue: 0
Average comments per pull request: 0.0
Merged pull request: 1
Bot issues: 0
Bot pull requests: 0

Past year issues: 0
Past year pull requests: 0
Past year average time to close issues: N/A
Past year average time to close pull requests: N/A
Past year issue authors: 0
Past year pull request authors: 0
Past year average comments per issue: 0
Past year average comments per pull request: 0
Past year merged pull request: 0
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/slcs-jsc/jurassic

Top Issue Authors

Top Pull Request Authors

  • codacy-badger (2)

Top Issue Labels

Top Pull Request Labels

Dependencies

.github/workflows/codecov.yml actions
  • actions/checkout v3 composite
  • codecov/codecov-action v3 composite
.github/workflows/docs.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • mattnotmitt/doxygen-action v1.9.4 composite
  • peaceiris/actions-gh-pages v3 composite
.github/workflows/tests.yml actions
  • actions/checkout v2 composite

Score: 3.091042453358316