Name

---

SXREAD

Purpose

---

Read a Space Telescope STSDAS image file

Calling Sequence

---

result = sxread( Unit, group , [par] )

Inputs

---

UNIT = Unit number of file, must be from 1 to 9.
Unit must have been opened with SXOPEN.
GROUP = group number to read. if omitted, read first record.
The first record is number 0.

Outputs

---

Result of function = array constructed from designated record.

Optional Output

---

PAR = Variable name into which parameter values from STSDAS
group parameter block are read. It is a byte array
which may contain multiple data types. The function
SXGPAR can be used to retrieve values from it.

Common Blocks

---

Uses IDL Common STCOMMN to access parameters.

Notes

---

Use the function SXGREAD to read the group parameter blocks without
having to read the group array.
If the STSDAS file does not contain groups, then the optional output
parameter PAR is returned undefined, but no error message is given.

Side Effects

---

IO is performed.

Modification History

---

WRITTEN, Don Lindler, July, 1 1987
Converted to IDL V5.0 W. Landsman September 1997