24.3. Tutorials

The following sections include examples of the run-time usage of make_adb and how the various options can be combined to produce different results.

24.3.1. Basic usage

Assuming you have created a configuration file for your simulation, building the atmospheric database from the command line is a very simple process. The default mode will work for most simulations, so no additional command line options need to be specified:

    prompt> make_adb my_sim.cfg
  

24.3.2. Printing the default configuration

To print the current default configuration, run the make_adb with the -config:

    prompt> make_adb -config
    Build Date: Aug 28 2003 08:40:46

    MODTRAN is configured
        MODTRAN executable path = /usr/local/mod4r01/mod4r01.exe
        MODTRAN Data directory path = /usr/local/mod4r01/DATA
        MODTRAN minimum frequency delta = 1
        MODTRAN output log filename = modtran.log

    FASCODE is configured
        FASCODE executable path = /usr/local/fascode-3.0/fascode.exe
        FASCODE PRT11 executable path = /usr/local/fascode-3.0/prt11.exe
        FASCODE tape3 directory path = /usr/local/fascode-3.0/tape3
        FASCODE output log filename = fascode.log
        FASCODE maximum frequency = 3500

    Background radiance file = /use/local/dirsig/lib/data/misc/star_light.dat
  

24.3.3. Using an alternate configuration

If you want to use an alternate configuration file (perhaps to use an experimental version of MODTRAN) you will need to utilize the -use_config option to make_adb. In this first example, we will specify an alternate configuration file and ask make_adb to read it in, perform the basic configuration tests, and print out the configuration. It is important that the -use_config option and the name of the configuration file is specified before the -config option in the command line arguments.

    prompt> cat ./my_make_adb.config
    MAKE_ADB_CFG = 3.0
    MODTRAN {
        MODTRAN_EXE = /home/joeuser/mod4r01/mod4r01.exe
        MODTRAN_DATA_DIR = /home/joeuser/mod4r01/DATA
        MODTRAN_MIN_DELTA = 1.0
    }
    BACKGROUND_RADIANCE_FILE = /usr/local/dirsig/lib/data/misc/star_light.dat

    prompt> make_adb -use_config ./my_make_adb.config -config 
    Build Date: Aug 28 2003 08:40:46

    MODTRAN is configured
        MODTRAN executable path = /home/joeuser/mod4r01/mod4r01.exe
        MODTRAN Data directory path = /home/joeuser/mod4r01/DATA
        MODTRAN minimum frequency delta = 1
        MODTRAN output log filename = modtran.log

    FASCODE is not configured

    Background radiance file = /use/local/dirsig/lib/data/misc/star_light.dat
  

To use this alternate configuration file to build an atmosphere using all the other default options, you modify your command line to include the -use_config option:

    prompt> make_adb -use_config ./my_make_adb.config my_sim.cfg
  

Other options (for example, -fast_sky, -max_range, etc.) can be combined with the -use_config option, however, the -use_config option should always be the first option in the list.