------ DD EXECUTABLES ------

Preface

Most of executables are written in "C", but some of them are written in IDL and you need IDL 4.6 or later installed at your computer. 1. Common executables
1.1 DD_login

To get permission to access data provided by DD_Server you have to invoke DD_login at first time. Usage of DD_login is obvious. It asks your login name and your password.

1.2 DD_password

DD_password changes a password of the regular user. The usage is obvious as well.

1.3 DDday

DD system uses particular Day-of-Year value to specify time interval of requested data. Day-of-Year is equal to 0 at January 1st. To learn the Day of Year invoke DDday as follows:

usage: DDday YYYY MM DD
             YYYY - year (1996 for example)
             MM - month (1 - 12)
             DD - date  (1 - 31)

2. Level 4 executables

To learn programs which allow to plot DD graphical "objects" see DD_Request and DD_Graph .

3. ATTITUDES executables

3.1 GetGSE

Spacecraft attitude is returned by GetGSE program:

GetGSE YYYYDDDHHMMSSMLS
Example:

 
GetGSE 1995266000000000

returns

 
    Xgse   Ygse    Zgse   Ygsm   Zgsm 
Xsc 0.995  -0.100  0.012  -0.098  0.026 
Ysc -0.076  -0.662  0.745  -0.548  0.833 
Zsc -0.067  -0.742  -0.667  -0.831  -0.552 
Spin period = 117.9

4. ORBITAL data

No executables yet.

5. Ion spectrometer CORALL executables
See HERE brief CORALL technical description. 5.1 CorCheck

This program allows to verify CORALL data spectrum by spectrum.

usage: CorCheck Time [EffFlag]
Time in format YYYYDDDHHMMSSMLS, here DDD id Day-of-Year in DD meaning;
EffFlag:
0 - Raw Data
1 - G correction
2 - G and deadtime correction

The program provides a simple interractive interface:

<space><return> - next spectrum
b<return>         - previous Spectrum
q<return>         - quit

The output format is as follows:

1996045223001901  10 3.680000
     52     70     70     61     61
     26     26     26     17     17
     52     61     61     52     26
     17     17     26     26     26
     17     17     17     26     17
     17      9      9      9      9
     17     17      9      9      9
      9     17     17     17      9
     26     26     26     17     17
     43     43     43     17     17
     43     43     35     17      9
     26     26     26     26     26
     70     70     52     35     17
    174    174    130     78     35
    278    261    209     70     43
    383    417    313    157     70
    696    696    557    313    209
    696    696    557    348    157
    835    835    696    487    278
    765    765    626    452    226
....................................

Time is in YYYYDDDHHMMSSMLS format. The next value is the azimuthal sector number (0 - 31), the next value is one azimuthal sector duration in seconds. The first line is folloved by 32 lines of channels (1 - 5) count rates, 1/sec. Each frame consists 32 lines for 32 decreasing energies.

5.2 crltext

This is a script invoking IDL code. Usage:

crltext YYYYDDDHHMM[SS] DHHMM[SS]
The first argument is start time and the second one is the time interval duration. Note that DDD meand Day-of-Uear in DD meaning. The program provides callibrated CORALL data. The output is stdout looking as follows:

Time YYYYDDDHHMMSSMLS
YGSE and Z GSE of chanal #3 of CORALL
   C1       C2       C3       C4       C5, 1/sec, Energy,eV

1996045223003741
YGSE=   0.199  ZGSE =   0.980
      34.      61.      58.      57.      51. 25485.0
      13.      16.      16.       8.       7. 20851.0
      34.      52.      49.      47.      16. 17237.0
       6.       8.      16.      18.      16. 13994.0
       6.       8.       7.      18.       7. 10834.0
       6.       0.       0.       0.       0.  9657.0
       6.       8.       0.       0.       0.  7803.0
       0.       8.       7.       8.       0.  6450.0
      13.      16.      16.       8.       7.  5338.0
      27.      34.      32.       8.       7.  4299.0
      27.      34.      24.       8.       0.  3568.0
      13.      16.      16.      18.      16.  2937.0
      48.      61.      41.      28.       7.  2373.0
     132.     167.     116.      76.      25.  1947.0
     216.     256.     192.      67.      33.  1613.0
     300.     416.     293.     164.      60.  1297.0
     ..................................................

The second line of each frame gives the direction (in GSE) of the channel which rotates in YZ plane.

5.3 crlrawtext

The program provades raw CORALL data. This is a script invoking IDL code. Usage:

crlrawtext YYYYDDDHHMM[SS] DHHMM[SS]
The first argument is start time and the second one is the time interval duration. Note that DDD meand Day-of-Uear in DD meaning. The output is stdout looking as follows:

Time YYYYDDDHHMMSSMLS
   C1       C2       C3       C4       C5, 1/sec, Energy,eV

1996045223001901
      52.      70.      70.      61.      61. 25485.0
      26.      26.      26.      17.      17. 20851.0
      52.      61.      61.      52.      26. 17237.0
      17.      17.      26.      26.      26. 13994.0
      17.      17.      17.      26.      17. 10834.0
      17.       9.       9.       9.       9.  9657.0
      17.      17.       9.       9.       9.  7803.0
       9.      17.      17.      17.       9.  6450.0
      26.      26.      26.      17.      17.  5338.0
      43.      43.      43.      17.      17.  4299.0
      43.      43.      35.      17.       9.  3568.0
      26.      26.      26.      26.      26.  2937.0
      70.      70.      52.      35.      17.  2373.0
     174.     174.     130.      78.      35.  1947.0
     278.     261.     209.      70.      43.  1613.0
     383.     417.     313.     157.      70.  1297.0
     696.     696.     557.     313.     209.   918.0
     ................................................

5.4 crlptext

Program prints precalculated (kept in database) plasma parameters. This is a script invoking IDL code. Usage:

crlptext YYYYDDDHHMM[SS] DHHMM[SS]
The first argument is start time and the second one is the time interval duration. Note that DDD meand Day-of-Uear in DD meaning. The output is stdout looking as follows:

-------------------------------------------------------------
Time YYYYDDDHHMMSSMLS, T[eV], N[1/cm^3], Vx[km/s], VyGSE, VzGSE, VyGSM, VzGSM
  1996045224719430    179.5     4.8  -173.5   172.4     1.5   147.6    89.0
  1996045224918430    148.1     3.6  -185.2   180.6    35.3   137.5   122.4
  1996045225117430    348.7     4.9   -71.4    85.2    56.5    44.5    92.0
  1996045225316430    391.0     2.8   -96.8   135.8     5.5   114.1    73.9
  1996045225515430    245.4     2.3  -178.6    76.7  -118.1   126.2   -62.6
  1996045225714430    188.0     8.1  -132.2   133.8   -92.1   162.0   -11.1
  1996045225913430    262.8     3.9  -160.3   161.7  -126.0   203.3   -26.2
  1996045230112430    453.8     3.1  -189.8   174.6   -54.4   178.0    42.1
  1996045230311430    494.3     1.2   -59.5   125.9     4.4   106.1    67.9
  1996045230510430   3490.0     0.4    40.4    18.3    55.0   -12.3    56.7
  1996045230709430   3252.1     0.6    17.8   -53.3     9.7   -50.8   -18.8
  1996045230908430   3067.7     0.5     6.6    20.8   -39.6    38.0   -23.6
  1996045231107430   3880.0     0.3    18.4     0.9    36.0   -17.5    31.5
  1996045231306430   4481.0     0.4     1.7     6.7    34.5   -11.8    33.1

5.5 crlparam, crlparamF

Programs calculate and print plasma parameters. If you need short time interval of parameters, it is better to invoke these programs to be sure that the very last CORALL calibrations are used. crlparam provides data for any time interval but in S/C frame (look at Attitude section to learn how to get INTERBALL-TAIL attitudes).
crlparam YYYYDDDHHMMSSMLS TimeInterval [TimeFlag]
TimeInterval is in seconds. If TimeFlag presents, the time is printed in seconds from the start, otherwise is is standard DD string.
Output:

Time of S/C spin pulse T,eV   Vx,km/s   Vy        Vz   N,1/cm^3  
1996045223124101     154.2   -195.0   -143.3     18.7   7.055
1996045223322946     196.6   -201.8   -135.7     26.4   5.364
1996045223521946     175.9   -167.1   -149.8     34.1   4.725
1996045223720946     222.3   -214.8   -145.2     46.6   5.093
1996045223919946     178.1   -191.4   -107.2    125.8   8.514
1996045224118946     188.0   -220.1   -144.5     67.2   6.507
1996045224317946     190.9   -190.4   -117.6     59.2   4.620
1996045224516946     167.5   -158.3    -35.4    146.7   7.566
1996045224715946     189.7   -191.3   -104.6     83.8   5.563
1996045224914946     160.5   -197.3   -111.8     77.9   5.703

To obtain parameters in GSE, GSM or SM frames you can use

crlparamF YYYYDDDHHMMSS Frame (sc,gse,gsm,sm)
The program prints parameters calculated exactly in Requested Time -> +Spin Preiod time interval.
Output:

Time of start     Vx,km/s   Vy       Vz     T,eV N,1/cm^3  Attitudes Flag
1996045223124101  -175.5   162.5    -7.3   142.7  7.8561     1

If the "flag" is greater than 0 the parameters are meaningfull.

6. MAGNETOMETERS executables

6.1 fm3text, miftext

Programs return the values of magnetic field components from FM3 or MIF magnetometers.

fm3text YYYYDDDHHMMSS DHHMMSS frame miftext YYYYDDDHHMMSS DHHMMSS frame
Here YYYYDDDHHMMSS is the start time , DHHMMSS - time interval and frame - the frame of reference=[sc,gse,gsm,sm].

Example:

 
miftext 1996045223000 0000100 gsm

Returns

     Time          Bx GSM    By GSM    Bz GSM  Attitudes flag (1 = valid)
1996045213035748 -11.129146 16.119530 -7.698571 1
1996045213036748 -9.424826 16.503595 -8.430900 1
1996045213037748 -9.244083 16.469276 -8.803443 1
1996045213038748 -10.580726 16.038513 -8.721232 1
1996045213039748 -9.548638 16.764559 -9.385610 1
1996045213040748 -7.899895 17.052519 -8.987675 1
1996045213041748 -7.817206 15.802370 -9.355416 1
1996045213042748 -7.674609 14.049442 -9.720647 1
1996045213043748 -7.063709 12.328738 -8.712258 1
1996045213044748 -6.961267 14.294221 -7.767108 1
1996045213045748 -8.096720 16.237959 -7.486114 1
1996045213046748 -9.476286 15.464076 -7.730120 1
1996045213047748 -8.628870 15.912480 -7.564674 1
1996045213048748 -5.966376 14.356321 -5.920471 1
1996045213049748 -6.214746 12.087007 -5.158182 1
1996045213050748 -8.765803 12.764218 -7.196951 1
1996045213051748 -8.866714 15.655970 -7.912900 1

6. ELECTRON spectrometer executables
See HERE brief ELECTRON technical description.

No executables yet.

7. VDP Faraday cup executables
See HERE brief VDP technical description.

7.1 VDPtext

Usage: VDPtext StartTime: YYYYDDDHHMM[SSMLS] TimeInt: DHHMM[SSMLS]

Example: VDPtext 19970102000 0000010 returns

Time Cup1 Cup2 Cup3 Cup4 Cup5 Cup6 Mode Phase ........................ 1997010210638294 -0.1660 -0.0620 -0.0620 6.1572 -0.0620 0.0000 3 84 1997010210639223 -0.1660 -0.0620 -0.0620 6.1572 -0.0620 0.0000 3 85 1997010210640154 -0.1660 -0.0620 -0.0620 6.1572 -0.0620 0.0000 3 86 1997010210641082 -0.1660 -0.0620 -0.0537 6.1572 -0.0620 0.0000 3 87 1997010210642013 -0.1660 -0.0620 -0.0537 6.1572 -0.0620 0.0000 3 88 1997010210642942 -0.1660 -0.0620 -0.0537 6.1572 -0.0620 0.0000 3 89 1997010210643871 -0.1660 -0.0620 -0.0537 6.1572 -0.0620 0.0000 3 90 1997010210644802 -0.1660 -0.0620 -0.0537 6.1572 -0.0620 0.0000 3 91 1997010210645731 -0.1660 -0.0620 -0.0537 6.1572 -0.0620 0.0000 3 92 ........................

8. Special executables
8.1 delay

To get time lag between WIND and INTERBALL (TAIL and AURORAL) or Magnetopause Subsolar Point one can use delay program. Time lag is calculated under the assumption of propagation with solar wind speed.

delay YYYYDDDHHMM Here DDD is Day of Year -1.
Example:

  delay 19960001000

returns

 
Time's delay from WIND to Magnetopause : 1182.698364.  
Time's delay from WIND to Auroral Sat. : 1386.966064.   
Time's delay from WIND to Tail Sat.    : 1602.507324.

8.2 GetVBKP

Program returns the frame needed to plot CORALL's ion distribution function in frame {B,V}. B is put along Z axis of new frame and Y axis lies along velocity of convection.
Program GetVBKP uses 2 minutes averaged magnetic field data, Corall data and attitude data of INTERBALL-TAIL.
Program has interactive input. Firstly you have to input the start time in usual format YYYYDDDHHMMSSMLS exactly as in the distribution function request. Then you should input the kind of frame. "0" means real {B, V} , but "1" means frame of {Byz, Vyz}, where Byz is the projection of B onto YZ of GSE reference frame, and Vyz is projection of V onto YZ of GSE.
The output of the program is:

Spin period of s/c, sec
X, Y and Z components of s/c frame in new {B,V}. frame at the time of closest sunpulse as it is necessary for distribution function objects.

Example
GetVBKP

  Type Time in YYYYDDDHHMMSSMLS format:

1996048030000000

 Type 1 if you would like to use YZ plane or 0 otherwise:

1

output

 
Time of sunpuls is 1996048030055713 
 
Spin period is       118.000 sec 
 
Spacecraft axis in VB frame: 
Xn     -0.993000   -0.0213120     0.112151 
Yn    -0.0890000    -0.474073    -0.876048 
Zn     0.0720000    -0.879952     0.468998

8.3 Tsyganenko96 model magnetic field

Program calculates and draws Tsyganenko96 model magnetic field (GSM) lines projected onto XgsmYgsm,XgsmZgsm and YgsmZgsm planes for given time. Lines are drawn in the following manner: XZ projection - field lines which intersect line parallel to Zgsm and pass through the point (XsatYsat). XY and YZ projections - field lines which intersect line parallel to Ygsm and pass through the point (XsatZsat). Step of field lines drawing (in Re) is defined by user.
User can choose different satellites - Interball-Tail, Interball-Auroral or arbitrary. In case of arbitrary satellite user should define satellite position (in GSM) for given time in resource file.
Also drawn is the Magnetopause location predicted by Shue (1997) model. Actually it is the cross-section of magnetopause by plane containing satellite and parallel to XY, YZ or XZ (GSM) planes.
The location of satellite in the graph is marked by red label.

Program is run by entering T96. It uses resource file T96.res.

An example of T96.res file:

 
1996295221000        
1300.  -40. 
-40. 10. -25. 25. -25. 25.                
0. 22. -22. 22. -22. 22. 2. 
0                                        
T               
-20 5.5 6

Here

1 string - Year, DDday, Hour, Minute, Second - moment of time for magnetic field calculation
2 string - Time delay WIND-Subsolar magnetopause (sec) and Dst value (nT)
3 string - Range for Graphs axes (Re) - Xmin, Xmax, Ymin, Ymax, Zmin, Zmax (GSM)
4 string - Step and Ranges for field lines calculations (Re). Z_start_point, Z_end_point (for XZ projection), Y_start_point, Y_end_point (for YZ projection), Y_start_point, Y_end_point (for XY projection), Step for magnetic field lines calculation is the same for all three graphs.
5 string - Hardcopy parameter: 0 - only screen output, 1 - screen and GIF output, 2 - only PostScript output.
6 string - What satellite: T - Interball-Tail, A - Interball-Auroral, any other letter - arbitrary satellite. If user chooses T or A then coordinates for the given moment for chosen satellite are taken automatically.
7 string - If user has chosen neither Tail nor Auroral Satellite then coordinates in GSM (Re) for the moment of magnetic field calculation should be defined.

If 'hardcopy' parameter (5th string) in T96.res file is nonequal to 0 then the output will be 3 files 'xz.gif'(ps),'yz.gif'(ps),'xy.gif'(ps) in the current working directory.

An output for above T96.res file: