This page was created by the IDL library routine
mk_html_help2.
Last modified: Wed May 14 01:32:10 2008.
procedure: cotrans, name_in, name_out [, time]
Purpose: geophysical coordinate transformations
GEI<-->GSE;
GSE<-->GSM;
interpolates the spinphase, right ascension, declination
updates coord_sys atribute of output tplot variable.
inputs
name_in ... data in the input coordinate system (t-plot variable name,
or array)
name_out ... variable name for output (t-plot variable name,
or array)
time ... optional input: array of times for input values, if provided
then the first parameter is an array, and the second
parameter is a named variable to contain the output array.
keywords:
TRANSFORMATIONS
/GEI2GSE
/GSE2GEI
/GSE2GSM
/GSM2GSE
Examples:
cotrans('tha_fgl_gse','tha_fgl_gsm',/GSE2GSM)
cotrans('tha_fgl_gsm','tha_fgl_gse',/GSM2GSE)
cotrans('tha_fgl_gse','tha_fgl_gei',/GSE2GEI)
cotrans('tha_fgl_gei','tha_fgl_gse',/GEI2GSE)
Notes: under construction!!
Written by: Hannes Schwarzl
$LastChangedBy: kenb-mac $
$LastChangedDate: 2007-07-16 19:16:48 -0700 (Mon, 16 Jul 2007) $
$LastChangedRevision: 1125 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/ssl_general/branches/tdas_2_00/cotrans/cotrans.pro $
(See ssl_general/cotrans/cotrans.pro)
urpose:
Interpolate spin phase to have same time resolution as time_dat
Keyword:
probe: string indicating probe. Array of strings, or a string
like 'a b'. Not used if positional parameters are present.
suffix: suffix to add to default tplot name in which to store sunpulse
data: thx_state_sunpulse (x = probe letter designation)
This suffix is expected on the names of the state data inputs.
Optional Inputs/Output parameters:
(if not present, then standard state tplot variable names will be used for i/o)
Input Parameters:
time_state: double precision array: times of data from state file
spinpha: spin phase from state file
spinper: spin period from state file
Output Parameters:
sunpulse: sunpulse times (times of zero spin phase)
sunp_spinper: spin period at time of each sunpulse.
Keywords:
sunpulse_name: string. If present, store sunpulse/spinperiod in tplot
variable with this name. Has no effect if probe keyword
is provided.
(See ssl_general/cotrans/cotrans_get_coord.pro)
procedure: tgsmgse_vect
Purpose: GSM to GSE transformation
(vectorized version of tgsmgse from ROCOTLIB by
Patrick Robert)
Notes: under construction!!
$LastChangedBy: hannes $
$LastChangedDate: 2007-05-28 10:22:27 -0700 (Mon, 28 May 2007) $
$LastChangedRevision: 705 $
$URL $
(See ssl_general/cotrans/cotrans_lib.pro)
procedure: cdipdir_vect Purpose: calls cdipdir from ROCOTLIB in a vectorized environment Notes: under construction!! $LastChangedBy: hannes $ $LastChangedDate: 2007-05-28 10:22:27 -0700 (Mon, 28 May 2007) $ $LastChangedRevision: 705 $ faster algorithm (for loop across all points avoided) Hannes 05/25/2007 $URL $
(See ssl_general/cotrans/cotrans_lib.pro)
procedure: cdipdir Purpose: cdipdir from ROCOTLIB. direction of Earth's magnetic axis in GEO Notes: under construction!! $LastChangedBy: hannes $ $LastChangedDate: 2007-05-28 10:22:27 -0700 (Mon, 28 May 2007) $ $LastChangedRevision: 705 $ $URL $
(See ssl_general/cotrans/cotrans_lib.pro)
for i/o)
Input Parameters:
time_state: double precision array: times of data from state file
spinpha: spin phase from state file
spinper: spin period from state file
Output Parameters:
sunpulse: sunpulse times (times of zero spin phase)
sunp_spinper: spin period at time of each sunpulse.
Keywords:
sunpulse_name: string. If present, store sunpulse/spinperiod in tplot
variable with this name. Has no effect if probe keyword
is provided.
Notes:
Written by K. Bromund, SPSystems/NASA/GSFC, May 2007
$LastChangedBy: kenb-mac $
$LastChangedDate: 2007-05-29 15:08:39 -0700 (Tue, 29 May 2007) $
$LastChangedRevision: 712 $
(See ssl_general/cotrans/cotrans_lib.pro)
tems/NASA/GSFC, May 2007
$LastChangedBy: kenb-mac $
$LastChangedDate: 2007-05-29 15:08:39 -0700 (Tue, 29 May 2007) $
$LastChangedRevision: 712 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/thmsoc/trunk/idl/themis/state/thm_sunpulse.pro $
NAME: thm_asi_Imager_Readfile
PURPOSE: This is intended to be a general tool for reading THEMIS-GBO imager data.
At the moment it only deals with PGM files and has only been lightly
tested on full (256x256) and row2 (376x1) frames.
CATEGORY: Themis, Imager, File reading
CALLING SEQUENCE: THM_ASI_IMAGER_READFILE,Filename,Images,[Metadata]
INPUTS: Filename a string or array of strings containing valid image filenames
or wildcard search expressions as used in "findfile".
(See ssl_general/cotrans/cotrans_lib.pro)
ightly
tested on full (256x256) and row2 (376x1) frames.
CATEGORY: Themis, Imager, File reading
CALLING SEQUENCE: THM_ASI_IMAGER_READFILE,Filename,Images,[Metadata]
INPUTS: Filename a string or array of strings containing valid image filenames
or wildcard search expressions as used in "findfile".
KEYWORDS: COUNT returns the number of image frames
ALL_METADATA set to obtain more metadata, much slower (default=0)
DEBUG set to increase verbosity (default=0)
OUTPUTS: Images a WIDTH x HEIGHT x NFRA 2007-05-28 10:22:27 -0700 (Mon, 28 May 2007) $
$LastChangedRevision: 705 $
$URL $
procedure: subGSE2GSM
(See ssl_general/cotrans/cotrans_lib.pro)
".
KEYWORDS: COUNT returns the number of image frames
ALL_METADATA set to obtain more metadata, much slower (default=0)
DEBUG set to increase verbosity (default=0)
OUTPUTS: Images a WIDTH x HEIGHT x NFRA 2007-05-28 10:22:27 -0700 (Mon, 28 May 2007) $
$LastChangedRevision: 705 $
$URL $
procedure: subGSE2GSM
Purpose: transforms data from GSE to GSM
INPUTS: TIMES as time_struct, DATA_in as nx3 array
keywords:
(See ssl_general/cotrans/cotrans_lib.pro)
procedure: subGSE2GSM Purpose: transforms data from GSE to GSM INPUTS: TIMES as time_struct, DATA_in as nx3 array keywords: Example: Notes: under construction!! will run faster in the near future!! $LastChangedBy: hannes $ $LastChangedDate: 2007-05-28 10:22:27 -0700 (Mon, 28 May 2007) $ $LastChangedRevision: 705 $ $URL $
(See ssl_general/cotrans/cotrans_lib.pro)
procedure: subGSM2GSE Purpose: transforms data from GSM to GSE INPUTS: TIMES as time_struct, DATA_in as nx3 array keywords: Example: Notes: under construction!! will run faster in the near future!! $LastChangedBy: hannes $ $LastChangedDate: 2007-05-28 10:22:27 -0700 (Mon, 28 May 2007) $ $LastChangedRevision: 705 $ $URL $
(See ssl_general/cotrans/cotrans_lib.pro)
procedure: csundir_vect
Purpose: calculates the direction of the sun
(vectorized version of csundir from ROCOTLIB by
Patrick Robert)
INPUTS: integer time
output : gst greenwich mean sideral time (radians)
slong longitude along ecliptic (radians)
sra right ascension (radians)
sdec declination of the sun (radians)
obliq inclination of Earth's axis (radians)
Notes: under construction!!
$LastChangedBy: hannes $
$LastChangedDate: 2007-05-28 10:22:27 -0700 (Mon, 28 May 2007) $
$LastChangedRevision: 705 $
$URL $
(See ssl_general/cotrans/cotrans_lib.pro)
procedure: tgeigse_vect
Purpose: GEI to GSE transformation
(vectorized version of tgeigse from ROCOTLIB by
Patrick Robert)
Notes: under construction!!
$LastChangedBy: hannes $
$LastChangedDate: 2007-05-28 10:22:27 -0700 (Mon, 28 May 2007) $
$LastChangedRevision: 705 $
$URL $
(See ssl_general/cotrans/cotrans_lib.pro)
procedure: tgsegei_vect
Purpose: GSE to GEI transformation
(vectorized version of tgsegei from ROCOTLIB by
Patrick Robert)
Notes: under construction!!
$LastChangedBy: hannes $
$LastChangedDate: 2007-05-28 10:22:27 -0700 (Mon, 28 May 2007) $
$LastChangedRevision: 705 $
$URL $
(See ssl_general/cotrans/cotrans_lib.pro)
procedure: tgsegsm_vect
Purpose: GSE to GSM transformation
(vectorized version of tgsegsm from ROCOTLIB by
Patrick Robert)
Notes: under construction!!
$LastChangedBy: hannes $
$LastChangedDate: 2007-05-28 10:22:27 -0700 (Mon, 28 May 2007) $
$LastChangedRevision: 705 $
$URL $
(See ssl_general/cotrans/cotrans_lib.pro)
Function: COTRANS_SET_COORD
Purpose: set the coordinate system of data by
setting the data_att structure of its DLIMIT structure.
Calling Sequence:
tplot_var = 'tha_eff'
get_data, tplot_var, data=d, limit=l, dlimit=dl
coord = cotrans_set_coord, dl, 'gei'
store_data, tplot_var, data=d, limit=l, dlimit=dl
Arguements:
DL, Anonymous STRUCT.
Notes:
None.
$LastChangedBy: mattd $
$LastChangedDate: 2007-07-13 11:21:57 -0700 (Fri, 13 Jul 2007) $
$LastChangedRevision: 1089 $
$URL $
(See ssl_general/cotrans/cotrans_set_coord.pro)
procedure: dsl2gse
Purpose: THEMIS coordinate transformations
DSL<-->GSE;
interpolates, right ascension, declination
updates coord_sys atribute of output tplot variable.
inputs
name_thx_xxx_in ... data in the input coordinate system (t-plot variable name)
name_thx_spinras ... right ascension (t-plot variable name)
name_thx_spindec ... declination (t-plot variable name)
name_thx_xxx_out ... name for output (t-plot variable name)
keywords:
TRANSFORMATIONS
/GSE2DSL inverse transformation
Example:
dsl2gse('tha_fgl_dsl','tha_spinras','tha_spindec','tha_fglc_gse')
expects attitude in GEI (tha_spinras,tha_spindec)
dsl2gse('tha_fglc_gse','tha_spinras','tha_spindec','tha_fgl_dsl',/GSE2DSL)
expects attitude in GEI (tha_spinras,tha_spindec)
Notes: under construction!! will run faster in the near future!!
Written by Hannes Schwarzl
$LastChangedBy: kenb-mac $
$LastChangedDate: 2007-07-16 19:16:48 -0700 (Mon, 16 Jul 2007) $
$LastChangedRevision: 1125 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/ssl_general/branches/tdas_2_00/cotrans/dsl2gse.pro $
(See ssl_general/cotrans/dsl2gse.pro)
procedure: spg2ssl
Purpose: coordinate transformation
SPG<-->SSL;
inputs
name_thx_xxx_in ... data in the input coordinate system (t-plot variable name)
name_thx_xxx_out ... name for output (t-plot variable name)
keywords:
TRANSFORMATIONS
/SSL2SPG inverse transformation
Example:
spg2ssl,'tha_fgl_spg','tha_fgl_ssl'
ssl2spg,'tha_fgl_ssl','tha_fgl_spg',/SSL2SPG
Notes: under construction!!
Written by Hannes Schwarzl
$LastChangedBy: kenb-mac $
$LastChangedDate: 2007-05-05 10:29:05Z $
$LastChangedRevision: 645 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/ssl_general/trunk/cotrans/ssl2dsl.pro $
(See ssl_general/cotrans/spg2ssl.pro)
procedure: ssl2dsl
Purpose: despins (spins) THEMIS data
SSL<-->DSL;
interpolates the spinphase, spin period
updates coord_sys atribute of output tplot variable.
inputs
name_thx_xxx_in ... data in the input coordinate system (t-plot variable name)
name_thx_spinper ... spin period (t-plot variable name)
name_thx_spinphase ... spin phase (t-plot variable name)
name_thx_xxx_out ... name for output (t-plot variable name)
keywords:
TRANSFORMATIONS
/DSL2SSL inverse transformation
Example:
ssl2dsl('tha_fgl_ssl','tha_spinper','tha_spinphase','tha_fgl_dsl')
ssl2dsl('tha_fgl_dsl','tha_spinper','tha_spinphase','tha_fgl_ssl',/DSL2SSL)
Notes: under construction!!
Written by Hannes Schwarzl
$LastChangedBy: kenb-mac $
$LastChangedDate: 2007-07-16 19:16:48 -0700 (Mon, 16 Jul 2007) $
$LastChangedRevision: 1125 $
$URL: svn+ssh://thmsvn@ambrosia.ssl.berkeley.edu/repos/ssl_general/branches/tdas_2_00/cotrans/ssl2dsl.pro $
(See ssl_general/cotrans/ssl2dsl.pro)