Starlink Project
Starlink User Note 229.2

Tim Jenness, Remo Tilanus,
Horst Meyerdierks, Jon Fairclough

30 November 2014

The Global Section Datafile (GSD) access library


Programmer’s Manual


This document describes the Global Section Datafile (GSD) access library. This library provides read-only access to GSD files created at the James Clerk Maxwell Telescope. A description of GSD itself is presented in addition to descriptions of the library routines.


1 History
2 Introduction
3 C interface
4 Fortran interface
5 Perl interface
6 Programming Notes
7 Programming Tools
8 Release Notes
A Technical Overview
B Subroutine List
C Routine Descriptions
gsdClose – Close a GSD file
gsdFind – Find GSD item by name
gsdGet0x – Get a scalar value from a GSD file
gsdGet1x – Get an array from a GSD file
gsdInqSize – Inquire array size
gsdItem – Get GSD item by number
gsdOpenRead – Open a GSD file for reading and map it

D Mapping


[1]   Fairclough J. H., 1989, GSD – Global Section Datafile System, JCMT Note MT/IN/33

[2]   Holland W. S., Robson E.I., Gear W.K., Lightfoot J. F., Jenness T., Ivison R. J., Stevens J. A., Cunningham C. R., Ade P. A. R., Griffin M. J., Duncan W. D., Murphy J. A., Naylor D. A., 1999, MNRAS, 303, 659

[3]   Warren-Smith R. F., 1998, NDF – Routines for Accessing the Extensible N-Dimensional Data Format, Starlink User Note 33

[4]   Lightfoot J. F., Harrison P. A., Meyerdierks H., 1995, JCMTDR – Applications for reducing JCMT data, Starlink User Note 132

[5]   Prestage R. M., Meyerdierks H., Lightfoot J. F., 1995, SPECX – A millimetre wave spectral reduction package, Starlink User Note 17

[6]   Warren-Smith R. F., 1995, PRIMDAT – processing of primitive numerical data, Starlink User Note 39