SUBROUTINE HSI0_INIT( STATUS )
*+
* Name:
* HSI0_INIT
* Purpose:
* Load ADI definitions required for HSI operation
* Language:
* Starlink Fortran
* Invocation:
* CALL HSI0_INIT( STATUS )
* Description:
* Loads those class definitions required by the HSI subroutine group.
* Results in the following classes being defined,
*
* Methods are defined to read and write HSI information from HDS and
* FITS files.
* Arguments:
* STATUS = INTEGER (given and returned)
* The global status.
* Examples:
* {routine_example_text}
* {routine_example_description}
* Pitfalls:
* {pitfall_description}...
* Notes:
* {routine_notes}...
* Prior Requirements:
* {routine_prior_requirements}...
* Side Effects:
* {routine_side_effects}...
* Algorithm:
* {algorithm_description}...
* Accuracy:
* {routine_accuracy}
* Timing:
* {routine_timing}
* External Routines Used:
* ADI:
* ADI_REQPKG - Load a package from the load path
* Implementation Deficiencies:
* {routine_deficiencies}...
* References:
* HSI Subroutine Guide : http://www.sr.bham.ac.uk/asterix-docs/Programmer/Guides/hsi.html
* Keywords:
* package:hsi, usage:private, history, initialisation
* Copyright:
* Copyright (C) University of Birmingham, 1995
* Authors:
* DJA: David J. Allan (Jet-X, University of Birmingham)
* {enter_new_authors_here}
* History:
* 9 Jan 1995 (DJA):
* Original version.
* {enter_changes_here}
* Bugs:
* {note_any_bugs_here}
*-
* Type Definitions:
IMPLICIT NONE ! No implicit typing
* Global Constants:
INCLUDE 'SAE_PAR' ! Standard SAE constants
INCLUDE 'AST_PKG'
* Status:
INTEGER STATUS ! Global status
* External References:
LOGICAL AST_QPKGI
EXTERNAL AST_QPKGI
EXTERNAL HSI1_ADD
EXTERNAL HSI1_COPY
EXTERNAL HSI1_GETCTR
EXTERNAL HSI1_GETREC
EXTERNAL HSI1_NEW
EXTERNAL HSI1_OK
EXTERNAL HSI1_PTXT
EXTERNAL HSI1_PUTCTR
EXTERNAL HSI2_ADD
EXTERNAL HSI2_PTXT
EXTERNAL ADI_DEFMTH
EXTERNAL ADI_REQPKG
EXTERNAL ADI_NULMTH
* Local Variables:
INTEGER DID ! Unused method id
*.
* Check inherited global status.
IF ( STATUS .NE. SAI__OK ) RETURN
* Check not already initialised?
IF ( .NOT. AST_QPKGI( HSI__PKG ) ) THEN
* Load the ADI classes
CALL ADI_REQPKG( 'history', STATUS )
* Define history copiers
CALL ADI_DEFMTH( 'CopyHistory(_HDSfile,_HDSfile)', HSI1_COPY,
: DID, STATUS )
CALL ADI_DEFMTH( 'CopyHistory(_FITSfile,_HDSfile)', ADI_NULMTH,
: DID, STATUS )
CALL ADI_DEFMTH( 'CopyHistory(_HDSfile,_FITSfile)', ADI_NULMTH,
: DID, STATUS )
* Data extractors & modifiers
CALL ADI_DEFMTH( 'GetHistoryCtrl(_HDSfile)', HSI1_GETCTR,
: DID, STATUS )
CALL ADI_DEFMTH( 'GetHistoryRec(_HDSfile,_INTEGER)',
: HSI1_GETREC, DID, STATUS )
CALL ADI_DEFMTH( 'PutHistoryCtrl(_HDSfile,_HistoryControl)',
: HSI1_PUTCTR, DID, STATUS )
* Checkers
CALL ADI_DEFMTH( 'ChkHistory(_HDSfile)', HSI1_OK,
: DID, STATUS )
* Creators of new history
CALL ADI_DEFMTH( 'AddHistoryText(_HDSfile,_CHAR[])', HSI1_PTXT,
: DID, STATUS )
CALL ADI_DEFMTH( 'AddHistory(_HDSfile,_CHAR)', HSI1_ADD,
: DID, STATUS )
CALL ADI_DEFMTH( 'NewHistory(_HDSfile)', HSI1_NEW,
: DID, STATUS )
CALL ADI_DEFMTH( 'AddHistoryText(_FITSfile,_CHAR[])', HSI2_PTXT,
: DID, STATUS )
CALL ADI_DEFMTH( 'AddHistory(_FITSfile,_CHAR)', HSI2_ADD,
: DID, STATUS )
CALL ADI_DEFMTH( 'NewHistory(_FITSfile)', ADI_NULMTH,
: DID, STATUS )
* Now initialised
CALL AST_SPKGI( HSI__PKG )
END IF
* Report any errors
IF ( STATUS .NE. SAI__OK ) CALL AST_REXIT( 'HSI0_INIT', STATUS )
END