ULYSSES In Space

 

Sun Banner
ULYSSES

Ulysses HISCALE Data Analysis Handbook

 

Appendix 11. HISCALE IDL Display System (IDL_HS)

 

A11.2 Part Two - Reference (continued)

 

A11.2.2 Procedures (continued)

 

idl/plot_mag

 

ACQUIRE_MAG

 

Reads in the data from the file and stores the appropriate parts of it in the arrays b_field and b_time.

 

ACQUIRE_MAG b_found

 

ACQUIRE_MAG_UAV

 

Reads in the data from the file and stores the appropriate parts of it in the arrays b_field and b_time.

 

ACQUIRE_MAG_UAV b_found

 

AVERAGE_MAG

 

Takes the rates accumulated and averages them over the requested time interval.

 

AVERAGE_MAG

 

B_COMP

 

Choose whether to plot components or directions.

 

B_COMP "COMPONENTS" "DIRECTIONS"

 

B_COORD_MENU

 

PLOT_MAG coordinates choice menu.

 

B_COORD_EVENT event
B_COORD_MENU "GROUP"

 

B_COORDS

 

Select the coordinate system to be used for magnetic field plots.

 

B_COORDS system "EME1950" "HELIOCENTRIC" "RTN" "SPACECRAFT"

 

B_SCALE

 

Select plot scaling options.

 

B_SCALE maxis caxis taxis "FINISH" "INDIVIDUAL" "START" "UNIFORM"

 

B_SCALE_MENU

 

Menu interface for mag field scaling.

 

B_SCALE_EVENT event
B_SCALE_MENU "GROUP"

 

CREATE_MAG_ARR

 

Create the arrays needed to read the field data and store them for plotting.

 

CREATE_MAG_ARR nvals

 

EXTEND_MAG_ARR

 

Extends the data arrays as requested by ACQUIRE_DATA etc. Extension is by 20% of current length.

 

EXTEND_MAG_ARR ndmax

 

MAG_HEADER

 

Plots an overall heading for the mag plots.

 

MAG_HEADER yvalue

MAG_MENU

 

Widget based interface for plot_mag.

MAG_EVENT event
MAG_MENU "GROUP"

 

PLOT_B

 

Control plotting of magnetic field.

 

PLOT_B


PLOT_B_COMP

 

Plot magnetic field components.

 

PLOT_B_COMP

 

PLOT_B_DIRN

 

Plot magnetic field directions.

 

PLOT_B_DIRN

 

PLOT_MAG

 

Plot magnetic field data from Ulysses magnetometer.

 

PLOT_MAG "PROMPT" "REREAD"

 

S_B_ARR_MENU

 

Widget interface for SAVE_B_ARRAYS

 

S_B_ARR_EVENT event
S_B_ARR_MENU "GROUP"

 

SAVE_B_ARRAYS

 

Saves the field and time arrays from the last run of PLOT_MAG.

 

SAVE_B_ARRAYS file "ASTERIX" "IDLSAVE" "XDR"

 

SAVE_B_AST

 

Save the plot_rates data arrays to Asterix IMPORT format files.

 

SAVE_B_AST fsav

 

TIDY_MAG

 

Tidy up magnetic field data after reading.

 

TIDY_MAG

 

 

idl/plot_pad

 

ACQUIRE_PAD

 

Read in the data from the ULA file.

 

ACQUIRE_PAD b_found

 

AVERAGE_COL

 

Average R8, R4, and BFIELD.

 

AVERAGE_COL

 

CRE_PAD_ARRAY

 

Create arrays for Pitch Angle Display.

 

CRE_PAD_ARRAY nmax

 

DRAWPITCH

 

Plot one box of PAD.

 

DRAWPITCH nrm xx mx ix iy ylabel nsect

 

DRAWPITCH_BOXES

 

Plot npages x nrows x ncol of PAD boxes.

 

DRAWPITCH_BOXES

 

DRAWVIEW

 

Plot one box of look direction plot.

 

DRAWVIEW theta phi mx btheta bphi ix iy ylabel nsect

 

EXT_PAD_ARRAY

 

Extend arrays for Pitch Angle Display.

 

EXT_PAD_ARRAY nmax

 

FRAMESET

 

Sets up the various constants for the plotting.

 

FRAMESET ytopr

 

GETPITCHES

 

Compute the cosine pitch angle of particle direction from the magnetic field and sector look direction.

 

GETPITCHES j cosp8 cosp4

 

INIDET

 

Initialize HISCALE instrument sector look directions for all the detectors.

 

INIDET det8 det4

 

JOIN_MENU

 

Select pad connection type from menu.

 

JOIN_EVENT event
JOIN_MENU "GROUP"

 

P_TIMELABEL

 

Label of time under a column of PAD plots.

 

P_TIMELABEL k tcol nrows b

 

PAD_ANGLE

 

Control whether to use angles or cosines for PAD plots.

 

PAD_ANGLE "ANGLE" "COSINE"

 

PAD_C_F_MENU

 

Select channels for PLOT_PAD by menu.

 

PAD_C_F_EVENT event
PAD_C_F_MENU "GROUP"

 

PAD_C_M_MENU

 

Select channels for PLOT_PAD by menu.

 

PAD_C_M_EVENT event
PAD_C_M_MENU "GROUP"

 

PAD_CHANNELS

 

To read in the channels set up file for PLOT_PAD

 

PAD_CHANNELS file "DELETE" "SAVE" "TERMINAL"

 

PAD_FC

 

Select flux or counts to plot.

 

PAD_FC "COUNT" "FLUX"

 

PAD_FLOW

 

Switch between straight pitch angle plots and flow angle plots.

 

PAD_FLOW theta phi "FLOW" "PITCH"

 

PAD_FLOW_MENU

 

Set flow parameters, via menus.

 

PAD_FLOW_EVENT event
PAD_FLOW_MENU "GROUP"

 

PAD_FLUX_CONV

 

Convert counts to flux and subtract bg if needed.

 

PAD_FLUX_CONV

 

PAD_HEADER

 

Plots an overall heading for the pad plots.

 

PAD_HEADER label yvalue

 

PAD_INT_MENU

 

Menu version of pad interval setting.

 

PAD_INT_EVENT event
PAD_INT_MENU "GROUP"

 

PAD_INTERVAL

 

Set interval for PLOT_PAD (only plot every interval'th plot).

 

PAD_INTERVAL interval

 

PAD_JOIN

 

Select whether to join up points in PAD plot.

 

PAD_JOIN "OFF" "ON" "SEQENCE" "SORT" "SYMBOLS"

 

PAD_LAYOUT

 

Control layout of PAD plots.

 

PAD_LAYOUT maxcols maxrows maxpage maxlines

 

PAD_LAYOUT_MENU

 

Control layout of plot_pad via widget interface.

 

PAD_LAYOUT_EVEN event
PAD_LAYOUT_MENU "GROUP"


PAD_MENU

 

Widget based interface for plot_pad.

 

PAD_EVENT event
PAD_MENU "GROUP"

 

PAD_SET_NAMES

 

Sets up the channel names for PLOT_PAD

 

PAD_SET_NAMES

 

PAD_X_KILL

 

Remove X-ray contaminated channels from 4-sector pads.

 

PAD_X_KILL nrm ich

 

PAD_X_MENU

 

Select exclusion level for X-rays in spectra.

 

PAD_X_EVENT event
PAD_X_MENU "GROUP"

 

PAD_XRAYS

 

Set level at which to exclude sectors 1 & 4 of the P channels in pitch plots.

 

PAD_XRAYS "LEVEL" "OFF"

 

PLOT_PAD

 

Make a plot of averaged normalized (rate or flux) vs cosine pitch angle for selected channels.

 

PLOT_PAD "PROMPT" "REREAD"

 

ROTZTHETA

 

Rotates vector 1 around z-axis in anti-clockwise angle, dly. Angle must be expressed in radian.

 

ROTZTHETA dly vect1 vect2

 

SAVE_PCHAN

 

Save the current PAD channels.

 

SAVE_PCHAN sffile

 

EC1950

 

Convert a y,d,m,h,s time to seconds after 1950.0

 

SEC1950 t

 

 

Continue

 

Return to Appendix 11 Table of Contents


Updated 8/8/19, Cameron Crane

QUICK FACTS

Manufacturer: ESA provided the Ulysses spacecraft, NASA provided the power supply, and various others provided its instruments.

Mission End Date: June 30, 2009

Destination: The inner heliosphere of the sun away from the ecliptic plane

Orbit:  Elliptical orbit transversing the polar regions of the sun outside of the ecliptic plane