ULYSSES In Space

 

Sun Banner
ULYSSES

Ulysses HISCALE Data Analysis Handbook

 

Appendix 11. HISCALE IDL Display System (IDL_HS)

 

A11.2 Part Two - Reference

 

A11.2.1 Introduction

 

This document is a reference summary for the IDL_HS package. It simply contains lists of procedures and common blocks, etc.

 

 

 

A11.2.2 Procedures

 

This section is simply a list of the procedures in the package, ordered by directories and alphabetically within the directory. Note that the material has been extracted mindlessly from the comments in the routines (actually from the 00_summary_dir procedure used by HS_HELP to provide the same information and from a HELP, /ROUTINES call after compiling everything).

 

List of procedures:

 

idl idl/movie
idl/cdf idl/plot_mag
idl/etc/acf idl/plot_pad
idl/etc/oddments idl/plot_rates
idl/etc/padlan idl/plot_spect
idl/etc/swoops idl/plot_uds
idl/genplot idl/utils
idl/hsio

 

 

idl

 

CDF_DEFINE

 

Define structures for CDF.

 

CDF_DEFINE

 

HS_DEFINE

 

Define HISCALE data structures.

 

HS_DEFINE

 

HS_MENU

 

Controller for menu generator and handler for HISCALE Widget interface.

 

HS_MENU hs_debug widuse

 

HS_MENU_TOP

 

Maker and event handler for the top-level HISCALE menu.

 

HS_EVENT event
HS_MENU_TOP

 

IDF

 

Get the rate channel energies, etc., from IDF.DAT.

 

IDF idffile

 

IDF_MENU

 

Create and control a menu for reading an IDF file.

 

IDF_EVENT event
IDF_MENU "GROUP"

 

SET_DEFAULT_DIR

 

Sets initial values for the directories.

 

SET_DEFAULT_DIR

 

 

idl/cdf

 

ACQUIRE_CDF

 

Reads in the data from the CDF file and stores the appropriate parts of it in the arrays rates and times.

 

ACQUIRE_CDF

 

ACQUIRE_CDF_HED

 

Reads in the data from the HED CDF file and stores the appropriate parts of it in the arrays rates and times.

 

ACQUIRE_CDF_HED

 

CDF_CH_NAMES

 

Return names and descriptions of the CDF channels for menus.

 

CDF_CH_NAMES expt ccount chan descr edescr

 

CDF_CHAN

 

Select the CDF channel or channels to plot.

 

CDF_CHAN chnames

 

CDF_CHAN_MENU

 

Menu interface for CDF_CHAN.

 

CDF_CHAN_EVENT event
CDF_CHAN_MENU "GROUP"

 

CDF_DOFILTER

 

Applies a simplified version of the SPIKE & DROPOUT removal algorithm of plot_rates to CDF data.

 

CDF_DOFILTER

 

CDF_FILTER

 

Select whether to attempt to "filter" CDF plots.

 

CDF_FILTER "OFF" "ON"

 

CDF_HEADER

 

Plots an overall heading for the CDF plots.

 

CDF_HEADER

 

CDF_MENU

 

Widget based interface for cdf.

 

CDF_EVENT event
CDF_MENU "GROUP"

 

CDF_PLOT

 

CDF_PLOT

 

CONV_CDF

 

Converts a CDF record of any type into a usable structure.

 

CONV_CDF raw proce

 

CRE_CDF_ARRAYS

 

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

 

CRE_CDF_ARRAYS nvals

 

EXT_CDF_ARRAYS

 

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

 

EXT_CDF_ARRAYS ndmax

 

GET_BAM

 

Convert a BAM CDF record to a useful structure with native-mode values.

 

GET_BAM rec

 

GET_GLG

 

Convert a GLG CDF record to usable form.

 

GET_GLG rec

 

GET_HED

 

Convert a HED CDF record to usable form.

 

GET_HED it bx by bz

 

GET_KEP

 

Convert a KEP CDF record to usable form.

 

GET_KEP rec

 

GET_LAN

 

Convert a LAN CDF record to usable form.

 

GET_LAN rec

 

GET_SIM_HET

 

Convert a SIM_HET CDF record to usable form.

 

GET_SIM_HET rec

 

GET_SIM_KET

 

Convert a SIM_KET CDF record to usable form.

 

GET_SIM_KET rec

 

GET_SIM_LET

 

Convert a SIM_LET CDF record to usable form.

 

GET_SIM_LET rec

 

GET_STO

 

Convert a STO CDF record to usable form.

 

GET_STO rec

 

IBM_FIX

 

Converts one or more IBM short integer values to native mode. Works by using the fact that IBM's are big endian as network.

 

IBM_FIX ibmvals

 

IBM_FLOAT

 

Takes a byte array containing one or more IBM floating point values, and returns native mode floating point values.

 

IBM_FLOAT ibmval

 

IBM_LONG

 

Converts one or more IBM long integer values to native mode. Works by using the fact that IBM's are big endian as network.

 

IBM_LONG ibmvals

 

INVSEC

 

This function converts seconds since 1950.0 into year,day,hour,min, and sec.

 

INVSEC stime

 

PLOT_CDF

 

Make a plot of selected channels from the ULYSSES CDF.

 

PLOT_CDF "PROMPT" "REREAD"

 

REC_TYPE

 

Returns a code for the type of CDF record.

 

REC_TYPE rec

 

SCTIME

 

Converts a spacecraft 6-byte time field (I*4 seconds since 1950.0, I*2 fractional second) to a double precision floating point value.

 

SCTIME st

 

 

idl/etc/acf

 

ACF

 

Compute autocorrelation function of PLOT_RATES data.

 

EXCISE

 

Set to zero, or other given value a given time-range of rates data.

 

EXTRACTCF

 

Extracts a segment of autocorrelation function (or structure function).

 

FOLD

 

Period folding function program.

 

PAD_GAPS

 

Pads out data gaps in uav or cmp data, for acf, etc.

 

SF

 

Compute structure function of PLOT_RATES data.

 

XCF

 

Compute cross correlation function of PLOT_RATES data.

 

 

idl/etc/oddments

 

CHECK_MAG

 

Checks the times in a magnetic field file for sequentiality.

 

DELAYS

 

Compute delays along a specified path for all HISCALE channels.

 

DRAWORIENT

 

Draw the magfield directions relative to the S/C.

 

HS_EDIT

 

Select and extract records from an HSIO file.

 

PHACHK

 

Check number of events in PHAR records.

 

RATE_INDEX

 

Compute spectral index from rates array.

 

SSPECT

 

Plot a spectrum/time-series as a 3-D surface.

 

 

idl/etc/padlan

 

ANORM

 

Calculates sector-ave'd normal area.

 

LANCOSINE

 

Calculates angular response for stationary heads.

 

PADLAN3

 

Simulates convected expl pad for LAN heads.

 

POLAR_PLOT

 

Simple program to plot polar diagram of particle distributions.

 

VDIR

 

Convert SWOOPS RTN Velocity components to s/c directions.

  

 

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