Image An array of structures containing information

about any Image extensions in this file

Unknown An array of structures containing information

about any non standard extensions in this file.

The AsciiTable structure will contain the following fields:

Rows The number of rows in the table

RowSize The number of characters in each row

NFields The number of fields in each row

FieldFormat A 1 x NFields cell containing formats in which each

field is encoded. The formats are FORTRAN-77 format codes.

FieldPrecision A 1 x NFields cell containing precision of the data in

each field

FieldWidth A 1 x NFields array containing the number of characters

in each field

FieldPos A 1 x NFields array of numbers representing the

starting column for each field

DataSize Size in bytes of the data in the ASCII Table

MissingDataValue A 1 x NFields array of numbers used to represent

undefined data in each field

Intercept A 1 x NFields array of numbers used along with Slope to

calculate actual data values from the array data values

using the equation: actual_value = Slope*array_value+

Intercept

Slope A 1 x NFields array of numbers used with Intercept to

calculate true data values from the array data values

using the equation: actual_value = Slope*array_value+

Intercept

Offset Number of bytes from beginning of file to location of

first data value in the table

Keywords A number-of-keywords x 3 cell array containing all the

Keywords, Values and Comments in the ASCII table header

The BinaryTable structure will contain the following fields:

Rows The number of rows in the table

RowSize The number of bytes in each row

NFields The number of fields in each row

FieldFormat A 1 x NFields cell containing the data type of the data

in each field. The data type is represented by a

FITS binary table format code.

FieldPrecision A 1 x NFields cell containing precision of the data in

each field

FieldSize A 1 x NFields array containing the number of values in

the Nth field

DataSize Size in bytes of data in the Binary Table. Value

includes any data past the main table

MissingDataValue An 1 x NFields array of numbers used to represent

undefined data in each field

Intercept A 1 x NFields array of numbers used along with Slope to

calculate actual data values from the array data values

using the equation: actual_value = Slope*array_value+

Intercept

Slope A 1 x NFields array of numbers used with Intercept to

calculate true data values from the array data values

using the equation: actual_value = Slope*array_value+

Intercept

Offset Number of bytes from beginning of file to location of

first data value

ExtensionSize The size in bytes of any data past the main table

ExtensionOffset The number of bytes from the beginning of the file to

the location of the data past the main table

Keywords A number-of-keywords x 3 cell array containing all the

Keywords, Values and Comments in the Binary table header

The Image structure will contain the following fields:

DataType Precision of the data

Size Array containing sizes of each dimension

DataSize Size in bytes of data in the Image extension

MissingDataValue Value used to represent undefined data

Intercept Value used along with Slope to calculate true pixel

values from the array pixel values using the equation:

actual_value = Slope*array_value + Intercept

Slope Value used along with Intercept to calculate true pixel

values from the array pixel values using the equation:

actual_value = Slope*array_value + Intercept

Offset Number of bytes from beginning of file to location of

first data value

Keywords A number-of-keywords x 3 cell array containing all the

Keywords, Values and Comments in the Image header

The Unknown structure will contain the following fields:

DataType Precision of the data

Size Array containing sizes of each dimension

DataSize Size in bytes of data in the extension

Intercept Value used along with Slope to calculate true data

values from the array data values using the equation:

actual_value = Slope*array_value + Intercept

Slope Value used along with Intercept to calculate true data

values from the array data values using the equation:

actual_value = Slope*array_value + Intercept

MissingDataValue Value used to represent undefined data

Offset Number of bytes from beginning of file to location of

first data value

Keywords A number-of-keywords x 3 cell array containing all the

Keywords, Values and Comments in the extension header

Example:

info = fitsinfo('tst0012.fits');

See also fitsread.

Reference page in Help browser

doc fitsinfo

<fitsread> - Read data from a FITS file.

FITSREAD Read data from FITS file

DATA = FITSREAD(FILENAME) reads data from the primary data of the FITS

(Flexible Image Transport System) file FILENAME. Undefined data values

will be replaced by NaN. Numeric data will be scaled by the slope and

intercept values and is always returned in double precision.

DATA = FITSREAD(FILENAME,OPTIONS) reads data from a FITS file according to

the options specified in OPTIONS. Valid options are:

EXTNAME EXTNAME can be either 'Primary', 'Table', 'BinTable',

'Image', or 'Unknown' for reading data from the primary

data array, ASCII table extension, Binary table extension,

Image extension or an unknown extension respectively. Only

one extension should be supplied. DATA for ASCII and

Binary table extensions is a 1-D cell array. The contents

of a FITS file can be located in the Contents field of the

structure returned by FITSINFO.

EXTNAME,IDX Same as EXTNAME except if there is more than one of the

specified extension type, the IDX'th one is read.

'Raw' DATA read from the file will not be scaled and undefined

values will not be replaced by NaN. DATA will be

the same class as it is stored in the file.

'Info',INFO When reading from a FITS file multiple times, passing

the output of FITSINFO with the 'Info' parameter helps

FITSREAD locate the data in the file more quickly.

Example:

data = fitsread('tst0012.fits');

See also fitsinfo.

Reference page in Help browser

doc fitsread

HDF version 4 file handling

<hdfinfo> - Get information about an HDF4 file.

HDFINFO Information about HDF 4 or HDF-EOS 2 file

FILEINFO = HDFINFO(FILENAME) returns a structure whose fields contain

information about the contents an HDF or HDF-EOS file. FILENAME is a

string that specifies the name of the HDF file. HDF-EOS files are

described as HDF files.

FILEINFO = HDFINFO(FILENAME,MODE) reads the file as an HDF file if MODE

is 'hdf', or as an HDF-EOS file if MODE is 'eos'. If MODE is 'eos',

only HDF-EOS data objects are queried. To retrieve information on the

entire contents of a hybrid HDF-EOS file, MODE must be 'hdf' (default).

The set of fields in FILEINFO depends on the individual file. Fields

that may be present in the FILEINFO structure are:

HDF objects:

Filename A string containing the name of the file

Vgroup An array of structures describing the Vgroups

SDS An array of structures describing the Scientific Data Sets

Vdata An array of structures describing the Vdata sets

Raster8 An array of structures describing the 8-bit Raster Images

Raster24 An array of structures describing the 24-bit Raster Images

HDF-EOS objects:

Point An array of structures describing HDF-EOS Point data

Grid An array of structures describing HDF-EOS Grid data

Swath An array of structures describing HDF-EOS Swath data

The data set structures above share some common fields. They are (note,

not all structures will have all these fields):

Filename A string containing the name of the file

Type A string describing the type of HDF object

Name A string containing the name of the data set

Attributes An array of structures with fields 'Name' and 'Value'

describing the name and value of the attributes of the

data set

Rank A number specifying the number of dimensions of the

data set

Ref The reference number of the data set

Label A cell array containing an Annotation label

Description A cell array containing an Annotation description

Fields specific to each structure are:

Vgroup:

Class A string containing the class name of the data set

Vgroup An array of structures describing Vgroups

SDS An array of structures describing Scientific Data sets

Vdata An array of structures describing Vdata sets

Raster24 An array of structures describing 24-bit raster images

Raster8 An array of structures describing 8-bit raster images

Tag The tag of this Vgroup

SDS:

Dims An array of structures with fields 'Name', 'DataType',

'Size', 'Scale', and 'Attributes'. Describing the

dimensions of the data set. 'Scale' is an array of numbers

to place along the dimension and demarcate intervals in

the data set.

DataType A string specifying the precision of the data

Index Number indicating the index of the SDS

Vdata:

DataAttributes An array of structures with fields 'Name' and 'Value'

describing the name and value of the attributes of the

entire data set

Class A string containing the class name of the data set

Fields An array of structures with fields 'Name' and

'Attributes' describing the fields of the Vdata

NumRecords A number specifying the number of records of the data

set

IsAttribute 1 if the Vdata is an attribute, 0 otherwise

Raster8 and Raster24:

Name A string containing the name of the image

Width An integer indicating the width of the image

in pixels

Height An integer indicating the height of the image

in pixels

HasPalette 1 if the image has an associated palette, 0 otherwise

(8-bit only)

Interlace A string describing the interlace mode of the image

(24-bit only)

Point:

Level A structure with fields 'Name', 'NumRecords',

'FieldNames', 'DataType' and 'Index'. This structure

describes each level of the Point

Grid:

UpperLeft A number specifying the upper left corner location

in meters

LowerRight A number specifying the lower right corner location

in meters

Rows An integer specifying the number of rows in the Grid

Columns An integer specifying the number of columns in the Grid

DataFields An array of structures with fields 'Name', 'Rank', 'Dims',

'NumberType', 'FillValue', and 'TileDims'. Each structure

describes a data field in the Grid fields in the Grid

Projection A structure with fields 'ProjCode', 'ZoneCode',

'SphereCode', and 'ProjParam' describing the Projection

Code, Zone Code, Sphere Code and projection parameters of

the Grid

Origin Code A number specifying the origin code for the Grid

PixRegCode A number specifying the pixel registration code

Swath:

DataFields An array of structures with fields 'Name', 'Rank', 'Dims',

'NumberType', and 'FillValue'. Each structure

describes a Data field in the Swath

GeolocationFields An array of structures with fields 'Name', 'Rank', 'Dims',

'NumberType', and 'FillValue'. Each structure

describes a Geolocation field in the Swath

MapInfo A structure with fields 'Map', 'Offset', and

'Increment' describing the relationship between the

data and geolocation fields.