---
name: "Astro::FITS::Header::GSD"
section: "3pm"
platform: "linux"
package: "libastro-fits-header-perl"
version: "3.09-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Astro::FITS::Header::GSD"
---

# Astro::FITS::Header::GSD(3pm)

Manipulate FITS headers from GSD files

## NAME

Astro::FITS::Header::GSD - Manipulate FITS headers from GSD files

## SYNOPSIS

```
  use Astro::FITS::Header::GSD;
  $hdr = new Astro::FITS::Header::GSD( Cards => \@cards );
  $hdr = new Astro::FITS::Header::GSD( gsdobj => $gsd );
  $hdr = new Astro::FITS::Header::GSD( File => $file );
```

## DESCRIPTION

This module makes use of the Starlink GSD module to read from a GSD header.

It stores information about a FITS header block in an object. Takes an hash as an argument, with either an array reference pointing to an array of FITS header cards, or a filename, or (alternatively) a GSD object.

## METHODS

- **configure**

  Reads a header from a GSD file.

  ```
    $hdr->configure( Cards => \@cards );
    $hdr->configure( Items => \@items );
    $hdr->configure( gsdobj => $gsd );
    $hdr->configure( File => $filename );
  ```

  Accepts a GSD object or a filename. If both `"gsdobj"` and `"File"` keys exist, `"gsdobj"` key takes priority.

- **writehdr**

  The GSD library is read-only. The writehdr method is not implemented for this sub-class.

## NOTES

This module requires the Starlink GSD module.

GSD supports keys that are longer than the 8 characters allowed as part of the FITS standard. GSD keys are truncated to 8 characters by this module.

## SEE ALSO

NDF, Astro::FITS::Header, Astro::FITS::Header::Item Astro::FITS::Header::CFITSIO, Astro::FITS::Header::NDF

## AUTHORS

Tim Jenness \<t.jenness@jach.hawaii.edu\>, Alasdair Allan \<aa@astro.ex.ac.uk\>

## COPYRIGHT

Copyright (C) 2008-2011 Science & Technology Facilities Council. Copyright (C) 2001-2002 Particle Physics and Astronomy Research Council. All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place,Suite 330, Boston, MA  02111-1307, USA