NAME

VOTABLE::FITS - VOTABLE FITS XML element class


SYNOPSIS

use VOTABLE::FITS;


DESCRIPTION

This class implements the FITS element from the VOTABLE DTD. This element is used to encapsulate FITS-formatted data.

The FITS element is a Tier 1 element, and is described by the following excerpt from the VOTABLE 1.0 DTD:

 <!ELEMENT FITS (STREAM)>
 <!ATTLIST FITS
         extnum CDATA #IMPLIED
 >

Methods

new($xmldom_element, %options)

Create and return a new VOTABLE::FITS object, based on the supplied XML::DOM::Element object, using %options to set the attributes of the new object. If no XML::DOM::Element object is specified, or is undefined, create and return an empty VOTABLE::FITS object. Return undef if an error occurs.

get_extnum

Return the value of the extnum attribute. Return undef if the attribute has not been set, or an error occurs.

set_extnum($extnum)

Set the value of the extnum attribute to the specified value. Return the new value of the attribute on success, or undef if an error occurs.

get_stream

Return the VOTABLE::STREAM object for the STREAM element which is the child of this FITS element. Return undef if no STREAM element is found, or an error occurs.

set_stream($votable_stream)

Set the STREAM element for this FITS element using the supplied VOTABLE::STREAM object. Any existing STREAM element is first removed. Return the VOTABLE::STREAM object on success, or undef if an error occurs.

Notes on class internals


WARNINGS


SEE ALSO

VOTABLE, VOTABLE::DATA, VOTABLE::STREAM


AUTHOR

Eric Winter, NASA GSFC (elwinter@milkyway.gsfc.nasa.gov)


VERSION

$Id: FITS.pm,v 1.1.1.8 2002/05/21 14:10:49 elwinter Exp $