Given the widespread use of MarsGRAM in the community a MarsGRAM-style interface is supplied with the MCD. The software for this is contained in the mcd/mcdgm directory and the main program is called mcdgm. The program first has to be compiled, see Section 3.3. A comprehensive explanation of the interface is included in the Detailed Design Document.
The MCDGM interface performs in a very similar way to MarsGRAM version 3.5 with regards to input and output and is self-explanatory in its usage. A sample interactive session is shown here.
> mcdgm
Mars Climate Database Version 2.0 - MarsGRAM style interface
Enter file name for full output listing (CON for screen listing):
con
Enter file name for tabulated output:
list
Enter month, day of month, 4-digit year,
and maximum number of positions (all integers) - Enter zero
number of positions to read positions from TRAJDATA file
7,20,1976,10
Enter initial GMT Time in Hours, Minutes, Seconds (all integers)
12,50,00
Date = 7/20/1976 Julian Date = 2442980.0 GMT Time = 12:50: 0.0
Ls = 98.9 degrees for this date.
Select dust scenario (1) Viking dust scenario (2) Low dust scenario
(3) Dust storm, tau=2 (4) Dust storm, tau=5
1
Enter perturbation model: 1=none, 2=large scale
3=small scale, 4=large scale and small scale
1
Enter seed for random number generator (any positive integer < 30,000)
1
Select x-code and y-code for plotable output versus desired parameter(s):
Code Parameter
-- -------------------------
1 Height (above reference ellipsoid, km)
2 Height (above local terrain, km)
3 Latitude (deg.)
4 Longitude (deg.)
5 Time from start (Earth seconds)
6 Time from start (Martian Sols)
7 Areocentric Longitude of Sun, Ls (deg.)
8 Hour Angle for Local Time (Mars hours * 15)
Use y-code = 0 for plotable output vs x-code variable only
2,0
Enter 0 for normal (MKS) units for density,
1 for log-base-10 or 2 for % difference from COSPAR
0
Enter initial latitude and West longitude in degrees
22.,48.
Surface elevation = -1.217483 km at this location
Enter Initial Height relative to zero datum (km)
-1.217483
Enter Increments in Height (km), Latitude (deg.),
West Longitude (deg.), and Time (sec.)
10.,0.,0.,0.
The above example produces the following output at the console (Viking Lander 1 entry profile). The user can first try this example to check that the MCDGM interface has been installed correctly; the run documented here was made using the ``bright dust'' dataset and there will of course be differences in the data values output if the other dataset, or any of the variability models are used.
Mars Climate Database Version 2.0 - MarsGRAM style interface
Date = 7/20/1976 Julian Date = 2442980.0 GMT Time = 12:50: 0.0
Random seed = 1
Time (rel. to T0) = 0.0 sec. ( 0.000 sols) Ls = 98.9 deg.
Height = -1.22 km ( 0.00 km) Scale Hgt H(p) = 11.98 H(rho) = 11.98 km
Latitude = 22.000 degrees West Longitude = 48.000 degrees
Sun Latitude = 25.00 deg. Mars Orbital Radius = 1.640 AU
Sun Longitude = 111.31 deg. Local Time = 16.22 Mars hours
Temperature = 233.2 K Pressure = 6.833E+02 N/m**2
Density (Low, Avg., High) = 1.466E-02 1.533E-02 1.601E-02 kg/m**3
Departure, COSPAR NH Mean = -15.5 % -11.7 % -7.8 %
Density perturbation = 0.13 % of mean value
Eastward Wind = -4.0 m/s Northward Wind = 0.4 m/s
--------------------------------------------------------------------------
Time (rel. to T0) = 0.0 sec. ( 0.000 sols) Ls = 98.9 deg.
Height = 8.78 km ( 10.00 km) Scale Hgt H(p) = 10.55 H(rho) = 10.55 km
Latitude = 22.000 degrees West Longitude = 48.000 degrees
Sun Latitude = 25.00 deg. Mars Orbital Radius = 1.640 AU
Sun Longitude = 111.31 deg. Local Time = 16.22 Mars hours
Temperature = 205.4 K Pressure = 2.805E+02 N/m**2
Density (Low, Avg., High) = 6.834E-03 7.130E-03 7.426E-03 kg/m**3
Departure, COSPAR NH Mean = -4.7 % -0.5 % 3.6 %
Density perturbation = -0.77 % of mean value
Eastward Wind = -8.9 m/s Northward Wind = -0.2 m/s
--------------------------------------------------------------------------
Time (rel. to T0) = 0.0 sec. ( 0.000 sols) Ls = 98.9 deg.
Height = 18.78 km ( 20.00 km) Scale Hgt H(p) = 9.65 H(rho) = 9.65 km
Latitude = 22.000 degrees West Longitude = 48.000 degrees
Sun Latitude = 25.00 deg. Mars Orbital Radius = 1.640 AU
Sun Longitude = 111.31 deg. Local Time = 16.22 Mars hours
Temperature = 187.8 K Pressure = 1.043E+02 N/m**2
Density (Low, Avg., High) = 2.776E-03 2.888E-03 2.999E-03 kg/m**3
Departure, COSPAR NH Mean = -5.9 % -2.1 % 1.7 %
Density perturbation = -0.52 % of mean value
Eastward Wind = -24.7 m/s Northward Wind = 3.6 m/s
--------------------------------------------------------------------------
Time (rel. to T0) = 0.0 sec. ( 0.000 sols) Ls = 98.9 deg.
Height = 28.78 km ( 30.00 km) Scale Hgt H(p) = 8.45 H(rho) = 8.45 km
Latitude = 22.000 degrees West Longitude = 48.000 degrees
Sun Latitude = 25.00 deg. Mars Orbital Radius = 1.640 AU
Sun Longitude = 111.31 deg. Local Time = 16.22 Mars hours
Temperature = 164.5 K Pressure = 3.382E+01 N/m**2
Density (Low, Avg., High) = 1.023E-03 1.067E-03 1.110E-03 kg/m**3
Departure, COSPAR NH Mean = -8.1 % -4.2 % -0.3 %
Density perturbation = -0.77 % of mean value
Eastward Wind = -39.8 m/s Northward Wind = 10.8 m/s
--------------------------------------------------------------------------
Time (rel. to T0) = 0.0 sec. ( 0.000 sols) Ls = 98.9 deg.
Height = 38.78 km ( 40.00 km) Scale Hgt H(p) = 7.09 H(rho) = 7.09 km
Latitude = 22.000 degrees West Longitude = 48.000 degrees
Sun Latitude = 25.00 deg. Mars Orbital Radius = 1.640 AU
Sun Longitude = 111.31 deg. Local Time = 16.22 Mars hours
Temperature = 137.9 K Pressure = 8.738E+00 N/m**2
Density (Low, Avg., High) = 3.134E-04 3.304E-04 3.473E-04 kg/m**3
Departure, COSPAR NH Mean = -19.3 % -14.9 % -10.5 %
Density perturbation = 0.17 % of mean value
Eastward Wind = -61.0 m/s Northward Wind = 8.8 m/s
--------------------------------------------------------------------------
Time (rel. to T0) = 0.0 sec. ( 0.000 sols) Ls = 98.9 deg.
Height = 48.78 km ( 50.00 km) Scale Hgt H(p) = 7.61 H(rho) = 7.61 km
Latitude = 22.000 degrees West Longitude = 48.000 degrees
Sun Latitude = 25.00 deg. Mars Orbital Radius = 1.640 AU
Sun Longitude = 111.31 deg. Local Time = 16.22 Mars hours
Temperature = 148.1 K Pressure = 2.089E+00 N/m**2
Density (Low, Avg., High) = 6.675E-05 7.402E-05 8.129E-05 kg/m**3
Departure, COSPAR NH Mean = -46.7 % -40.8 % -35.0 %
Density perturbation = -0.51 % of mean value
Eastward Wind = -79.9 m/s Northward Wind = -14.1 m/s
--------------------------------------------------------------------------
Time (rel. to T0) = 0.0 sec. ( 0.000 sols) Ls = 98.9 deg.
Height = 58.78 km ( 60.00 km) Scale Hgt H(p) = 8.19 H(rho) = 8.19 km
Latitude = 22.000 degrees West Longitude = 48.000 degrees
Sun Latitude = 25.00 deg. Mars Orbital Radius = 1.640 AU
Sun Longitude = 111.31 deg. Local Time = 16.22 Mars hours
Temperature = 159.4 K Pressure = 5.805E-01 N/m**2
Density (Low, Avg., High) = 1.630E-05 1.921E-05 2.213E-05 kg/m**3
Departure, COSPAR NH Mean = -56.1 % -48.2 % -40.4 %
Density perturbation = -6.63 % of mean value
Eastward Wind = -58.4 m/s Northward Wind = -7.7 m/s
--------------------------------------------------------------------------
Time (rel. to T0) = 0.0 sec. ( 0.000 sols) Ls = 98.9 deg.
Height = 68.78 km ( 70.00 km) Scale Hgt H(p) = 8.18 H(rho) = 8.18 km
Latitude = 22.000 degrees West Longitude = 48.000 degrees
Sun Latitude = 25.00 deg. Mars Orbital Radius = 1.640 AU
Sun Longitude = 111.31 deg. Local Time = 16.22 Mars hours
Temperature = 159.2 K Pressure = 1.558E-01 N/m**2
Density (Low, Avg., High) = 4.740E-06 5.122E-06 5.503E-06 kg/m**3
Departure, COSPAR NH Mean = -53.8 % -50.1 % -46.4 %
Density perturbation = -4.74 % of mean value
Eastward Wind = -46.0 m/s Northward Wind = -10.8 m/s
--------------------------------------------------------------------------
Time (rel. to T0) = 0.0 sec. ( 0.000 sols) Ls = 98.9 deg.
Height = 78.78 km ( 80.00 km) Scale Hgt H(p) = 8.51 H(rho) = 8.44 km
Latitude = 22.000 degrees West Longitude = 48.000 degrees
Sun Latitude = 25.00 deg. Mars Orbital Radius = 1.640 AU
Sun Longitude = 111.31 deg. Local Time = 16.22 Mars hours
Exospheric Temp. = 336.0 K Tbase = 159.6 K Zbase = 128.5 km
Temperature = 157.6 K Pressure = 3.940E-02 N/m**2
Density (Low, Avg., High) = 1.080E-06 1.310E-06 1.540E-06 kg/m**3
Departure, COSPAR NH Mean = -60.0 % -51.4 % -42.9 %
Density perturbation = 25.96 % of mean value
Eastward Wind = -30.5 m/s Northward Wind = 46.7 m/s
--------------------------------------------------------------------------
Time (rel. to T0) = 0.0 sec. ( 0.000 sols) Ls = 98.9 deg.
Height = 88.78 km ( 90.00 km) Scale Hgt H(p) = 8.66 H(rho) = 8.59 km
Latitude = 22.000 degrees West Longitude = 48.000 degrees
Sun Latitude = 25.00 deg. Mars Orbital Radius = 1.640 AU
Sun Longitude = 111.31 deg. Local Time = 16.22 Mars hours
Exospheric Temp. = 336.0 K Tbase = 159.6 K Zbase = 128.5 km
Temperature = 159.5 K Pressure = 1.395E-02 N/m**2
Density (Low, Avg., High) = 4.117E-07 4.574E-07 5.032E-07 kg/m**3
Departure, COSPAR NH Mean = -41.8 % -35.3 % -28.9 %
Density perturbation = 13.75 % of mean value
Eastward Wind = -19.3 m/s Northward Wind = 84.6 m/s
--------------------------------------------------------------------------
In addition to the output shown above, which may be directed to the console or a file, the data files shown in Table 3 are produced, holding the data indicated tabulated against a user specified coordinate. Data are presented in SI units unless otherwise stated.
| Filename | Contents |
| DENSAV | Mean density |
| DENSHI | High value of density |
| DENSLO | Low value of density |
| DENSRM | Percentage density standard deviation |
| DENSRP | Large scale density perturbation |
| DENSWA | Small scale (gravity wave) density perturbation |
| EWWIND | East-West (zonal) wind |
| HGTrho | Density scale height |
| NSWIND | North-South (meridional) wind |
| PRES | Pressure |
| TAVG | Mean ground temperature |
| TEMP | Mean atmospheric temperature |
| TMAX | Maximum ground temperature |
| TMIN | Minimum ground temperature |
| list (user specified filename) | Tabulated output (see below) |
The user specified list file contains tabulated output in a column-wise basis of the following variables: time, height, latitude, longitude, density, temperature, zonal wind, meridional wind, percentage density standard deviation, small-scale (gravity wave) density perturbation and Ls.
Alternatively the user can run the MCDGM interface in batch mode using a simple Unix script. This script could be executed as a background job or at a later time using some batch queueing software.
#
# Script to run the Mars Climate Database MarsGRAM style interface (mcdgm)
#
set workdir = "/YOUR/WORK/DIRECTORY"
set mcddir = "/FULL/PATH/NAME/mcd"
#
cd $workdir
#
cat >! mcdgm.in << eof_mcdgm.in
vl1_ent.list
vl1_ent.out
7
20
1976
10
12
50
00
1
1
1
2
0
0
22.
48.
-1.217483
10.
0.
0.
0.
eof_mcdgm.in
#
$mcddir/mcdgm < mcdgm.in > mcdgm.out
#