[Previous]
[Next]
NAME:
I2CDATE
PURPOSE:
Cette procedure convertit la date en binaire, en chaine de caracteres
CATEGORY:
NRH1 General
CALLING SEQUENCE:
I2CDATE, Idate, Chdate
INPUTS:
IDATE Tableau de 3 valeurs IDATE[0] = Jour
IDATE[1] = Mois
IDATE[2] = An
KEYWORD PARAMETERS:
Non
OUTPUTS:
CHDATE Chaine de caracteres contenant YY-MMM-DDD
CALLS: ***
rh_date100 [1], rh_date100 [2]
CALLED BY:
FUSIONPOS1D, PLOT_HG_MAN
COMMON BLOCKS:
Non
SIDE EFFECTS:
La chaine de caracteres est decodee en fonction de la position des
caracteres dans la chaine, donc le separateur peut etre quelconque
PROCEDURE:
La conversion inverse est faite par C2IDATE
EXAMPLE:
IDATE= [98, 04, 20]
C2IDATE, Idate,Cdate
MODIFICATION HISTORY: (bonmartin@obspm.fr)
[Previous]
[Next]
NAME:
IDX_ENCODE
PURPOSE:
Encodes a series of data records representing an INDEX segment with
the contents of an INDEX structure.
CATEGORY:
OVRO APC UTIL
CALLING SEQUENCE:
result = idx_encode(datin,idx)
INPUTS:
datin a series of DATA records representing an INDEX segment
idx an instance of an INDEX structure, with contents to be
encoded into the DATA records
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
OUTPUTS:
result An indication of the success [1] or failure [0] of the
operation
datin On output, DATIN is filled with the contents of the INDEX structure
COMMENTS:
CALLS: ***
PROGMETER
CALLED BY:
INSERT_REC, PUT_INDEX
SIDE EFFECTS:
RESTRICTIONS:
MODIFICATION HISTORY:
Written 04-Feb-2000 by Dale Gary
30-Jul-2000 DG
Fixed a bug in which the segment code and scan code were exchanged.
08-Feb-2002 DG
Packing srcname bytes failed when IDX source had too few characters,
so added blanks to srcname to avoid this.
[Previous]
[Next]
NAME:
Image Spline Interpolation
PURPOSE:
Assuming the image is composed of irregular measurements
in the X or Y axis, this procedure recomputes the
image values at regular steps, using the spline interpolation
technique.
CALLING SEQUENCE:
SplineImage, image, axis, n [ , direction
[ , first, step, nbEls ] ]
INPUT PARAMETERS:
image: a 2d real (or int) array
axis: the axis to regularize (X or Y)
n: the number of elements in axis
direction: 'X' or 'Y'. If not given, 'Y' is default.
first: the first element of the new (regular) axis.
Default: axis(0)
step: the step between two axis values.
Default: (axis(n-1)-axis(0))/n
nbels: the number of elements of the new axis.
Default: n
OUTPUT PARAMETERS:
image: the redimensioned and computed image
axis: the redimensioned and computed axis
SIDE EFFECT:
Can be very cpu-time consuming. You can run this
procedure with less priority when you start wave with
the "nohup" command or stop the process and run it in the
background with th "bg" command.
CALLS: ***
DISPLAYRESTTIME, REVERSE, SPLINE, SPLINEIMAGE
SEE ALSO:
Created: A.Csillaghy, ETHZ, Jan 93., MODIFICATION HISTORY, Spline
[Previous]
[Next]
NAME:
Image_Info
PURPOSE:
Displays the value range of an image and its
axes, the step between x- and y-values and
the titles stored in the corresponding
system variables. Indicate if the axes are compressed.
CALLING SEQUENCE:
Image_Info [ ,image [ ,xAxis [,yAxis ] ] ]
CATEGORY:
Image Processing
INPUTS:
image: The two-dimensionnal array which contains the
image.
xAxis,yAxis: The axes.
The three parameters are optional
CALLS: ***
GETHMS, GETIMAGESIZES, HMSCONVERT
CALLED BY:
Change_Selection, Display 2D Image, Initialize Selection [2]
Modify Image Pixels, Move_Image, RAG Exponentiation, RAG Log
Radio Astronomy Group View RAG View [1]
Radio Astronomy Group View RAG View [2], Selection delete, put selection
MODIFICATION HISTORY:
Created 4/91, A.Csillaghy, ETHZ, csillag@astro.phys.ethz.ch
Adapted for IDL5/RagView/SSW in March 1998 -- ACs
[Previous]
[Next]
NAME:
imagr
PURPOSE:
imaging of OVSA visib.
does one of [Dirtymap, CLEAN, SELFCAL, MeM, & Fwd_fit]
the latter three requires CLEAN done beforehand, or
you can do CLEAN here and do it later.
CATEGORY:
OVSA APC imaging
CALLING SEQUENCE:
imagr
INPUTS:
(input parameters are set by interaction thru command line inputs.
Then this information is passed to one of imaging programs of choice)
Set parameters
contained in inpfile
input uv file name inp.infile 'uvmar22.sav'
time range inp.timer [d0,h0,m0,s0,d1,h1,m1,s1]
polarization inp.poln 'R'
clean box inp.clbox [0] or [-10,-10,10,10]
frequency range inp.freqr [15,16,17,18]
imsize inp.imsiz 64,128,256,512 only
cellsize inp.cellsiz 0 => determine from data
output uv file name inp.outfile 'img.sav'
etc...
OPTIONAL (KEYWORD) INPUT PARAMETERS:
Input parameters are read from inpfile rather than keywords
ROUTINES CALLED:
clean.pro
selfcal.pro
mem.pro
fwdfit.pro
OUTPUTS:
im structure containing map, xy-scale, and max TB
COMMENTS:
Supposedly functions similar to IMAGR/AIPS but with major differences:
1. imsize can be chosen but cellsize is determined accordingly
within this code.
2. H\"ogbom algorithm rather than BCG's is used for cleaning
3. A truncated gaussian is used for Convol-Grdding fcn.
4. Multifrequencies at OVSA is handled using freqid array
(Linear) Frequency synthesis done as you specify multiple freqids,
which needs not be continuous.
CALLS: ***
CLEAN [1], SXPAR [1], SXPAR [2], SXPAR [3], WRITEFITS [1], WRITEFITS [2], clean [2]
clean [3], clean [4], display_ovsamap, fwdfit [1], fwdfit [2], imagr_vsel [1]
imagr_vsel [2], imagr_whdr, mem [1], mem [2], slfcal [1], slfcal [2]
SIDE EFFECTS: -
RESTRICTIONS:
1. After imagr_vsel is called, sign of u is flipped & used so elsewhere.
2. Works only when there are valid data at all 7 bsl at least 1 time
(done so within imagr_vsel.pro)
MODIFICATION HISTORY:
Written 05-JAN-2001 by JL
01-Mar-2003 DG
Many changes to the general package. Now can set CELLSIZE (if 0,
the cellsize is automatically determined), Clean Gain, Clean Min.
Can do all work in setting clean boxes with the mouse, no need to
switch between mouse and command line. After making a map, now
goes back to the beginning to await changes to make a new map. Now
runs as a procedure rather than using .RUN. Now will name the
output file automatically (specify OUTNAME default). Now also
plots image as a map, with properly placed solar grid lines.
[Previous]
[Next]
NAME:
imagr
PURPOSE:
imaging of OVSA visib.
does one of [Dirtymap, CLEAN, SELFCAL, MeM, & Fwd_fit]
the latter three requires CLEAN done beforehand, or
you can do CLEAN here and do it later.
CATEGORY:
OVSA APC imaging
CALLING SEQUENCE:
imagr
INPUTS:
(input parameters are set by interaction thru command line inputs.
Then this information is passed to one of imaging programs of choice)
Set parameters
contained in inpfile
input uv file name inp.infile 'uvmar22.sav'
time range inp.timer [d0,h0,m0,s0,d1,h1,m1,s1]
polarization inp.poln 'R'
clean box inp.clbox [0] or [-10,-10,10,10]
frequency range inp.freqr [15,16,17,18]
imsize inp.imsiz 64,128,256,512 only
output uv file name inp.outfile 'img.sav'
etc...
OPTIONAL (KEYWORD) INPUT PARAMETERS:
Input parameters are read from inpfile rather than keywords
ROUTINES CALLED:
clean.pro
selfcal.pro
mem.pro
fwdfit.pro
OUTPUTS:
im structure containing map, xy-scale, and max TB
COMMENTS:
Supposedly functions similar to IMAGR/AIPS but with major differences:
1. imsize can be chosen but cellsize is determined accordingly
within this code.
2. H\"ogbom algorithm rather than BCG's is used for cleaning
3. A truncated gaussian is used for Convol-Grdding fcn.
4. Multifrequencies at OVSA is handled using freqid array
(Linear) Frequency synthesis done as you specify multiple freqids,
which needs not be continuous.
SIDE EFFECTS: -
RESTRICTIONS:
1. After imagr_vsel is called, sign of u is flipped & used so elsewhere.
2. Works only when there are valid data at all 7 bsl at least 1 time
(done so within imagr_vsel.pro)
MODIFICATION HISTORY:
Written 05-JAN-2001 by JL
[Previous]
[Next]
NAME:
imagr_batch
PURPOSE:
do batch job for imagr
imagr does things interactively
CALLS: ***
CLEAN [1], FAST_FWDFIT, clean [2], clean [3], clean [4], imagr_vsel [1]
imagr_vsel [2], imagr_wfits, imagr_whdr, mem [1], mem [2], slfcal [1], slfcal [2]
RESTRICTIONS:
1. have to set keyword 'clbox=clbox' in calling clean
MODIFICATION HISTORY:
Written 05-JAN-2001 by JL
[Previous]
[Next]
NAME:
imagr_vsel
PURPOSE:
select visibility data according to user input criterion
CATEGORY:
OVSA APC imaging
CALLING SEQUENCE:
imagr_vsel, inp, uv_ij, vis_ij, vsl
INPUTS:
inp
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
OUTPUTS:
uv_ij, vis_ij, sel
COMMENTS:
To confuse users, wgt is a complex arr in which Real=R, Imagina=L
CALLS: ***
MSEC2STR
CALLED BY:
imagr [1], imagr_batch
SIDE EFFECTS: -
RESTRICTIONS:
wgt is created here if not exist
MODIFICATION HISTORY:
Written 05-JAN-2001 by JL
30-May-2001 DG
Frequencies with bad data will be skipped while still allowing
mapping with other frequencies.
14-Dec-2002 DG
Allow data at frequencies and times even when some baselines
are flagged with NaN. Data with NaN are set to zero, which
will not contribute to the map.
28-Feb-2003 DG
Update start time in INFO structure to actual start time of
data used to make the map.
[Previous]
[Next]
NAME:
imagr_vsel
PURPOSE:
select visibility data according to user input criterion
CATEGORY:
OVSA APC imaging
CALLING SEQUENCE:
imagr_vsel, inp, uv_ij, vis_ij, vsl
INPUTS:
inp
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
OUTPUTS:
uv_ij, vis_ij, sel
COMMENTS:
To confuse users, wgt is a complex arr in which Real=R, Imagina=L
CALLS: ***
IMAGR_VSELO
CALLED BY:
imagr [1], imagr_batch
SIDE EFFECTS: -
RESTRICTIONS:
wgt is created here if not exist
MODIFICATION HISTORY:
Written 05-JAN-2001 by JL
[Previous]
[Next]
NAME:
imagr_wfits.pro
PURPOSE:
create a standard FITS output file which should contain
a 2D radio map and information header.
INPUTS:
data: 2D map generated by imagr.pro
header: string array of information header; each
line should be of 80b, by convention.
To generate a correct header, refer to imagr_whdr.pro.
outfil: name string of the output file
OUTPUTS:
no explicit outputs.
KEYWORDS:
OPTIONAL INPUTS:
OPTIONAL OUTPUTS:
CALLED BY:
imagr_batch
HISTORY:
2001 March 29 first version at NJIT -- QJ.
[Previous]
[Next]
NAME:
imagr_whdr.pro
PURPOSE:
Write HeaDeR. convert item strarr into fits header style
CATEGORY:
OVSA APC imaging
CALLING SEQUENCE:
header=mk_hdr(calinfo,inp,cl,misc)
CALLED BY
imagr [1], imagr_batch
[Previous]
[Next]
NAME:
IND_RS
PURPOSE:
Cette fonction donne la coordonnee d'un pixel en RAYON SOLAIRE,
a partir de l'indice du pixel, l'indice du centre le l'image,
la dimension du rayon solaire en pixels
CATEGORY:
RADIO
CALLING SEQUENCE:
RS=IND_RS(ind, pcentre, rayon)
INPUTS:
IND Indice du pixel
Pcentre Indice du centre de l'image
Rayon Nombre de pixels representant le rayon solaire
OUTPUTS:
RS Coordonnee en rayon solaire
CALLED BY:
CENTER_NRH2, CW_REGION, CW_SCANSOURCE, CW_XTD_NRHF, FLUX_NRH2, MK_RESUME
NRH2_PROJECTION, NRH2_TRISOPH, NRH_COORDPIX, NRH_DISP_GRIMAGE, NRH_IMAGE
NRH_IMAGEREF, NRH_SOURCEASCI, PLOT_MAXPOS, PLOT_SOURCES, READ_CENTER_POINT [1]
READ_CENTER_POINT [2], REGION_EVENT, SUN_IMAGE, UVALUE_REGION
EXAMPLE:
RS = IND_RS(15, 32, 16)
Rs coordonne en rayon solaire du 16ieme pixel d'une image de 64 pixels
dont le centre est sur le 32ieme point, l'image representant 4 rayons
solaires
MODIFICATION HISTORY:
Ecrit par: J Bonmartin le 21/10/97 (bonmartin@obspm.fr)
[Previous]
[Next]
NAME:
Init Selection
PURPOSE:
Initializes the selection list (or resets it)
CALLING SEQUENCE:
InitSel
RESTRICTION:
Works only after running init_data.pro
CALLS:
[Previous]
[Next]
NAME:
INIT
PURPOSE:
Routine to set up definitions for OVSA software.
CATEGORY:
OVRO ANALYSIS
CALLING SEQUENCE:
init
INPUTS:
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
OUTPUTS:
COMMENTS:
CALLED BY:
EIS_CAT [1], EIS_CAT [2]
SIDE EFFECTS:
RESTRICTIONS:
MODIFICATION HISTORY:
Written 15-Aug-2000 by Dale Gary
[Previous]
[Next]
NAME:
INIT_AUTOCAL
PURPOSE:
Routine to set up and launch the procedure AUTOCAL,
which starts the SCHEDULE with the current contents
of !DEFAULTS.WORKDIR+'autocal.scd', creates a new
such schedule for 28 days hence, and starts an "at"
job to run the whole thing again in 28 days.
CATEGORY:
OVRO APC INITIALIZATION
CALLING SEQUENCE:
init_autocal
INPUTS:
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
OUTPUTS:
COMMENTS:
SIDE EFFECTS:
RESTRICTIONS:
MODIFICATION HISTORY:
Written 05-Oct-2000 by Dale Gary
[Previous]
[Next]
NAME:
Init_Data
PURPOSE:
Initialize the plot table and the structures used by mdisp.
CATEGORY:
Data Management
CALLING SEQUENCE:
Init_Data
SIDE EFFECT:
The old plot table is erased.
CALLS: ***
ADJUSTTABLE, GETNAMES, INITSEL, INIT_DEFAULTS, INSERTARR, INSERTPLOT, INSERTSEL
LOADPLOT, LOADSELECTION, N_SELECTED, No_Data, REMOVESEL, SEARCHPLOT, SELECTALL
SELECTFIRST, Selection, error, insert [1], insert [2]
CALLED BY:
Get Names, Init Selection, Initialize Selection [1], Insert Plot
Insert in the Selection, Load Plot, Load Selection, MDisp, Ragview_MDisp_Int
Remove from the Selection, Search Plot, Select All, Selection
MODIFICATION HISTORY:
Created in June 1991 by A.Csillaghy
Inst. of Astronomy, ETH Zurich
Structures modified in November 91 a. Cs
[Previous]
[Next]
NAME:
Init_Display
PURPOSE
Every constant for displaying images on screen is
defined in this procedure. Unless specified, the constants
are defined in device pixels.
Procedure to access the constants ( Put and Get ) are
compiled the first time the procedure "Init Display" is run
CALLING SEQUENCE:
Init_Display
HISTORY
Created: A.Csillaghy, ETHZ, April 91
noMinMax variable in Nov 93, A.Cs
Modified value for initial offset of image parts to 0, 2000/07/24 P. Messmer
CALLS:
CALLED BY
Display 2D Image, Get Breaks, Get Image Sizes, Get Marks Mode, Get Miscellaneous
Get Offsets, Get Window Size, Put Breaks, Put Image Sizes, Put Marks Mode
Put Miscellaneous, Put Offsets, Put Window Size
Radio Astronomy Group View RAG View [1]
Radio Astronomy Group View RAG View [2], Show Image [1], Show Image [2]
Show Image [3]
[Previous]
[Next]
NAME:
INIT_LAUNCHER
PURPOSE:
Routine to set up and launch the OVRO data analysis program,
LAUNCHER.
CATEGORY:
OVRO ANALYSIS
CALLING SEQUENCE:
init
INPUTS:
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
OUTPUTS:
COMMENTS:
SIDE EFFECTS:
RESTRICTIONS:
MODIFICATION HISTORY:
Written 15-Feb-1997 by Dale Gary
18-Apr-2000 DG
Added device,decomp=0 command
01-Aug-2000 DG
Removed device,decomposed=0 since it is redundant under SSW.
Also added OVSA tree to the SSW path.
15-Aug-2000 DG
Removed OVSA path commands again.
[Previous]
[Next]
NAME:
INIT_MALAX
PURPOSE:
Cette procedure initialise le COMMON MALAX utilise par CALCPOS
pour calculer les coordonnees heliographiques d un point
CATEGORY:
NRH General
CALLING SEQUENCE:
INIT_MALAX,date,hmer,dec,sref
INPUTS:
DATE Date en [Jour, Mois, An]
HMER INTARR[3], heure de passage au meridien, utilise uniquement
pour les sources
DEC INTARR[3}, declinaison utilise uniquement pour les sources
SREF = 'SOLEIL' pour les soleil
KEYWORD PARAMETERS:
Non
OUTPUTS:
Non
CALLS: ***
INITIAL_DATE, IN_MALAX, rh_date100 [1], rh_date100 [2]
CALLED BY:
PLOT_HG_MAN, RH_IMCUBE, RH_RONDCUBE
COMMON BLOCKS:
Non
SIDE EFFECTS:
Ce module contient les procedures suivantes
INITIAL_DATE conversion de date
IN_MALAX calcul d'initialisation
RESTRICTIONS:
HMER et DEC doivent etre declares avant l'appel, meme dans le cas
du soleil. Les valeurs contnues dans ces 2 tableaux peuvent cependant
etre quelconques
PROCEDURE:
En sortie le COMMON MALAX est initialise
EXAMPLE:
Please provide a simple example here
MODIFICATION HISTORY:
Ecrit par: A Kerdraon
Adapte par J Bonmartin@obspm.fr
[Previous]
[Next]
NAME:
INIT_MALAX_2D
PURPOSE:
Cette procedure initialise le COMMON MALAX utilise par CALCPOS
pour calculer les coordonnees heliographiques d'un point
CATEGORY:
NRH General
CALLING SEQUENCE:
INIT_MALAX_2D, date, hmer, dec, sref
INPUTS:
DATE Date en [Jour, Mois, An]
HMER INTARR[3], heure de passage au meridien, utilise uniquement
pour les sources
DEC INTARR[3}, declinaison utilise uniquement pour les sources
SREF = 'SOLEIL' pour les soleil
KEYWORD PARAMETERS:
Non
OUTPUTS:
Non
CALLS: ***
INITIAL_DATE, IN_MALAX_2D
CALLED BY:
ELLIPSE_MAILLE
COMMON BLOCKS:
Non
SIDE EFFECTS:
Ce module contient les procedures suivantes
INITIAL_DATE conversion de date
IN_MALAX_2D calcul d'initialisation
RESTRICTIONS:
HMER et DEC doivent etre declares avant l'appel, meme dans le cas
du soleil. Les valeurs contnues dans ces 2 tableaux peuvent cependant
etre quelconques
PROCEDURE:
En sortie le COMMON MALAX est initialise pour usage avec des images
interferometriques 128 * 128, obtenues avec E1, E2, E0, NS45 (dew=50m,
dns=54m).
Ces choix sont figes dans la courte procedure appelante INIT_MALAX_2D
mais ils ne sont pas necessaires a IN_MALAX qui est plus general et
pourrait etre appel'e pour l'ancien 2 * 1D ou les images EW et NS (sans
E0 ni NS45) sont definies sur 64 pts.
EXAMPLE:
Please provide a simple example here
MODIFICATION HISTORY:
Ecrit par: A Kerdraon
Adapte par J Bonmartin@obspm.fr, Claude.Mercier@obspm.fr
01 sept 10 : ie0, ie1 et ie2 (drapeaux d'utilisation des antrenne E0, E1 et
E2, qui permettent de calculer dew, dns, new, nns) sont defi-
nis dans INIT_MALAX_RH_2D de facon a etre coherent avec les
choix faits dans les procedures en aval de RH_DPNEW ->
RH_DPATCHFITS_NRH.
[Previous]
[Next]
NAME:
INIT_NRH_CFILE
PURPOSE:
Initialisation correspondant a une extension d'une CFILE de NRH
CATEGORY:
Fichier CFILE.
CALLING SEQUENCE:
INIT_NRH_CFILE, File, Extend, Str_inf, Str_lim
INPUTS:
FILE Nom du fichier
EXTEND Numero de l'extension
KEYWORD PARAMETERS:
Non
OUTPUTS:
STR_INF Structure de type NRH_STR_INFIC
STR_LIM Structure de type NRH_STR_LIM
CALLS: ***
FXPAR [1], FXPAR [2], HEADFITS [1], HEADFITS [2], HEADFITS [3]
CALLED BY:
CENTER_NRH2, FLUX_NRH2
COMMON BLOCKS:
Non
SIDE EFFECTS:
Describe "side effects" here. There aren't any? Well, just delete
this entry.
PROCEDURE:
La procedure remplit les structures en fonction des informations
contenues dans le HEADER d'extension, sauf les limites de temps qui
sont remplies par OPEN_NRH_CFILE
EXAMPLE:
Please provide a simple example here
MODIFICATION HISTORY:
Ecrit par:J Bonmartin (obspm.fr) le 15/09/98
[Previous]
[Next]
NAME:
INIT_RADIOFLUX
PURPOSE:
Routine to set up and launch the OVRO radioflux routine.
CATEGORY:
OVRO APC CALIBRATION
CALLING SEQUENCE:
init_radioflux
INPUTS:
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
defparms, radioflux
OUTPUTS:
COMMENTS:
SIDE EFFECTS:
RESTRICTIONS:
MODIFICATION HISTORY:
Written 04-Jan-2001 by Dale Gary
12-Jan-2001 DG
There is something absolutely bizarre going on. If I try
to exit IDL after this routine, RADIOFLUX does nothing. If
I do not, but rather close the IDL session manually, RADIOFLUX
works perfectly. When I put up a dialog_message, it appears
twice (!) and after the first one RADIOFLUX has done nothing,
but after the second it has run properly. For now, I will
just have to close the session manually.
[Previous]
[Next]
NAME:
INIT_SCHED
PURPOSE:
Routine to set up and launch the OVRO schedule program,
SCHEDULE, which sends commands to the CPC at scheduled
times to coordinate observing..
CATEGORY:
OVRO APC INITIALIZATION
CALLING SEQUENCE:
init_sched
INPUTS:
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
OUTPUTS:
COMMENTS:
SIDE EFFECTS:
RESTRICTIONS:
MODIFICATION HISTORY:
Written 29-Jan-2000 by Dale Gary
[Previous]
[Next]
NAME:
INIT_SOLAID
PURPOSE:
Routine to set up and launch the OVRO SOLAID program,
which shows real-time interferometry data.
CATEGORY:
OVRO APC INITIALIZATION
CALLING SEQUENCE:
init_solaid
INPUTS:
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
OUTPUTS:
COMMENTS:
SIDE EFFECTS:
RESTRICTIONS:
MODIFICATION HISTORY:
Written 10-Apr-2000 by Dale Gary
[Previous]
[Next]
NAME:
INIT_STR_FIC_NRH2
PURPOSE:
Initialisation de la structure STR_FIC pour les fichiers NRH2
CATEGORY:
Structures
CALLING SEQUENCE:
INIT_STR_FIC_NRH2, Str
INPUTS:
STR structure STR_FIC, definie par STR={STR_FIC}
OUTPUTS:
Les valeurs de STR sont fixees pour definir le filtre correspondant
aux fichiers type NRH2
MODIFICATION HISTORY:
Ecrit par:J Bonmartin le 04/06/98
[Previous]
[Next]
NAME:
INIT_WATCHER
PURPOSE:
Routine to set up and launch the OVRO data watcher program,
WATCHER, which monitors the DAILY.ARC file to take action
on various and sundry conditions.
CATEGORY:
OVRO APC INITIALIZATION
CALLING SEQUENCE:
init_watcher
INPUTS:
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
OUTPUTS:
COMMENTS:
SIDE EFFECTS:
RESTRICTIONS:
MODIFICATION HISTORY:
Written 26-Jul-1997 by Dale Gary
[Previous]
[Next]
NAME:
INITFC_UPDT
PURPOSE:
Routine to set up and launch the OVRO data analysis program,
FCAL_UPDATE. This routine is spawned by ARCHIVE.
CATEGORY:
OVRO ANALYSIS
CALLING SEQUENCE:
initfc_updt
INPUTS:
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
OUTPUTS:
COMMENTS:
SIDE EFFECTS:
RESTRICTIONS:
MODIFICATION HISTORY:
Written 25-Jul-1999 by Dale Gary
[Previous]
[Next]
NAME:
INITFCAL
PURPOSE:
Routine to set up and launch the OVRO data analysis program,
FCALCHEK.
CATEGORY:
OVRO ANALYSIS
CALLING SEQUENCE:
initfcal
INPUTS:
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
OUTPUTS:
COMMENTS:
SIDE EFFECTS:
RESTRICTIONS:
MODIFICATION HISTORY:
Written 15-Mar-1997 by Dale Gary
[Previous]
[Next]
NAME:
INITGCAL
PURPOSE:
Routine to set up and launch the OVRO data analysis program,
GCALCHEK.
CATEGORY:
OVRO ANALYSIS
CALLING SEQUENCE:
initgcal
INPUTS:
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
OUTPUTS:
COMMENTS:
SIDE EFFECTS:
RESTRICTIONS:
MODIFICATION HISTORY:
Written 15-Mar-1997 by Dale Gary
[Previous]
[Next]
NAME:
INITGET_SURVEY
PURPOSE:
Routine to launch the OVSA data analysis program,
get_survey
CATEGORY:
OVSA SCHEDULE
CALLING SEQUENCE:
initGET_survey
INPUTS:
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
defparms, get_survey
OUTPUTS:
COMMENTS:
SIDE EFFECTS:
RESTRICTIONS:
MODIFICATION HISTORY:
Written 18-aug-2000 P. T. Gallagher
19-Aug-2000 DG
Added /do_exit switch instead of EXIT command, to fix
problem of STARTUP file exiting before running.
10-Jul-2003 DG
Made GET_SURVEY to use !defaults structure, so added DEFPARMS
[Previous]
[Next]
NAME: Initialize Selection
PURPOSE: Initializes or resets the selection
CALLING SEQUENCE:
InitSel
CALLS:
[Previous]
[Next]
NAME:
Initialize Selection
PURPOSE:
Compiles the routines for the ragview image selection an
window management system.
Initializes the system with default values.
CALLING SEQUENCE:
Init_Selection
SIDE EFFECT:
A directory for save files is created.
This directory can be specified with $RAGVIEW_DIR.
Default is: $HOME/.ragview
device is defined in environment
varable ENRAD_SAVE. If this varaible is not defined,
the save files ar written in the current directory.; SIDE EFFECT:
If the user has no directory on the scratch device, one will
be created.
CALLS: ***
Change_Selection, GETWNR, General_Menu [1], General_Menu [2], INIT_SELECTION
Image_Info, PUT_SELECTION, REPCHR [1], REPCHR [2], REPCHR [3], Read_Test, SEL_DEL
SHOW_IMAGE, WINDOW_MANAGEMENT
MODIFICATION HISTORY:
Created in Oct 91 by A.Csillaghy, ETHZ, csillag@astro.phys.ethz.ch
Modified for ENRAD_SAVE in Jan 93, A.Cs.
Modified for Ragview / IDL 5 in March 98, ACs
[Previous]
[Next]
NAME:
INITLPNT
PURPOSE:
Routine to set up and launch the OVRO data analysis program,
LIMCHEK.
CATEGORY:
OVRO ANALYSIS
CALLING SEQUENCE:
initlpnt
INPUTS:
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
OUTPUTS:
COMMENTS:
SIDE EFFECTS:
RESTRICTIONS:
MODIFICATION HISTORY:
Written 23-Dec-1998 by Dale Gary
[Previous]
[Next]
NAME:
INITMK_EPH
PURPOSE:
Routine to set up and launch the OVRO data analysis program,
MAKE_EPHEM. Also launches CTRCALCHEK
CATEGORY:
OVRO APC CALIBRATION
CALLING SEQUENCE:
initmk_eph
INPUTS:
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
OUTPUTS:
COMMENTS:
SIDE EFFECTS:
RESTRICTIONS:
MODIFICATION HISTORY:
Written 31-Jan-1999 by Dale Gary
19-Aug-2000 DG
Added /do_exit switch instead of EXIT command, to fix
problem of STARTUP file exiting before running.
19-Feb-2002 DG
Added running of CTRCALCHEK, which is unrelated to
MK_EPH, but it needs to run at about the same time so
if makes sense to put it in here.
[Previous]
[Next]
NAME:
INITPKUP
PURPOSE:
Routine to set up and launch the OVRO data analysis program,
PKUPCHEK.
CATEGORY:
OVRO ANALYSIS
CALLING SEQUENCE:
initpkup
INPUTS:
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
OUTPUTS:
COMMENTS:
SIDE EFFECTS:
RESTRICTIONS:
MODIFICATION HISTORY:
Written 23-Dec-1998 by Dale Gary
[Previous]
[Next]
NAME:
INRANGE
PURPOSE:
Find multiples of given step just inside given range.
CATEGORY:
CALLING SEQUENCE:
inrange,stp, x1, x2, t1, t2, [tics]
INPUTS:
stp = Step size. in.
x1, x2 = Range limits. in.
KEYWORD PARAMETERS:
OUTPUTS:
t1, t2 = Multiples of STP just inside range. out.
tics = optional array of tic values. out.
CALLS: ***
MAKEX [1], MAKEX [2], MAKEX [3], NEAREST [1], NEAREST [2], NEAREST [3], REVERSE
CALLED BY:
TNAXES [1], TNAXES [2], TNAXES [3]
COMMON BLOCKS:
NOTES:
MODIFICATION HISTORY:
R. Sterner. 10 Nov, 1988.
Johns Hopkins University Applied Physics Laboratory.
Copyright (C) 1988, 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:
INRANGE
PURPOSE:
Multiples of given step just inside given range
CATEGORY:
CALLING SEQUENCE:
INRANGE,STP, X1, X2, T1, T2, [TICS]
INPUTS:
STP = Step size. in.
X1, X2 = Range limits. in.
KEYWORD PARAMETERS:
OUTPUTS:
T1, T2 = Multiples of STP just inside range. out.
TICS = optional array of tic values. out.
CALLS: ***
MAKEX [1], MAKEX [2], MAKEX [3], NEAREST [1], NEAREST [2], NEAREST [3], REVERSE
CALLED BY:
TNAXES [1], TNAXES [2], TNAXES [3]
COMMON BLOCKS:
NOTES:
MODIFICATION HISTORY:
R. Sterner. 10 Nov, 1988.
Johns Hopkins University Applied Physics Laboratory.
Copyright (C) 1988, 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: Insert in the Selection
PURPOSE: Adds plots to the selection list
CALLING SEQUENCE:
InsertSel, names
CALLS:
[Previous]
[Next]
NAME:
Insert Plot
PURPOSE:
Inserts a plot in the plot table
CALLING SEQUENCE:
InsertPlot, name, len [, x, y, qual, dx, dy,
color, lineStyle, thick, offset, overallQual,
userSym, title, xTitle, yTitle, subtitle, text,
symsize]
INPUTS:
name: a string array or scalar
len: the number of elements of the plot
x, y, qual, dx, dy: the plot description (see data_display)
color, lineStyle, thick, offset, overallQual,
userSym, title, xTitle, yTitle, subtitle, text,
symsize: the attributes of the plot (see ... )
KEYWORD:
NEW: to set if the plot is not already inserted. Otherwise,
the parameters given are taken as complemental
information to an already existing plot.
RESTRICTION:
works only after running init_data
CALLS: ***
ADJUSTTABLE, GETNAMES, INITSEL, INIT_DEFAULTS, INSERTARR, INSERTPLOT, INSERTSEL
Init_Data, LOADPLOT, LOADSELECTION, N_SELECTED, No_Data, REMOVESEL, SEARCHPLOT
SELECTALL, SELECTFIRST, Selection, error, insert [1], insert [2]
MODIFICATION HISTORY:
Fixed a bug with doublenameslst in Oct 95, ACs
[Previous]
[Next]
NAME:
INSERT_REC
PURPOSE:
Inserts records (generally calibration segments) into a data (.ARC) file
to replace all segments of the same type. If the segment to be inserted
is longer than the segments to be replaced, the output file grows accordingly.
CATEGORY:
OVRO APC FILE
CALLING SEQUENCE:
insert_rec[,orec=orec]
INPUTS:
OPTIONAL (KEYWORD) INPUT PARAMETERS:
orec output record number to insert the record at. Care must
be taken to ensure that this is the correct record.
ROUTINES CALLED:
CREATE_INDEX
OUTPUTS:
COMMENTS:
CALLS: ***
BREAK_FILE [1], BREAK_FILE [2], BREAK_FILE [3], FIND_INDEX, IDX_ENCODE, OKTOWRITE
OPENARC, OVSA_GET_INDEX, PROGMETER, break_file [4]
SIDE EFFECTS:
The input data (.ARC) file is changed, or optionally a new data (.ARC)
file is written.
RESTRICTIONS:
MODIFICATION HISTORY:
Written 12-Apr-2001 by Dale E. Gary
28-Jun-2003 DG
Change filter to *.rec for "record" file name. Add keyword
to select the output record to replace. Make the default
output filename the same as the input filename.
24-Aug-2005 DG
When a new output file is created (because new records are needed),
the INDEX record must be updated, too. Added code to do this.
05-Sep-2005 DG
Fixed slight bug in which changes introduced last week did not work
unless file was updated.
[Previous]
[Next]
NAME:
Insert_Sel
PURPOSE:
Insert plot names called in the selection list.
CATEGORY:
Data Management
CALLING SEQUENCE:
Insert_Sel, names
INPUT:
names: the the plot names an array of strings.
COMMON BLOCK:
SelectionRetrieval where the list of the plots selected
is stored.
[Previous]
[Next]
NAME:
Insert_Shift
PURPOSE:
Insert the value of the shift between plots in the
selection retrieval common
CATEGORY:
Data Management
CALLING SEQUENCE:
Insert_Shift, value
INPUT:
value: the value of the shift between plots
COMMON BLOCK:
SelectionRetrieval, where the plot is stored
[Previous]
[Next]
NAME:
inspec
PURPOSE:
Allows user to look at the data (total power) and then
determine the frequency and time range/interval for imaging
Results are saved into inspec.txt and can be used later as an input
to imagr in batch mode.
CATEGORY:
OVSA APC imaging
Restriction:
use total power from antenna 1 only
in future will include visibility plot (a thing like uvplot)
MODIFICATION HISTORY:
Written 05-JAN-2001 by JL
[Previous]
[Next]
PURPOSE:
This procedure selects frequency range interactively
for image analysis purpose.
INPUT:
data_struct: the standard OVSA data structure
OUTPUT:
frq_range: (2, n) array; first dimension defines the
starting and ending frequency indices or the frequencies,
and second dimension gives the number of frequency channels.
OPTIONAL INPUT:
tim_interval: if not given, using the time range defined
in the data structure; you may use the output from
inspec_t.pro; MUST be in seconds.
frange: if given, the spectral range for display is specified.
OPTIONAL INPUT:
frq_rg: keep the frequency range information in frequencies rather
than the indices.
KEYWORD:
not_index: if set, the returned frq_range gives the starting
and ending frequencies rather than the frequency indices.
CALLS: ***
CONGRID [1], CONGRID [2], CONGRID [3], LEGEND [1], LEGEND [2], LEGEND [3], LOADCT
TIMSTR
HISTORY:
2001 March 27 first version at NJIT. -- JQ
2001 March 28 modified to use Total Power (TP) instead of
dynamical spectra to select frequency. Dynamical spectra
now are only used for summary display. -- JQ
2001 March 30 more options. -- JQ
[Previous]
[Next]
PURPOSE:
Interactively select data intervals for image analysis.
This program calls many other subroutines (all attached in
the same file) to plot time axis. Also calls legend.pro
(in SSW).
INPUTS:
data_struct: the standard data input structure fromm OVSA
OUTPUTS:
tim_interval: the user defined time intervals, (2, n) arrary;
the first dimension defines the starting and ending time, and
the second dimension gives number of intervals. Can be
a string array in the form of "hhmmss" or a float array
in seconds (UT).
OPTIONAL INPUTS:
trange: 2-element array (indices) to specify the time range for display
frange: 2-element array (indices) to specify the spectral range for display
xrange: 2-element array of the time range to plot (in seconds);
yrange: 2-element array of the Y-range to plot;
f_show: the user input frequencies (maximum 5 different frequencies can
be used) for display purpose; by default, the procedure
selects automatically 5 roughly evenly spaced frequencies
over the observed frequency range.
OPTIONAL OUTPUTS:
tim_interval_sec: tim_interval in seconds.
KEYWORDS:
not_string: if set, output tim_interval is a float array in seconds.
KEYWORDS:
CALLS: ***
LEGEND [1], LEGEND [2], LEGEND [3], TIMEAXIS [1], TIMEAXIS [2], TIMEAXIS [3], TIMSTR
HISTORY:
2001 March 26: first version at NJIT -- JQ
2001 March 27: added option for display frequencies -- JQ
2001 March 30: keep the time interval in seconds anyway disregarding
the format of tim_interval -- JQ
[Previous]
[Next]
NAME:
PURPOSE:
plot dynamic spectrum (Total power) and get user-selected
range of time and frequency
CATEGORY:
OVSA APC imaging
CALLS: ***
BOX_CURSOR, CONGRID [1], CONGRID [2], CONGRID [3], LOADCT
MODIFICATION HISTORY:
Written 05-MAR-2001 by JQ
[Previous]
[Next]
NAME:
int2str.pro
PROJECT:
ETHZ Radio Astronomy
CATEGORY:
gen
PURPOSE:
This routine will return a string representation of an interger. This
string has a length 'len'. Empty spaces on the left are filled up with
zeros. Very useful for filenaming.
CALLING SEQUENCE:
res=int2str(nbr,length)
INPUT:
nbr : an integer
len : an integer
OUTPUT:
a string representation of 'nbr', of length 'len'
CALLED BY:
phoenix_filedb_get, phoenix_spg_get, rapp_get_spectrogram
EXAMPLES:
IDL> text=int2str(123,5)
IDL> print,text
00123
IDL> for i=0,N_ELEMENTS(imgarr(0,0,*))-1 DO WRITE_GIF,'Img_'+int2str(i,4)+'.gif',imgarr(*,*,i),r,g,b
HISTORY:
2001/02/24 created. Pascal Saint-Hilaire [shilaire@astro.phys.ethz.ch]
2002/05/03 modified, PSH: returns the least significant portion of the number passed,
if it size is larger than 'len'.
[Previous]
[Next]
NAME:
Integrate_2D
PURPOSE
2D integration of images. x- or y-profiles are averaged.
CALLING SEQUENCE
Integrate_2D, image, [,xAxis, yAxis [, xMin, xMax,
yMin, yMax ] ]
INPUT ARGUMENTS:
image: 2D array
xAxis, yAxis: 1D arrays, axes of the image.
xMin, xMax, yMin, yMax: the limits where the integration
should happen.
OUTPUT ARGUMENTS:
image: the integrated image (2D real array)
xAxis, yAxis: the integrated axes (1D real arrays)
xMin, yMin: 0
xMax, yMax: number of elements minus one
KEYWORDS:
INTX, INTY; The integration steps in x and in y.
If not present, they will be asked interactively.
CALLS: ***
ADAPTAXIS, Read_Test
CALLED BY:
Modify Image Pixels, RAG Exponentiation, RAG Log
PROCEDURE:
The "Rebin" procedure is used to average the profiles.
If the number of profiles in the original image is
not a multiple of the integration steps, the last profiles
are lost.
MODIFICATION HISTORY:
Created in September 1991 by A.Csillaghy
Institute of Astronomy, ETH Zurich
xMin, etc. added in Jan. 93 for partial integration, A.Cs
[Previous]
[Next]
NAME:
Integration
PURPOSE:
Computes the area between a plot and two points given.
The User is responsible for the coherence of the operation.
CATEGORY:
1D
CALLING SEQUENCE:
Integration, x, y [, result ]
INPUTS:
x: The abscissae, must be a vector
y: The function f(x) to integrate (points), must be a vector
OUTPUT
result: the value of the integrated area
KEYWORDS:
/STATIC: If present, the boundary values for the integration
will be asked on the terminal. Otherwise they
will be clicked with the mouse.
/NODISPLAY: If present, the result of the integration is
not shown, only stored in "result".
SIDE EFFECT:
Windows opened if working on X
RESTRICTION:
For vectors with a small number of elements (smaller than
the resolution of the screen window) the limits of the
integral could be not totally vertical, due to the
discretization of the function.
CALLS:
CALLED BY
Display_1D
[Previous]
[Next]
NAME:
Interpolation under and above tresholds
PURPOSE:
Interpols values under given minimum and/or given
maximum:
that is: replaces them with the linear interpolation
of the two nearest values above and/or under the
tresholds, respectively.
CALLING SEQUENCE:
result = TreshInterp( image, min, max [, direction] )
INPUTS:
image: a 2D array
min, max: the treshold values
direction: 'X' or 'Y'
RESULT:
the interpolated 2D image
CALLS: ***
INTERINTRESH, REPLLININT, TRESHINTERP
PROCEDURE:
1. finds out which pixels ar under/above the tresholds
2. use for these ones the function ReplLinInt
MODIFICATION HISTORY:
Created in December, 1991 by A.Csillaghy
Inst. of Astronomy, ETH Zurich
InterInTresh modified for excluding n=1 cases,
June 93, A.Cs.
[Previous]
[Next]
NAME:
INTGCOMP_NRH2
PURPOSE:
Cette procedure integre les images contenues dans un fichier FITS
type NRH2d et cree un nouveau fichier FITS
CATEGORY:
FICHIERS NRH
CALLING SEQUENCE:
INTGCOMP_NRH2, FILE, CADENCE, REPERT=repert, INDICE=indice
INPUTS:
FILE Nom du fichier a integrer
CADENCE Cadence du fichier integre en secondes
KEYWORD PARAMETERS:
REPERT Nom du repertoire d'ecriture
INDICE a entrer dans le nom du fichier, si indice est abscent
la valeur de la cadence sur un digit est entree dans le
nom de fichier
STOKESV si present, les donnees stokesI et stokesV sont integrees
sinon seul Stokesi est integre
HDEB heure de debut en hh:mn:ss.cent
HFIN heure de fin en hh:mn:ss.cent
OUTPUTS:
Describe any outputs here
CALLS: ***
BIN_DATE, FORM_DATE, FXADDPAR [1], FXADDPAR [2], FXBCREATE [1], FXBCREATE [2]
FXBFINISH [1], FXBFINISH [2], FXBHMAKE [1], FXBHMAKE [2], FXBWRITE [1]
FXBWRITE [2], FXPAR [1], FXPAR [2], HEADFITS [1], HEADFITS [2], HEADFITS [3], HMS
MODFITS, MOD_NRHFILE, MRDFITS [1], MRDFITS [2], MSH, STR_SEP, SXADDPAR [1]
SXADDPAR [2], SXADDPAR [3], SXDELPAR [1], SXDELPAR [2], SXDELPAR [3]
WRITEFITS [1], WRITEFITS [2]
CALLED BY:
NRH_INTGCOMP
COMMON BLOCKS:
PROCEDURE:
You can describe the foobar superfloatation method being used here.
You might not need this section for your routine.
EXAMPLE:
INTGCOMP_NRH2, Str_fic.file, 2.5, INDICE=2, HDEB='11:30:00'
MODIFICATION HISTORY:
Ecrit par: J Bonmartin le 16/03/98 (bonmartin@obspm.fr)
Revision de la logique de temps le 04/07/01 (JB)
[Previous]
[Next]
NAME:
Is Digit
PURPOSE:
Tests if a string is the ASCII representation of a number
or not
CALLING SEQUENCE:
result = IsDigit( string )
INPUT PARAMETER:
string: the string to test.
RESULT OF FUNCTION:
1 if the test is ok, 0 else.
CALLS: ***
ISDIGIT
RESTRICTIONS:
Some cases are not well handled. For example, 3-4 or E45
are considered as string. In fact, the procedure tests only if
the string is composed with 0,1,2,...9, '.', '-', 'e' or 'E'
characters.
MODIFICATION HISTORY:
Created in May 91 by A.Csillaghy, ETHZ
[Previous]
[Next]
NAME:
IS_RD_ONLY
PURPOSE:
Checks to see if a named file is READONLY. NB: Use this
routine only on files that you intend to modify--see SIDE
EFFECTS below.
CATEGORY:
OVRO APC SUPPORT
CALLING SEQUENCE:
flag = is_rd_only(filename)
INPUTS:
filename The name of the file to check for readonly status
OPTIONAL (KEYWORD) INPUT PARAMETERS:
ROUTINES CALLED:
get_segments, findsegentries, decode, tl_decode, progmeter
OUTPUTS:
flag The readonly status, 1 if readonly (or any other
file I/O error), 0 if otherwise
COMMENTS:
A file marked readonly on a hard disk will give an error on
the OPENU attempt, but for some reason a readonly file on a
CD_ROM does not give such an error. Therefore, the first byte
of the file is read and written back to the file, which will
cause an error if READONLY. If not READONLY, the contents
of the file are not changed, obviously, but an undesirable
side effect is that the modification time stamp will be changed.
CALLED BY:
CREATE_INDEX
SIDE EFFECTS:
If the file is not readonly, the modification time stamp will
be changed. Therefore, this routine should be used only for
files you intend to modify, to check whether they can, in fact,
be modified.
RESTRICTIONS:
MODIFICATION HISTORY:
Written 07-Jun-2000 by Dale E. Gary
07-Aug-2000 DG
Added test to see if LUN is set, which it will not be if
file open failed.