This page is being constantly worked on. If anything is not clear, please contact me.

Resources

The source code

The source code of sfit4 can be found as a git repository under https://github.com/NCAR/sfit-core-code The current officical branch is is Official_Release_v1.0.18.

Compiling the source code

For any problems with compiling contact:
Mathias on mathias (dot) palm (at) uni (minus) bremen (dot) de

use the latest available gfortran compiler.
if you installed a new compiler or upgraded your OS, or if there are any other problems, run
make clean
first
compile with
make
you find three executable: hbin, sfit4 and pspec

The processing environment, a collection of tool, mainly python, can be found under https://github.com/NCAR/sfit-processing-environment.

Documentation

The aktual documentation is found the the source code repository in the directory

NDACC testcases

A collection of NDACC retrieval cases. The sfit4-tests have to purposes:

provide tentative cases for users and developers to check their setup, compiler setting, and more.
They can also be used to check other versions of sfit4 against the results of former version.

How it works if you want to check your setup, compiler options in the same version

Assume the sfit4 code dirctory is sfit-core-code and the processing environment is in sfit-processing-environment
Change into sfit-core-code/sfit4_testbed
run python < PATH to sfit-processing-environment > /sfit4_testbed/run_testcases.py [--nohbin] [--nosfit4] [--noerror]

--nohbin

hbin not being run

--nosfit4

sfit4 not being run

--noerror

no KB matrix calculations performed. This saves a lot of time.

How it works if you want to check against other versions

Assume the sfit4 code dirctory is sfit-core-code and the processing environment is in sfit-processing-environment
Download the file and unzip, but not in sfit-core-code. You have a directory sfit4-tests. It contains several testcases and summary. GAS fields which are the 'original' summary files for the release given in the table header.
Modify test.cfg:

sfit4_dir = PATH to sfit-core-code
testdir = PATH to sfit4-tests

Change into sfit-core-code/sfit4-testbed
Run sfit-processing-environment/sfit4_testbed/run_testcases.py The code visits every test case file, creates a hbin, runs sfit4 and compares several parameters from the output.

After sfit4 is run, the summary files are read in and the results are printed out. It read in the summary files in TESTDIR which have the name summary. GAS (called original) and the compares them to GAS/summary. Printed out are the absolute values and the difference in percent.
It may be necessary to adapt the sfit4.ctl a bit to accomodate changes made in later versions: You may need to recreate the spectral file hbin and adapt the file sfit4.ctl according to its name. The remaining testcases for HF and CH4 follow soon. There is no error calculation setup coming with them, nor is it suitable for batch input.

Official NDACC spectroscopy

Download the linelist here. You may have to adpat the hbin.ctl file in order to create a new spectroscopy file.