[Previous]
[Next]
NAME:
OBETIME2TAI
PURPOSE:
Convert OBE time in 32 sec counter and fractional 32 second counts
to TAI time
CATEGORY:
Time Utility
CALLING SEQUENCE:
OBETIME2TAI, Msw, Midsw, Lsw, Utc_time
INPUTS:
Msw: Most Significant Word of 32 second counter
Midsw: Least Significant Word of 32 second counter
Lsw: Fractional 32 second counter
OPTIONAL INPUTS:
KEYWORD PARAMETERS:
OUTPUTS:
Utc_time: String containing TAI time e.g. 1999/09/21 21:30:00.000
OPTIONAL OUTPUTS:
CALLS: ***
TAI2UTC
CALLED BY:
READ_BITP_SCE
COMMON BLOCKS:
SIDE EFFECTS:
RESTRICTIONS:
PROCEDURE:
EXAMPLE:
OBETIME2TAI,'0273'X,'d2a5'X,'4000'X,utc_time
utc_time is a string 1999/09/21 21:18:00.000
MODIFICATION HISTORY:
Written by: Dennis Wang, 21 Sep 1999
@(#)obetime2tai.pro 1.1 09/22/99 LASCO IDL LIBRARY
[Previous]
[Next]
Project : SOHO - CDS
Name : OBT2TAI()
Purpose : Converts OBT/LOBT to UTC
Explanation : This procedure takes the 6 byte (local) on-board time
from the spacecraft and converts it into a double precision
number containing the Atomic International Time (TAI) in
seconds from midnight, 1 January 1958.
Use : Result = OBT2TAI( OBT )
Inputs : OBT = The on-board time, as downloaded from the spacecraft.
This should be a byte array with the first dimension
having six elements.
Opt. Inputs : None.
Outputs : The result of the function will be a double precision number
containing the TAI time in seconds. The result is a simple
conversion from the 6 byte satellite format to a double
precision time in seconds--no corrections are made to this
time.
Opt. Outputs: None.
Keywords : ERRMSG = If defined and passed, then any error messages
will be returned to the user in this parameter
rather than being handled by the IDL MESSAGE
utility. If no errors are encountered, then a null
string is returned. In order to use this feature,
the string ERRMSG must be defined first, e.g.,
ERRMSG = ''
RESULT = OBT2TAI( OBT, ERRMSG=ERRMSG )
IF ERRMSG NE '' THEN ...
Calls : ***
DATATYPE [1], DATATYPE [2], DATATYPE [3]
CALLED BY:
CHKSCPCKTIME, EXPSTA, FIX_TIME_JUMP, GET_MISSING_PCKTS, GISPLOT, LOBT2TAI
MAKE_INDEX, MISS_PCKTS, PLOT_SUBHTR, SCAN_SC_HDR, SPLIT_QKL, SUM_HK0_T1, SUM_HK0_T2
SUM_HK0_T3, SUM_IMAGE_HEAD, S_HK0_5vdpu, S_HK0_IBB1M18V, S_HK0_IBB2M18V
S_HK0_IBOARDP28V, S_HK0_ICCP5V, S_HK0_IDD1P18V, S_HK0_IDD2P18V, S_HK0_IDDRSCP15V
S_HK0_IDEFL, S_HK0_IRSCM15, S_HK0_IRSCM15V, S_HK0_MC1M15V, S_HK0_MC1P15V
S_HK0_MC1P5V, S_HK0_MC1POS, S_HK0_MC1STAT, S_HK0_MC2M15V, S_HK0_MC2P15V
S_HK0_MC2POS, S_HK0_MC2STAT, S_HK0_MC3M15V, S_HK0_MC3P15V, S_HK0_MC3POS
S_HK0_MC3STAT, S_HK0_MC4M15V, S_HK0_MC4P15V, S_HK0_MC4POS, S_HK0_MC4STAT
S_HK0_MC5M15V, S_HK0_MC5P15V, S_HK0_MC5POS, S_HK0_MC5STAT, S_HK0_MC6M15V
S_HK0_MC6P15V, S_HK0_MC6POS, S_HK0_MC6STAT, S_HK0_MC8M15V, S_HK0_MC8P15V
S_HK0_MC8POS, S_HK0_MC8STAT, S_HK0_RECTIME, S_HK0_STATUS0, S_HK0_STATUS1
S_HK0_STATUS2, S_HK0_STATUS3, S_HK0_STATUS4, S_HK0_SYSCONFIG, S_HK0_TDCPM5V
S_HK0_TSUMER4, S_HK0_VBB1M18V, S_HK0_VBB2M18V, S_HK0_VBBRSCM15V
S_HK0_VBOARDP28V, S_HK0_VCCP5V, S_HK0_VDD1P18V, S_HK0_VDD2P18V, S_HK0_XEVENT
S_HK0_XPHA, S_HK0_YEVENT, S_HK0_YPHA, S_HK0_detchax, S_HK0_detchay, S_HK0_dethighv
S_HK0_detlvpi, S_HK0_detmcpi, S_HK0_dettimx, S_HK0_dettimy, S_HK0_ecpb
S_HK0_ecpbsr, S_HK0_ecperr, S_HK0_ideta, S_HK0_idetb, S_HK0_idpup5v
S_HK0_iheaterd, S_HK0_iwaxmotor, S_HK0_spub, S_HK0_spubsr, S_HK0_spuerr
S_HK0_tdcm13v, S_HK0_tdcm15v, S_HK0_tdcm5v, S_HK0_tdcp10v, S_HK0_tdcp13v
S_HK0_tdcp5v, S_HK0_tdpucu1, S_HK0_tdpucu2, S_HK0_tdpudcc, S_HK0_tdpuebx
S_HK0_utc, S_HK0_vddrscp15v, TAI_HEAD, UNPACK_ALL_SCIENCE, UNPACK_LZ_SCIENCE
UTC_HEAD, WPLOT_NONOP, WPLOT_SUBHTR [2], WRITE_CALFITS, WRITE_HKBYDATE, getcputime
Common : None.
Restrictions: None.
Side effects: If an error is encountered and the ERRMSG keyword is set,
OBT2TAI returns a double precision value of -1.D0.
Category : Utilities, Time.
Prev. Hist. : None.
Written : William Thompson, GSFC, 12 September 1993.
Modified : Version 1, William Thompson, GSFC, 12 September 1993.
Version 2, Donald G. Luttermoser, GSFC/ARC, 28 December 1994
Added the keyword ERRMSG. Note that there are no
internally called procedures that use the ERRMSG
keyword.
Version 3, Donald G. Luttermoser, GSFC/ARC, 30 January 1995
Made the error handling procedure more robust. Note
that this routine can handle both scalars and vectors
as input.
Version : Version 3, 30 January 1995.
[Previous]
[Next]
NAME:
OCCLTR_CNTR
PURPOSE:
This function returns the center of the occulting disk (for LASCO)
and Sun Centers (for EIT) as a 2 element array of the column and
row numbers. The number starts at 0. The definition in the FITS
header is starting from 1.
CATEGORY:
LASCO_ANALYSIS
CALLING SEQUENCE:
Result = OCCLTR_CNTR (Hdr)
INPUTS:
Hdr: A FITS header for the image that the center is desired.
It can be either a string header or a structure header.
OUTPUTS:
This function returns the occulter center as a two element array
in which the first element is the column center and the second
element is the row center.
CALLS: ***
CNVRT_FILTER, CNVRT_POLAR, DATATYPE [1], DATATYPE [2], DATATYPE [3], FILEPATH
FIND_CLOSEST, FXPAR [1], FXPAR [2], READLIST, READ_OCC_DAT, STR2UTC [1], STR2UTC [2]
STR2UTC [3], STRUCT2FITSHDR, STR_SEP
CALLED BY:
C2_WARP, C3_WARP, FIND_CHORD_CTR, GET_SUN_CENTER [1], SYNSCAN, mk_minim, mk_stdim
mk_stdim_list
plot_thetas im xc yc th HDRhdr INTRVALintrval RANGErange SDIRsdir ROOTroot SAVEsave PIXELSpixels OCCocc RSUNrsun OVERPLOToverplot YTITLEytitle XRANGExrange YRANGEyrange THICKNESSthickness
RESTRICTIONS:
Returns the center for the readout port "C"
PROCEDURE:
occulter_center.dat file is used first but if related data is
not found, then default values that have been determined by
other means and put into a table, here, are used.
MODIFICATION HISTORY:
Written by: R.A. Howard, 14 March 1996
17 Oct 96 RAH, Revised C1 coords
04 Dec 96 RAH, Corrected case statement default value
01 Dec 98 AEE, added code to use occulter_center.dat before
attempting to use the defaults in this file.
Also added defaults for EIT in the case statement.
14 Mar 01 NBR, Use different method to retrieve C3 center using
time-varying points
3 Dec 01 NBR, Change path to Windows and SSW compatible for GSV
12/07/01, @(#)occltr_cntr.pro 1.9 - LASCO NRL IDL LIBRARY
[Previous]
[Next]
NAME:
ocontour
PURPOSE:
To overlay a contour on top of an image
EXPLANATION:
Note that the SOHO-CDS version of OCONTOUR.PRO was displaced by
this version. To get the same functionality of the SOHO-CDS
version, use the CONTOUR command with /OVERPLOT switch.
CALLING SEQUENCE:
ocontour, img
ocontour, data(*,*,5), bin=6
ocontour, img, 100, 100
INPUT:
img - the image to be contoured on top of the
image aleady displayed with "TV"
OPTIONAL INPUT:
x0 - If the origin of the image is not (0,0) then it is
necessary to pass the left corner
y0 - see "x0"
bin - If the image was displayed using REBIN or CONGRID
then the routine needs to know that so that it scales
properly. This is the rebinning factor that was used
to display the first image.
OPTIONAL INPUT:
levels - IDL contour command
max_value- IDL contour command
color - IDL contour command
c_thick - IDL contour command
c_linestyle - IDL contour command
nlevels - IDL contour command
c_labels- IDL contour command
c_color - IDL contour command
c_charsize - IDL contour command
c_annotation - IDL contour command
c_orientation - IDL contour command
c_spacing - IDL contour command
nodata - IDL contour command
tv2 - If set, then the image display is being done with TV2 and
if the output device is PS, then set the position a bit
differently.
CALLS: ***
tbeep [1], tbeep [2], tbeep [3]
CALLED BY:
FAXABLE_SFD, boundary, eitoversxt, go_teem_nn, go_teem_t, lcur_plotr [1]
lcur_plotr [2], makimg0, rest_low8_cube [1], rest_low8_cube [2], rest_low8_ffi
sector_avg, sel_img, xy_lwa
HISTORY:
Written 28-Oct-91 by M.Morrison
12-May-94 (MDM) - Corrected typo on "c_labels" parameter
12-May-94 (MDM) - Added /TV2 option
6-Sep-94 (MDM) - Included a check that the window is the
proper size (large enough to fit the image)
16-Feb-95 (MDM) - Added /NODATA option
9-Mar-95 (MDM) - Fixed a typo on the window size check
(it was using "x0" instead of "y0")
25-May-95 (LWA) - Added /c_orientation and /c_spacing options.
21-Jun-95 (MDM) - Updated header information (SOHO-CDS note)
18-Jul-95 (MDM) - Added /NORMAL to the contour call for /TV2 option
[Previous]
[Next]
OD_BRIGHT
Determine the brightness of the central block in the occulting
disk, and also estimate whether the image has been bias
subtracted and/or exposure corrected.
Usage:
od_bright, bright, bias, expc
Arguments:
bright float output The relative brightness of the
occulting disk block
bias byte output Estimate of whether the bias has been
subtracted (Assumes that if the image
has any part < 3/4 of the bias
[corrected by exposure if needed] then
the bias has been removed).
expc byte output Estimate of whether the image has been
exposure corrected (assumes that if
the maximum of the image multiplied
by the exposure exceeds the saturation
value of 16383 then the image has NOT
been exposure-normalized).
CALLS: ***
OFFSET_BIAS, SXPAR [1], SXPAR [2], SXPAR [3], ghandle
CALLED BY:
las_auto_exp
Restrictions:
It is possible that "on-board summed" images may confuse the
EXPC determination.
History:
Original: 1/10/96; SJT
Try median instead of masked mean: 7/11/96; SJT
[Previous]
[Next]
NAME: OFFSET_BIAS
PURPOSE: Provides the electronic offset introduced for
each readout port
CATEGORY: LASCO Calibration
CALLING SEQUENCE: Offset = OFFSET_BIAS(Telescope,Readport)
INPUTS: Telescope = String indicating telescope
Values are 'C1','C2','C3','EIT'
Readport = String indicating read out port
Values are 'A','B','C','D'
OPTIONAL INPUTS: Date= string giving the date as YYMMDD
KEYWORD PARAMETERS: SUM: If present, computes the proper bias for LEB Summing
OUTPUTS: Integer giving the offset bias in DN
OPTIONAL OUTPUT PARAMETERS:
CALLS: ***
DATATYPE [1], DATATYPE [2], DATATYPE [3], FXADDPAR [1], FXADDPAR [2]
LASCO_FITSHDR2STRUCT, POLY, STR2UTC [1], STR2UTC [2], STR2UTC [3], TRIM, YYMMDD2UTC
CALLED BY:
CALC_DARK_BIAS, COMPUTE_MONEXP_FACTORS, CORRSUBIMAGE, DIFBKGND, EDITFRAME
EXP_CORR, FIX_CONTRO, GET_EXP_FACTOR [1], GET_EXP_FACTOR [2], MAKE_DAILY_IMAGE
MAKE_FITS_HDR, MAKE_IMAGE_EIT img hdr, MKMOVIE
MKMOVIE0 obsolete version of mkmoviepro, MKMOVIEM, MK_DAILY_C1_MED
MK_DAILY_MED, MK_DAILY_MIN, MK_IMG, PLOT_MONEXP_STD, POLARIZ_CALC, REDUCE_STD_SIZE
RTMOVIE, STD_INT_SCALE, WRITE_LAST_IMG [2], WRITE_SUMMARIES [1], XEDITFRAME
getl05hdrparam, las_auto_exp, mk_stdim, mk_stdim_list, od_bright, polariz
COMMON BLOCKS:
SIDE EFFECTS:
RESTRICTIONS:
PROCEDURE: Obtained from flight calibration
MODIFICATION HISTORY:
RA Howard Writen 6 Feb 1996
V1 RAH 02/06/96 Initial Release
V2 RAH 06/02/97 Added function of date to C3
V3 RAH 06/10/97 Added function of date to C1 & C2
V4 RAH 08/21/97 Added correction for leb summing
V5 RAH 06/08/98 Updates to C2 and C3 coefficients for port C
V6 RAH 06/10/98 Updates to C2 and C3 coefficients for port C, QL through 5/98
V7 RAH 09/18/98 Updates to C2 and C3 coefficients for port C, LZ through 6/21/98
V8 NBR 10/21/98 Use lasco_ftshdr2struct, not ftshdr2struct
V9 RAH 08/20/99 Updates to C2 and C3 coefficients for port C
V10 RAH 12/21/99 Updates to C2 and C3 coefficients for port C
V11 RAH 01/21/00 Syntax change from ENDIF to END for IDL 5.3
V12 RAH 07/03/00 Updates to C2 and C3 coefficients for port C
NBR, 08/04/00 - Use SCCS version number; Add HISTORY to header if FITS header
V13 RAH 01/06/01 Updates to C2 and C3 coefficients for port C, split c2 before/after mispoint
V14 RAH 12/13/01 Updates to C2 and C3 coefficients for port C
V15 RAH 07/09/02 Updates to C2 and C3 coefficients for port C
V16 RAH 05/11/05 Updates to C2 and C3 coefficients for port C
[Previous]
[Next]
NAME:
ONE2TWO
PURPOSE:
Convert from 1-d indices to 2-d indices.
CATEGORY:
CALLING SEQUENCE:
one2two, in, arr, ix, iy
INPUTS:
in = 1-d indices (may be a scalar). in
arr = array to use (for size only). in
Alternatively, arr can be [nx, ny]
where nx and ny are the image sizes
in x and y (saves space).
KEYWORD PARAMETERS:
OUTPUTS:
ix, iy = equivalent 2-d indices. out
CALLED BY:
REMOVE_CR
COMMON BLOCKS:
NOTES:
MODIFICATION HISTORY:
R. Sterner, 25 May, 1986.
Johns Hopkins Applied Physics Lab.
R. Sterner, 19 Nov, 1989 --- converted to SUN.
R. Sterner, 9 Jun, 1993 --- Allowed [nx,ny] instead of ARR.
Copyright (C) 1986, Johns Hopkins University/Applied Physics Laboratory
This software may be used, copied, or redistributed as long as it is not
sold and this copyright notice is reproduced on each copy made. This
routine is provided as is without any express or implied warranties
whatsoever. Other limitations apply as described in the file disclaimer.txt.
[Previous]
[Next]
Name: oneline
Purpose: widget front end to fastdoc
CALLS: ***
CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3], DELVARX [1], DELVARX [2]
DELVARX [3], DELVARX [4], XMANAGER, XMENU [1], XMENU [2], concat_dir [4]
delvarx [5], rd_tfile [1], rd_tfile [2]
CALLED BY:
fastdoc [1], fastdoc [2]
History:
10-Jan-1994 (SLF)
[Previous]
[Next]
Name: oneline_event
Purpose: event driver for oneline
CALLS: ***
DELVARX [1], DELVARX [2], DELVARX [3], DELVARX [4], EVENT_NAME, GET_WUVALUE
GET_WVALUE, XMANAGER, delvarx [5], path_sw [1], path_sw [2], rd_tfile [1]
rd_tfile [2], wc_where [1], wc_where [2]
History:
10-Jan-1994 (SLF)
[Previous]
[Next]
PROJECT:
SOHO - SUMER
NAME:
OPCNT()
PURPOSE:
Return Operations Counter
CATEGORY:
EXPLANATION:
SYNTAX:
Result = opcnt()
EXAMPLES:
INPUTS:
header - BYTARR(92) Image Header
OPTIONAL INPUTS:
None.
OUTPUTS:
None.
OPTIONAL OUTPUTS:
None.
KEYWORDS:
None.
COMMON:
None.
RESTRICTIONS:
None.
SIDE EFFECTS:
None.
HISTORY:
Version 1, October 7, 1996, Dietmar Germerott, MAPE Lindau. Written
CONTACT:
Dietmar Germerott, MAPE Lindau (germerott@linax1.mpae.gwdg.de)
[Previous]
[Next]
Project : SOHO - CDS
Name : OPEN_CALFITS
Purpose : Prepares a FITS calibration file for write.
Explanation : Prepares a FITS binary table file for storing CDS calibration
data. Both a primary and binary table extension FITS header
are created, and the structure of the table is defined. The
file is not actually created until the first call to
WRITE_CALFITS. Subsequent calls to WRITE_CALFITS, one for each
exposure, write additional data to the file, and CLOSE_CALFITS
closes the file.
Use : OPEN_CALFITS, FILENAME, DETECTOR, RASTERHDR, CALHDR
Inputs : FILENAME = Name of the file to receive the calibration data.
The default extension is ".fits".
DETECTOR = Either 'NIS' or 'GIS'.
RASTERHDR = A structure variable of the form given by either
VDSRASTERDEF or GISRASTERDEF as defined in the
procedure SCI_ANA.
CALHDR = A special calibration structure containing the
following tags:
GAS_ID
GAS_VOLTAGE
GAS_CURRENT
GAS_PRESSURE
Opt. Inputs : None.
Outputs : None.
Opt. Outputs: None.
Keywords : PATH = Directory to place the output file. If not passed,
the the file is placed in the user's current
directory.
Calls : ***
CLOSE_CALFITS, DEC2BIN, FXADDPAR [1], FXADDPAR [2], FXBADDCOL [1], FXBADDCOL [2]
FXBHMAKE [1], FXBHMAKE [2], FXHMAKE [1], FXHMAKE [2], OPS_DECODE, SLITPOS_DECODE
TRIM, UNSIGN
Common : CALFITS_COMMON contains data common to the routines
OPEN_CALFITS, WRITE_CALFITS, and CLOSE_CALFITS. The definition
of this common block is in the file "calfits.cmn".
Restrictions: This routine does not support writing to multiple FITS binary
tables simultaneously.
Binning is not currently handled correctly.
Side effects: None.
Category : Data_handling, I/O, FITS, CDS, Calibration.
Prev. Hist. : None.
Written : William Thompson, GSFC, 19 November 1993.
Modified : Version 1, William Thompson, GSFC, 19 November 1993.
Version 2, William Thompson, GSFC, 14 December 1993.
Modified according to comments from Martin Carter as to
the meaning and types of the different parameters.
Version 3, William Thompson, GSFC, 16 December 1993.
Incorporated MCU telemetry formats of slit, OPS, and
sun sensor.
Version 4, CDP Do a close_calfits if file already open.
Version 5, CDP, RAL, 10 February 1994.
Changed how exposure count is calculated to reflect
new telmetry format.
Version 6, William Thompson, GSFC, 24 February 1994.
Removed SLITBITS keyword from header, based on
clarification of slit position word in raster header
from Martin Carter. Treatment of slit position word in
exposure headers is unchanged.
Version 7, CDP, RAL 2-Mar-94
To insert the manually entered Horizontal
and Vertical source positions into the
OPSL/OPSR FITS keywords.
Version : Version 7, 2 March 1994.
[Previous]
[Next]
Project : SOHO - CDS/SUMER
Name : OPEN_KAP
Purpose : Opens an KAP file.
Explanation : Opens an ECS Keyword-formatted Activity Plan (KAP) file, and
reads in the header.
Use : OPEN_KAP, UNIT, FILENAME [, HEADER ]
Inputs : FILENAME = The name of the file to open.
Opt. Inputs : None.
Outputs : UNIT = The logical unit that the file is opened with. If
the open fails, then this is returned as -1.
Opt. Outputs: HEADER = String array containing the file header.
Keywords : ERRMSG = If defined and passed, then any error messages will
be returned to the user in this parameter rather
than being handled by the IDL MESSAGE utility. If
no errors are encountered, then a null string is
returned. In order to use this feature, the string
ERRMSG must be defined first, e.g.,
ERRMSG = ''
OPEN_KAP, UNIT, FILENAME, ERRMSG=ERRMSG
IF ERRMSG NE '' THEN ...
Calls : ***
DATATYPE [1], DATATYPE [2], DATATYPE [3], FIND_WITH_DEF [1], FIND_WITH_DEF [2]
FIND_WITH_DEF [3]
CALLED BY:
READ_KAP
Common : None.
Restrictions: None.
Side effects: None.
Category : Planning, science.
Prev. Hist. : None.
Written : William Thompson, GSFC, 16 February 1995
Modified : Version 1, William Thompson, GSFC, 31 March 1995
Version : Version 1, 31 March 1995
[Previous]
[Next]
Project : SOHO - CDS/SUMER
Name : OPEN_MSP_FILE
Purpose : Opens an Microsoft Project file.
Explanation : Opens a text file generated by Microsoft Project.
Use : OPEN_MSP_FILE, UNIT, FILENAME
Inputs : FILENAME = The name of the file to open.
Opt. Inputs : None.
Outputs : UNIT = The logical unit that the file is opened with. If
the open fails, then this is returned as -1.
Opt. Outputs: None.
Keywords : ERRMSG = If defined and passed, then any error messages
will be returned to the user in this parameter
rather than being handled by the IDL MESSAGE
utility. If no errors are encountered, then a
null string is returned. In order to use this
feature, the string ERRMSG must be defined first,
e.g.,
ERRMSG = ''
OPEN_MSP_FILE, UNIT, FILENAME, ERRMSG=ERRMSG
IF ERRMSG NE '' THEN ...
Calls : ***
DATATYPE [1], DATATYPE [2], DATATYPE [3], FIND_WITH_DEF [1], FIND_WITH_DEF [2]
FIND_WITH_DEF [3]
CALLED BY:
READ_MSP_FILE
Common : None.
Restrictions: None.
Side effects: None.
Category : Planning, science.
Prev. Hist. : This procedure is based on OPEN_KAP, version 1.
Written by William Thompson, GSFC, 31 March 1995
Written : Ron Yurow, 17 October 1995
Modified : Version 1, 17 October 1995
Version : Version 1, 17 October 1995
[Previous]
[Next]
Project : SOHO - CDS
Name : OPLOT_SPLAN
Purpose : oplots individual planning items on plan timeline
Explanation : A wrapper around PLOT_ITEM
Use : OPLOT_SPLAN, PLAN,ROW
Inputs : PLAN = input plan structure
Opt. Inputs : None.
Outputs : None.
Opt. Outputs: None.
Keywords : CHARSIZE = character size to use in displaying
COLOR = The color in which the item should be drawn.
SPEC = use specific science objective as label
ROW = row in which to overplot [def = 0]
WINDOW = window index in which to plot
Calls : ***
ANYTIM2UTC [1], ANYTIM2UTC [2], DATATYPE [1], DATATYPE [2], DATATYPE [3], EXIST
GET_PLAN_ITIME, PLOT_ITEM, SMART_WINDOW, TAG_EXIST [1], TAG_EXIST [2], TAI2UTC
UTC2TAI
CALLED BY:
MK_CDS_PLAN, MK_SOHO
Common : None.
Restrictions: PLOT_FRAME must be called first.
Side effects: None.
Category : Planning, Science.
Prev. Hist. : None.
Written : Dominic Zarro, 16 June 1995.
Modification: Liyun Wang, March 1, 1996
Set character size consistantly with PLOT_SPLAN
VERSION : Version 2.0, March 1, 1996
[Previous]
[Next]
Project : SOHO - CDS
Name : OPS_POINT
Purpose : Calculate pointing from OPS data in the telemetry.
Explanation : Calculates the pointing based on the OPS data in the telemetry.
The effects of the slit and scan mirror mechanisms are not
taken into account. Nor are the effects of the pixel selection
on the (VDS) detector.
Use : OPS_POINT, OPSLCOORD, OPSRCOORD, SOLAR_X, SOLAR_Y
Inputs : OPSLCOORD = OPS L coordinate telemetry word, from either the
raster or exposure headers. Can be either a scalar
or an array.
OPSRCOORD = OPS R coordinate telemetry word.
Opt. Inputs : None.
Outputs : SOLAR_X = Pointing in the X direction, in arcsec.
SOLAR_Y = Pointing in the Y direction, in arcsec.
Opt. Outputs: None.
Keywords : DATE_OBS = If passed, then contains the date that should be
used when determining the conversion. When
DATE_OBS is passed, then GET_CDS_PNTCAL is called.
Calls : ***
CP_GET_INDECES, CP_GET_MNEMONIC, DATATYPE [1], DATATYPE [2], DATATYPE [3]
GET_CDS_PNTCAL, OPS_DECODE
CALLED BY:
CDSFOV, CDSLR2XY
Common : None.
Restrictions: The formulas used to calculate the pointing are based on
equations 11 and 12 in "Notes on Pointing Calculation in CDS",
Version 2.0, MKC, 1/3/94. They should be replaced with a more
exact calculation later.
Also, this routine should be upgraded to incorporate
information about the spacecraft pointing and roll.
Side effects: None.
Category : Data handling, telemetry.
Prev. Hist. : None.
Written : William Thompson, GSFC, 29 August 1994
Modified : Version 1, William Thompson, GSFC, 23 June 1995
Version 2, MKC, RAL, 15/8/95
Added calls to CDHS state database to retrieve
pointing parameters.
Noted Lx and Ly parameters were swapped.
Version 3, MKC, RAL, 5/1/96
Modified state database storage of cb2point
values to reflect proper command format so
have to change handling of indices.
Version 4, CDP, RAL, 28-06-96
Use common block to eliminate unnecessary
database access.
Version 5, William Thompson, GSFC, 22 August 1996
Only call OPS_DECODE if short integer values are
passed. Otherwise, take values as they are. This
allows fractional values to be passed.
Version 6, William Thompson, GSFC, 8 May 1997
Add keyword DATE_OBS
Version : Version 6, 8 May 1997
[Previous]
[Next]
NAME:
opsdb
PURPOSE:
Manage the IP queue and DEP memory resources
OPTIONS:
copy - will rcp the files from mdisim
prep - will use the prep directory & database
unfreeze- will pull the online file from the flight directory (instead of "copy" from
mdisim). Uses prep directory too.
HISTORY:
Written Oct to Dec-95 by M.Morrison
5-Dec-95 (MDM) - Implemented ID assignments for campaigns and
observations.
7-Dec-95 (MDM) - Incorporated new capabilities for "obstran" (the routine
which converts from .obs files to .src). Capbilities
were to allow the call to specify the address and slot.
- Multiple changes to .CAM format
8-Dec-95 (MDM) - Changed the SIMP_CAM labels for prime30 label
from OBS_PRIME30 to OBS_STD_STR30
- Modification to GET_ADDR to ignore the heritage load
replacement addresses when finding the next available
slot
- Corrected error to GET_ADDR for OBS and CAM case
11-Dec-95 (MDM) - Added PRIME keyword option on MK_SIMP_CAM
- Added translation capability going from .uobs to obs
to specify the ticks and choose the closes table entry
- Added EXPOSURE.TAB processing capability
- Added REPLACE option onf MK_OBS_SRC and MK_CAM_SRC
12-Dec-95 (MDM) - Modified to allow .ips exensions on the input file
name into mk_ips_src and mk_ipvec_src
- Made the src output file of the .ips files have an extra
_1 for load number after the _v03 if OPSDB_LOAD_VER is
set to "yes"
13-Dec-95 (MDM) - Corrected the /replace option for the MK_OBS_SRC routine
- Made the src output file of the .ips files have an extra
_1 for load number after the _v03 if OPSDB_LOAD_VER is
set to "yes" for OBS and CAM load generation.
- added new style to OPSDB_PRINT to list the campaigns and
observtion IDs
- Corrected error where uobs description was not being
recorded into the database.
- Wrote dummy write routine to save all info as ASCII
for when IDL writting breaks
- Wrote fixup routine to make sure there are no blanks for
the critical text fields.
- Made MK_SIMP_CAM have 1024 as the default number of repeats
- Created LATEST_VER to get the latest file version filename
- Force uobs translation to stop when IP name results in a
vector = 0
17-Jan-96 (MDM) - Patched LATEST_VER to work with unversioned files
- Corrected GET_ID to only look for active observations
when the /INDEX option is used
- Trap when don't recognize the observation in the header
of the campaign list (don't default to anything)
18-Jan-96 (MDM) - Added logic to pass the index foward when using /REPLACE
on processing .ips files.
- Make the LATEST_VER routine stop if the result is a null
file name
- Added the capability to override the IP program by
specifying in the campaign list.
- Added /ID option to GET_INFO
- Patched MK_OBS_SRC to get the ID if not passed a UOBS
(the ID should have already been assigned)
24-Jan-96 (MDM) - Modified to use macl instead of cmd 0x91 for setting vector
address.
- Wrote opsdb_proc_lst to simplify the load making
25-Jan-96 (MDM) - Added neting option to the mk_cam_src routine
- Added DELETE_OBS and DELETE_CAM options in the proc_lst routine
- Added title to the standard listing output
- Added sort options to the listing routine
29-Jan-96 (MDM) - Patched print routine to not do a title for IP_Symbols.dat output option
- Modified mk_ips_src to output macls
- Changed to have .reg be the file extension for the register table (used to be .tab)
- Removed all test subroutines
- Wrote opsdb_mk_reload and opsdb_test_lst
30-Jan-96 (MDM) - Corrected error in mk_reload (wasn't getting the
correct items where multiple items reside as the same
address (ie obs_std_str60)
- Nested loop in campaign, # obs to nest should be N-1
- Made mk_cam_src repeat count passed in be N, not N-1
8-Feb-96 (MDM) - Changed the logic on how the nested loop repeats were
calculated.
- Corrected the nesting loop count (it was off by 1)
11-Feb-96 (MDM) - Correced overall obs count when using nested loop.
(the count is for how many "obs/nests" not how many obs)
12-Feb-96 (MDM) - Made proc_lst have pad=16 as the default for call to mk_ips_src
- Fixed number of observations in NEST to be N-1 in the load
27-Feb-96 (MDM) - Added /RESET option to proc_lst
1-Mar-96 (MDM) - Made the set_ipvec use mbipcmd instead of mbipmacl (reverting back to the old way)
4-Mar-96 (MDM) - Changed format statement for campaign address from i4 to i5
5-Mar-96 (MDM) - Added LOAD_CMD option to proc_lst
5-Mar-96 (MDM) - Modified proc_lst to ask if the certify instruction should be issued
8-Mar-96 (MDM) - Allowed "NREP" option for alt count for campaigns
21-Mar-96 (MDM) - Made the OPSDB_PRINT title display the UT time when it was run
1-Apr-96 (MDM) - Modified MK_SIMP_CAM to take the description of the observation
4-Apr-96 (MDM) - Corrected to write out the IP symobls in upper case
for the 'ipl' (linker) input
4-Apr-96 (MDM) - Made the labels be stored as lower case
19-Apr-96 (MDM) - Added /FORCE option for the freeze (switch to proc_lst)
25-Apr-96 (MDM) - Added new print option for RDB file with cam and obs information
25-Apr-96 (MDM) - Added option to REG_IPS_SRC to allow labels in the definition
30-Apr-96 (MDM) - Changed the pad to be 8 words between modules
20-May-96 (MDM) - Changed MK_RELOAD to make 3 files (IP/DEP/Oth)
3-Jun-96 (MDM) - Added disabling the queue at the top of the "reload_ip" command file
3-Jun-96 (MDM) - Corrected the way that set_ipvec list is generated by mk_reload (did proper time ordering)
4-Jun-96 (MDM) - Corrected cam_reg list generated by mk_reload
5-Jun-96 (MDM) - Merged in the off-line changes to opsdb_print to allow html output
8-Jul-96 (MDM) - Added ROUND to the UOBS2OBS for the time calculation
- Added workaround which made the SOURCE Line of the ips files have the path
10-Jul-96 (MDM) - Fix SOURCE line for CAM and OBS generation
22-Jul-96 (MDM) - Various patches/improvements
- Modified IP reg to .src file to break mbipldin commands to be no longer than
a setreg of 8
25-Jul-96 (MDM) - Patched making of load file for the /prep case
25-Jul-96 (MDM) - Change to do two repeats of the DMA (uobs2obs) instead of one pair plus 2 of the same page
1-Aug-96 (MDM) - Added '-force' to the freeze call
6-Aug-96 (MDM) - Protected mk_ipv_src from unrecognized labels
14-Nov-96 (MDM) - Changed "mdibbs" to "mdisim" for rcp (/copy option)
19-Nov-96 (MDM) - Modified to use CFL_UTIL for EGSE >= 5.2
9-Dec-96 (MDM) - Put 19-Nov-96 mod online
- Added option for printing delta between addresses
7-Jan-97 (MDM) - Moved a "cd" command in proc_lst
8-Jan-97 (MDM) - Removed the "cd" commands that were put into the load file
- Write the opsdb.lst file to the home directory
4-Mar-97 (MDM) - Modified to have "dev2/src" output always go to "dev/src"
11-Mar-97 (MDM) - Added creating load.lst file for all active frames
2-Apr-97 (MDM) - Make IPVEC use FILE_MOVE
- Code 3 with /delta option cleaned up in opsdb_print
- Fixed nested loop load building error
7-Apr-97 (MDM) - Added forcing a database read within opsdb_proc_list
- Patch up "cam_p30c_fd_c1" problem
27-May-97 (MDM) - Removed 'cd c "flight"' from the reload cfl files
27-Oct-97 (MDM) - Slight tweak to opsdb_new_tuning
3-Nov-97 (MDM) - Modified opsdb_cfl_util
10-Dec-97 (MDM) - Changed to look/write to FLIGHT not PREP cfl dir
(because of freeze change)
17-Dec-97 (MDM) - Changed default action of OPSDB_NEW_TUNING output
file-wise
17-Dec-97 (MDM) - Changed creation of load file to be not done in
the final output file location
17-Dec-97 (MDM) - Removed restriction that the mdi_uobs file had to
be tab delimited
4-Jan-98 (MDM) - Added /FREEZE_ONLY option (works on mdisas only)
16-Apr-98 (MDM) - Re-removed "certify" option (did on 17-Dec too)
- Added "unfreeze" option
21-Apr-98 (MDM) - (16-Apr mods were not put online yet)
- Added trapping for freeze errors
23-Apr-98 (MDM) - Get the load file back from the temp area when
running with /prep
26-Jan-2000 (RIB) - Fixed Y2K problem in selection of uobs file
NOTES:
* The repeat number for the campaign list is N+1 (a value of 1
gives you two repeats)
[Previous]
[Next]
METHOD:
environment variable OPSDB_TYPE needs to be defined and the
filename is derived as follows
MDI_OPSDB_TYPE Filename
---------- --------
DEV opsdb_dev
SIM opsdb_sim (needed?)
PREP opsdb_prep
FLIGHT opsdb_flt
common opsdb_blk, dir, filnam, info
case getenv('MDI_OPSDB_TYPE') of
'': begin
print, 'MDI_OPSDB_TYPE is not defined. Stopping.
stop
end
'DEV': filnam0 = 'opsdb_dev'
'SIM': filnam0 = 'opsdb_sim'
'PREP': filnam0 = 'opsdb_prep'
'FLIGHT': filnam0 = 'opsdb_flight'
else: begin
print, 'MDI_OPSDB_TYPE not recognized. Stopping...
stop
end
endcase
dir = getenv('MDI_OPS_IP_DEP')
filnam = concat_dir( dir, filnam0)
filnam2 = filnam + '.genx'
if (keyword_set(init)) then begin
info = opsdb_get_struct()
return
end
if (keyword_set(qwrite)) then begin
if (data_type(info) ne 8) then begin
message, 'Write requested with no data defined', /info
return
end
;
ssw_file_delete, filnam2
savegen, info, file=filnam
end
if (keyword_set(qbackup)) then begin
if (data_type(info) ne 8) then begin
message, 'Write requested with no data defined', /info
return
end
;
fid = ex2fid(anytim2ex(!stime))
filnam2 = concat_dir(dir, filnam0 + fid)
ssw_file_delete, filnam2
savegen, info, file=filnam2
end
if (n_elements(info) eq 0) then qread = 1
if (keyword_set(qread)) then begin
if (not file_exist(filnam2)) then begin
message, 'Input file does not exist: ' + filnam, /info
return
end
;
print, 'Restoring: ' + filnam
restgen, info0, file=filnam
n = n_elements(info0)
info = replicate(opsdb_get_struct(), n)
info = str_copy(info, info0)
end
end
[Previous]
[Next]
NAME:
opsdb_uobs2obs
PURPOSE:
To translate the user's obs frame list to a pre-load format file.
SAMPLE CALLING SEQUENCE:
opsdb_uobs2obs, 'dt5x5_cal.uobs', /sim
ff = findfile('/mdisw/cfl/comm/dep/*.uobs')
for i=0,n_elements(ff)-1 do opsdb_uobs2obs, ff(i), /sim
CALLED BY:
xset_chain [1], xset_chain [2]
HISTORY:
Written 9-Nov-95 by M.Morrison
5-Dec-95 (MDM) - Renamed from MDI_TRANS_UOBS to OPSDB_UOBS2OBS
- Added ID keyword input
[Previous]
[Next]
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
pro popup_help, message [, title=title, group=group]
Creates a message window that informs the user with a message and
requires the user to read the message and to dismiss the window
before control will return to the calling procedure.
calls to : xregistered('pop_help'), xmanager,'popup_help'
CALLS: ***
POPUP_HELP_EVENT, XMANAGER, popup_help [1], popup_help [2]
common : none
INPUT
message: string or string vector containing a message
that will be displayed on the screen for the
user to read.
(multi-line messages are aesthetically better)
title: Optional title of the message window
OUTPUT
none
MODIFICATION HISTORY
JAN 1993 -- Elaine Einfalt (HSTX)
August 19, 1994 -- Liyun Wang (ARC)
August 31, 1994 -- Liyun Wang (ARC), added GROUP keyword
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
[Previous]
[Next]
NAME: OR_SHAPE
PURPOSE:
Return vectors which define region shape for all images in a
given SDA file
INPUT:
rmap - vector of SDA roadmaps from Solar-A reformatted data
OUTPUT:
Xsize - vector of OR x dimensions - 1 per OR
Ysize - vector of OR Y dimensions
Optional Keyword Parameters
Sequence - force size for each sequence
only effects FFI sizing
CALLS:
CALLED BY
make_views
[Previous]
[Next]
NAME:
ORBIT_FILE_TYPE
PURPOSE:
This function returns an identifier, indicating which type of
orbit files exist at the site. If files of more than one type
exist, then a fits file is returned if possible.
CATEGORY:
CALLING SEQUENCE:
Result = ORBIT_FILE_TYPE (Date)
INPUTS:
Date: format 'DD-Mmm-YYYY HH:MM:SS.SSS'
OUTPUTS:
Type: 'CDF' - cdf format orbit files
'FITS' - fits format orbit files
'NULL' - no orbit files found
CALLS: ***
ANYTIM2CAL, CONCAT_DIR [1], CONCAT_DIR [2], CONCAT_DIR [3], concat_dir [4]
CALLED BY:
GET_SOLAR_RADIUS, STARFIELD
PROCEDURE:
Determines whether the available orbit files are definitive or
predictive, whether the available file types are *.CDF or
*.FITS, and whether the prefix is SO_OR_* or YYMMDD*.cdf
MODIFICATION HISTORY:
Written by: D.A. Biesecker, 12 September 1996
Adapted from GET_ORBIT_CDF written by S.P. Plunkett
@(#)orbit_file_type.pro 1.1 10/04/96 LASCO IDL LIBRARY
[Previous]
[Next]
NAME:
OUTPLOT
PURPOSE:
Plot vector data over a previously drawn plot (using UTPLOT) with
universal time labelled X axis. If start and end times have been
set, only data between those times is displayed.
CATEGORY:
CALLING SEQUENCE:
OUTPLOT,X,Y
OUTPLOT,X,Y,'UTSTRING'
INPUTS:
X - X array to plot in seconds relative to base time.
(MDM) Structures allowed
Y - Y array to plot.
xst - Optional. The reference time to use for converting a structure
into a seconds array. IMPORTANT - this should not be
used since it will use the start time that was defined in the
plot command. It is necessary if the X input is an in seconds
already and the reference time is no the same as that used by
the UTPLOT base time.
OPTIONAL INPUT PARAMETERS:
UTSTRING = ASCII string containing base time of data to be be overlaid.
If present, it is used as base time for this data, but UTBASE variable
in common is not changed. If not present, last base time set is used.
OUTPUTS:
None.
OPTIONAL OUTPUT PARAMETERS:
None.
CALLS: ***
Ex2Int [1], Ex2Int [2], FCHECK, anytim2ex [1], anytim2ex [2], int2secarr [1]
int2secarr [2]
CALLED BY:
AR_SPECTRUM, BCS_24HR_PLOT [1], BCS_24HR_PLOT [3], BORN_AGAIN, CHECK_SFC_PNT
COMPUTE_MONEXP_POLY, ECLIPSE_PLOTTER, EPLOT, FLAREMETER, GOES_SAFE, GOES_TEK [1]
HSI_DO_QLOOK_PLOTS, HXT_AUTOIMG, HXT_BACK, HXT_LCURVE, HXT_SUMMER, NEUPERT_PLOT
NIS_BIAS_DEMO, NOV93_ECLIPSE, NOV_ECLIPSE, OBS_PLOT, OPLOT_ERR
OVSA_EXPLORER formerly OVSA_PRESUB, OVSA_PRESUB, PLOT_ALL [3], PLOT_ASC
PLOT_BSC [1], PLOT_BSC [2], PLOT_CDS_CRAYS, PLOT_ERR, PLOT_GCPARM, PLOT_HT
PLOT_SUBHTR, Plot, QUICKDARK [2], QUICKSTRAY [2], QUICK_DPE, ROLL_PLOT
SPARTAN_PLANNER, SPLINE_PLOT, SYNOPTIC_STATS, Sxt_goes_teem, TERM_QUICK
TERM_REVIEW, TERM_REVIEW_GIF, TV_SYNOP, UTERRPLOT [1], UTERRPLOT [2]
UTPLOT__DEFINE, WPLOT_NONOP, WPLOT_SUBHTR [2], W_HISTOGRAM, XPLOT_HT
auto_bck_find, auto_bck_find0, avsig_temp, box_lc_plot, cal_fig_mich, fit_bsc_plot
goes_teem, goes_widget, goesem_eqn [1], goest_eqn [1], gr_summary_plot, grs32_fsp
grsl_fsp, high_mag_lat, hsi_obs_times, hxs_fsp, hxsgrs_fsp, hxt_fsp, hxt_utplot
jitter_gif_xyimg, lcbsd, lcur_plot [1], lcur_plot [2], mwlt_select, oplot_nts
plot_ace, plot_door_open, plot_goes_ospex, plot_goesp, plot_loi_summary [1]
plot_loi_summary [2], plot_ssl, plot_ssw_fov, plot_sxg, plot_sxl [1], plot_sxl [2]
psk_correlate, ref_day_plot, res_freq, tim2tfss
COMMON BLOCKS:
None.
SIDE EFFECTS:
Overlays X vs Y plot on existing plot.
RESTRICTIONS:
Can only be used after issuing UTPLOT command.
PROCEDURE:
If UTSTRING parameter is passed, a temporary X array is created
containing the original X array offset by the new base
time minus the old base time (used in UTPLOT command). OPLOT is
called to plot the temporary X vs Y.
MODIFICATION HISTORY:
Written by Kim Tolbert 4/88
Modified for IDL VERSION 2 by Richard Schwartz, Feb. 1991
21-Mar-92 (MDM) - Adjusted for YOHKOH spacecraft use - allowed
input variable to be a structure
- Added multiple keyword options (old version
only took x and y)
28-Apr-92 (MDM) - "SYMSIZE" was not being implemented
23-Oct-92 (MDM) - IDL Ver 2.4.0 does not accept /DEV, /NORM, or /DATA
for the OPLOT command any more