Contents

• List of Figures
• 1 Introduction to the Yohkoh Instruments
  • 1.1 Yohkoh Observing Modes
  • 1.2 Bragg Crystal Spectrometer (BCS)
  • 1.3 Hard X-Ray Telescope (HXT)
  • 1.4 Soft X-Ray Telescope (SXT)
    • 1.4.1 Sequence Tables
    • 1.4.2 Automatic Exposure Control (AEC)
    • 1.4.3 Automatic Region Selection (ARS)
  • 1.5 Wide Band Spectrometer (WBS)
  • 1.6 Spacecraft Attitude Systems
    • 1.6.1 Inertial Reference Unit (IRU)
    • 1.6.2 Two Dimensional Fine Sun Sensor (TFSS)
    • 1.6.3 HXT Aspect Sensor (HXA)
    • 1.6.4 Attitude Determination Software (ADS)
• 2 Introduction to the Yohkoh Data and Software
  • 2.1 YS, YDB, and YDn Directories
  • 2.2 Yohkoh Software Organization
  • 2.3 How to Contribute Software to the Yohkoh Tree
  • 2.4 Yohkoh Data File Format
  • 2.5 Yohkoh Data File Names
    • 2.5.1 Yohkoh Directory Logicals/Environment Variables
    • 2.5.2 Yohkoh Prefixes
    • 2.5.3 Yohkoh File IDs
    • 2.5.4 Yohkoh Week IDs
    • 2.5.5 Yohkoh Carrington IDs
  • 2.6 Interactive Data Language (IDL)
    • 2.6.1 Some Comments about IDL
    • 2.6.2 Programs, Procedures, and Functions
    • 2.6.3 Running IDL programs
• 3 General Yohkoh Software
  • 3.1 Routines for Reading and Saving Data
    • RD_XDA, RD_xxx
    • RD_ROADMAP
    • RD_QS
    • 3.1.4 SAVEGEN and RESTGEN
    • SAV_SDA
    • SAV_BDA and SAV_BSC
    • SAV_HXI
    • 3.1.8 SAVE [IDL]
    • TIFF_WRITE [IDL-LIB]
    • MK_TIFFB
    • WRT_FITS [*]
    • 3.1.12 SXT2FITS
    • 3.1.13 SAVESYS and RESTSYS
  • 3.2 Concatenation of Datasets
    • STR_CONCAT_TAGS
    • 3.2.2 Concatenating Data Arrays
  • 3.3 Routines for Data Selection
    • 3.3.1 TIM2DSET
    • 3.3.2 WDEFROI [*]
  • 3.4 Routines for Making Time Plots
    • 3.4.1 UTPLOT
    • 3.4.2 OUTPLOT
    • 3.4.3 EUTPLOT
    • LCUR_IMAGE
    • 3.4.5 PLOTY
    • 3.4.6 TPROFILES
  • 3.5 Routines for Image Display and Enhancement
    • 3.5.1 STEPPER
    • 3.5.2 XSTEPPER
    • 3.5.3 XMOVIE
    • 3.5.4 OCONTOUR
    • 3.5.5 UP2, UP4, UP8 [*]
    • RM_DARKLIMB [*]
    • GBO_SCALE2 [*]
    • 3.5.8 COMPST [*]
  • 3.6 Standard IDL Image Display Routines
    • 3.6.1 TV [IDL]
    • 3.6.2 TVSCL [IDL]
    • 3.6.3 CONTOUR [IDL]
    • 3.6.4 XLOADCT [IDL-LIB]
    • 3.6.5 LOADCT [IDL-LIB]
    • 3.6.6 TVLCT [IDL]
    • 3.6.7 STRETCH [IDL]
    • GAMMA_CT [IDL]
    • 3.6.9 MOVIE [IDL-YO]
    • 3.6.10 PALETTE [IDL-LIB]
    • 3.6.11 PROFILES [IDL]
    • 3.6.12 ZOOM [IDL-LIB]
  • 3.7 Routines for Data and Information Extraction
    • 3.7.1 CONROI [*]
    • PR_IMAGE
    • 3.7.3 The Concept Behind the GT Routines
    • GT_DP_RATE
    • 3.7.5 DPRATE2SEC
    • GT_DP_MODE
    • GET_INFO
  • 3.8 Routines for Calibration and Analysis
    • FSP_PROC [*]
    • FSP_11 [*]
  • 3.9 Routines for Image Alignment
    • SXT_PREP
    • COAL_IMAGE
    • FIT_LIMB
    • DSK_LOCB [*]
    • FIND_LIMB
  • 3.10 Accessing Secondary Databases
    • 3.10.1 CONTACTS
    • PR_FEM
    • PR_EVN
    • PLOT_EVN
    • RD_FEM
    • RD_OBS
  • 3.11 Time Routines and Conventions
    • 3.11.1 Internal Representation
    • 3.11.2 External Representation
    • 3.11.3 String Representation
    • FMT_TIM
    • FMT_TIMER
    • 3.11.6 ANYTIM2INTS
    • 3.11.7 ANYTIM2EX
    • GT_DAY
    • GT_TIME
    • 3.11.10 INT2SECARR
    • 3.11.11 ANYTIM2DOY
    • 3.11.12 DOY2EX
    • 3.11.13 EX2DOW
    • 3.11.14 EX2FID
    • 3.11.15 TIM2ORBIT
    • SEL_TIMRANGE
    • PR_TIM2WEEK
    • PR_WEEK2TIM
  • 3.12 Routines for Windows and Output Devices
    • 3.12.1 Making Landscape and Portrait Plots
    • 3.12.2 WDEF
    • 3.12.3 WSHOW [IDL]
    • 3.12.4 HARDCOPY
    • 3.12.5 PPRINT
    • 3.12.6 SETDISP
  • 3.13 Reading Exabyte Archive Tapes
• 4 Spacecraft Attitude and Solar Ephemeris
  • 4.1 Routines for Determining Spacecraft Pointing
    • RD_PNT_HIST
    • SXT_CEN
    • GET_ROLL
    • HXA_SUNCENTER
  • 4.2 Routines to Convert Coordinate Systems
    • 4.2.1 Definition of the Coordinate Systems ``P'', ``A'', ``H'' and ``C''
    • CONV_P2A and CONV_A2P
    • CONV_A2H and CONV_H2A
    • CONV_P2H and CONV_H2P
    • CONV_P2HXT and CONV_HXT2P
    • CONV_P2C and CONV_C2P
    • CONV_H2HS and CONV_HS2H
  • 4.3 Routines for Ephemeris Information
    • GET_RB0P
    • DIFF_ROT
  • 4.4 Routines to Access the Yohkoh Attitude Database
    • RD_PNT
    • RD_ATR and RD_ATT
    • GET_ATT
    • GT_HXA
    • GT_IRU
• 5 Bragg Crystal Spectrometer (BCS)
  • 5.1 Routines for Data Selection
    • LIST_BDA
    • SELECT_BDA
  • 5.2 Routines for Making Time Plots
    • BCS_24HR_PLOT
    • PLOTT_BDA
    • 5.2.3 LCBDA [*]
  • 5.3 Routines for Making Spectral Plots
    • PLOTS_BDA
    • 5.3.2 PLOTBDA
    • BCS_MULTI
    • BCS_CONT
  • 5.4 Routines for 2-D Spectral Display
    • DISP_BDA
    • BCS_SPMOVIE
    • 5.4.3 GS [*]
  • 5.5 Routines for Data and Information Extraction
    • EXT_BCSCHAN
    • LIST_BDA
    • GT_TOTAL_CNTS
    • GT_BLOCKID
  • 5.6 Routines for Calibration and Analysis
    • BCS_DECOMP
    • BCS_NORM
    • SUM_BDA
    • PLOT_REF [*]
    • BCS_DTFAC
    • BCS_POINT
    • BCS_SYNTHETIC
    • BCS_SPEC
  • 5.7 BSC Routines
    • HELP_BSC
    • MK_BSC
    • SEL_BSC
    • LIST_BSC
    • SAV_BSC
    • RD_BSC
    • 5.7.7 BSC2BSD
    • MAP_BSC
    • LC_BSC
    • 5.7.10 WBDA
    • GT_BSC_BINCAL
    • FIT_BSC
    • BCS_BROAD
    • PLOT_BSC
    • FIT_BSC_PLOT
    • MK_FIT_BSC_EPS
• 6 Hard X-Ray Telescope (HXT)
  • 6.1 Routines for Making Time Plots
    • PLOTT_HDA
  • 6.2 Routines for 2-D Spectral Display
    • DISP_HDA
  • 6.3 Routines for Data and Information Extraction
    • GT_SUM_L
    • GET_INFO
  • 6.4 Routines for Calibration and Analysis
    • HXT_QLOOK
    • 6.4.2 HXTPRO
    • HXT_IMG
    • GET_HXT_POS
    • HXT_FSP and HXTBOX_FSP [*]
    • SXTHXT_FSP and SXTHXTBOX_FSP[*]
    • HXT_DECOMP
• 7 Soft X-Ray Telescope (SXT)
  • 7.1 Routines for Data Selection
    • 7.1.1 SSWHERE
    • SHOW_OBS3
    • SHOW_OBS4
    • PLOT_FOV
  • 7.2 Routines for Making Time Plots
    • LCUR_IMAGE
  • 7.3 Routines for Image Display and Enhancement
    • 7.3.1 STEPPER
    • XY_RASTER
    • DISP_MONTH
    • UNSHARP_MASK
    • DE_SPIKER
    • SXT_GRID
  • 7.4 Routines for Data and Information Extraction
    • GET_INFO
    • EXT_SUBSET [*]
    • GT_FILTA
    • GT_FILTB
    • GT_PFI_FFI
    • GT_RES
    • GT_COMP
    • GT_DPE
    • GT_MBE
    • GT_EXPDUR
    • GT_EXPLAT
    • GT_EXPMODE
    • GT_CORNER
    • GT_CENTER
    • GT_SXT_AXIS
    • GT_PIX_SIZE
    • GT_TEMP_CCD
    • GT_TEMP_HK
    • SXTPNT_SUM
    • PR_SXTOBS
    • PFI_LOC
  • 7.5 Routines for Calibration and Analysis
    • SXT_PREP
    • XSXT_PREP
    • SXT_DECOMP
    • SXT_COMP
    • RESTORE_LOW8
    • SFD_COMP
    • SFD_DECOMP
    • EXP_NORM
    • SXT_COMPOSITE
    • MK_SFD
    • DARK_SUB
    • GET_DC_IMAGE
    • LEAK_SUB
    • INTERP_IMG
    • SXT_FSP and SXTBOX_FSP [*]
    • SXTHXT_FSP and SXTHXTBOX_FSP [*]
    • SXT_TEEM
    • SXT_ERG_PER_DN
    • SXT_VIGNETTE
    • SXT_OFF_AXIS
    • WL_PROCESS [*]
  • 7.6 Routines for Image Alignment
    • SXT_PREP
    • SXT_CENTER [*]
    • GET_GBO_PFI [*]
    • 7.6.4 OCENTER
  • 7.7 Routines for Accessing Secondary Database Files
    • GTAB_COMM, GTAB_ENTRY, GTAB_ROI
    • GTAB_PFI and GTAB_FFI
  • 7.8 Routines for Engineering Plots
    • PLOT_SOT
    • PLOT_TEMPS2 [*]
    • PLOT_SSL
• 8 Wide Band Spectrometer (WBS)
  • 8.1 Routines for Making Time Plots
    • PLOTT_WDA
  • 8.2 Routines for Making Spectral Plots
    • PLOTS_WDA
  • 8.3 Routines for 2-D Spectral Display
    • DISP_WDA
    • 8.3.2 SXSPC
    • 8.3.3 WBSPC
    • PLOT_HXSPC
    • PLOT_HXSPH
    • PLOT_GRSPCL
    • PLOT_GRSPCH
    • PLOT_GRSPHL
    • PLOT_GRSPHH
    • 8.3.10 Light Curve of RBM-PC
  • 8.4 Routines for Data and Information Extraction
    • GT_ Routines
    • GET_INFO
  • 8.5 Routines for Calibration and Analysis
    • HXS_FSP [*]
    • HXS_SPL
    • HXS_SP2
    • GRS_SPEFF
    • 8.5.5 Further Analysis of HXS and GRS Data
  • 8.6 Instrument Response Files
    • 8.6.1 SXS
    • 8.6.2 HXS
    • 8.6.3 GRS
• 9 Software for Ground-Based and Other Satellites (GBO)
  • 9.1 Accessing Ground-Based FITS Images
    • 9.1.1 Directory and File Organization
    • 9.1.2 RFITS
    • GBO_MASK
  • 9.2 Accessing GOES Data
    • PR_GEV
    • PLOT_GOES
  • 9.3 Accessing GRO BATSE Data
    • PR_GBE
    • PLOT_GBL
• 10 Low Level Routines
  • 10.1 Plotting Routines
    • PLOT_LCUR
    • 10.1.2 CLEARPLOT
    • CLEAR_UTPLOT
  • 10.2 File and Directory Routines
    • CONCAT_DIR
    • FILE_LIST
    • FILE_MENU
    • DATA_PATHS
    • DATA_PATHS2
    • NEW_DPATH
    • GBO_PATHS
    • GET_SUBDIRS
    • PR_PATH
    • PATH_LIB
    • PR_PATH_LIB
    • FILES_SEARCH
  • 10.3 Miscellaneous
    • 10.3.1 PRSTR
    • 10.3.2 STR2ARR
    • 10.3.3 ARR2STR
    • STR_REPLACE
    • WC_WHERE
    • 10.3.6 REBIN [IDL]
    • PLOT_TRAV
    • RD_TFILE
    • DEF_TAPD
    • WMENU_SEL
    • STR_DIFF
• 11 Getting Help on Software and Data
  • DOC_LIBRARY [IDL-LIB]
  • 11.2 FASTDOC
    • PR_PATH_LIB
  • 11.3 XDOC
  • 11.4 CHKARG
  • 11.5 XDL [IDL-LIB]
  • PRO_LIST
  • 11.7 HELP [IDL]
  • HELP_PREFIX
  • HELP_FIGS
• C How to Contribute Software to the Yohkoh System
• D Institutes and Nodes with the Yohkoh Package
  • D.1 List of Institutes
  • D.2 List of Node Names and Numbers
• E Accessing the University of Hawaii SPAM Database
• F Accessing the Optical Solar Data of NAOJ
• G Using the Laser Disk System at ISAS
  • Viewing Existing Movies (VIDEO_MENU)
  • G.2 Making Title Pages
  • G.3 Recording a New Movie to Laser Disk
    • G.3.1 Hardware: Positioning the Sony Laser Disk
    • G.3.2 Software
    • G.3.3 Adding Another Movie
    • G.3.4 NVS/Sony Problems
  • G.4 Transferring a Movie to VCR Video
    • G.4.1 Initial setup
    • G.4.2 Short test of hardware communications.
    • Running MK_VCR
    • How to create/modify the file that MK_VCR uses
• H Using the Laser Disk System at LPARL
  • H.1 Viewing Existing Movies
    • H.1.1 Using IDL and Menu Driven Software
    • H.1.2 Displaying a Single Recorded Image
    • H.1.3 Playing the Panasonic Laser Disks
  • H.2 Making Title Pages
  • H.3 Recording a New Movie to Laser Disk
    • H.3.1 Panasonic Problems
  • H.4 Transferring a Movie to VCR Video
• I Using Magneto-Optical (MO) Disks at ISAS
  • I.1 Mounting MO Disks From Unix
  • I.2 Mounting MO Disks From IDL
• J Guidelines for Writing Distributed Software
  • J.1 Names of Routines
  • J.2 Calling Sequence
  • J.3 Standard Headers
  • J.4 Modularize
  • J.5 Portability
  • J.6 Don't Hardwire to Fixed Units
• K Yohkoh Distribution and Archive Tapes
  • K.1 The Organization of the Tapes
  • K.2 Overview of Yohkoh Data Archive
  • K.3 Structure of Archive Tape
  • K.4 Access Software
    • K.4.1 Reading Tapes (RDTAP)
    • K.4.2 Tape Reading on VMS
    • K.4.3 Tape Read Errors
    • K.4.4 Writing Tapes
• L Yohkoh and General Miscellaneous Information
  • L.1 Table of Dates and Times of Missing Data
  • L.2 Dates that SXT CCD was Baked Out
  • L.3 Table of Number of SXT Images and Dark Current Levels
  • L.4 Amount of Yohkoh Data per Week
  • L.5 Time Conversions for Different Time Zones
• M Guides to Yohkoh Operations at ISAS
• About this document ...