SBN Archive File Types
There are several different file types, indicated by the file extension, found in the SBN archives and in the data set review pages. They include:
- .asc
- These are plain ASCII text files which are most often found in the document/ directory of a data set. Many times they accompany a .doc file and contain identical information for those users who can not open .doc files. They can be opened using a standard text editor or a browser.
- .bin
- These files contain tabular binary data. Some sort of software is typically required to view these files. The SBN utility for IDL, ReadPDS should read be able to read these files into IDL for further processing and display. (Be sure to use the correct PDS3 or PDS4 version.)
- .cat
- These are PDS3 required catalog files which supply high-level information about the (PDS3) data set for use in the central PDS catalog and will be found in the catalog/ directory. They include things like an overview of the data set, its processing history, and other information associated with the mission or subsequent data reduction which might be of interest. They are ASCII text files and can be displayed with any standard text editor. However, users with Windows systems should be aware that Windows reserves the .cat extension to indicate system security files, and may not allow unprivileged users to open or even see the files. Changing the files extension to .txt usually solves the problem. Browsers other than Internet Explorer will usually display these files on Windows systems without complaint. Do note, these can be found in a PDS4 archive for data that has been migrated from PDS3 into PDS4.
- .csv
- These are Comma-separated Variable format ASCII spreadsheets. In PDS4 they are used as to list all of the products in a collection and are referenced by the collection label. In PDS3 they may be found in the data/, document/, calibration (calib/), or index/ directory. They can be opened using any standard text editor, browser, or most spreadsheet programs with a CSV-import option.
- .dat
- The .dat suffix indicates a binary data file. They may appear in the data/ directory and have an associated PDS label. Some sort of software is typically required to view these files. The SBN utility for IDL, ReadPDS, should read be able to read these files into IDL for further processing and display. (Be sure to use the correct PDS3 or PDS4 version.)
- .doc
- These are Microsoft Word document files which may be found in the document/ directory. They contain detailed documentation on some aspect of the dataset from which they come. Typically, they are accompanied by a plain text version of the file (.asc file) or a .pdf version and a PDS label. They can be opened using Microsoft Word or other word processing software that is capable of reading Word 2003 and earlier documents.
- .fit
- Flexible Image Transport System (FITS) files are data files, and the most common image data format in the SBN archive. They may contain images, spectra, and/or tables. All FITS files have both a header and data in the same file and may have multiple file extensions. They also have separate PDS labels. FITS files should be readily interpreted by any standard FITS image display software or pre-existing routines in standard analysis packages (like IRAF, IDL, MatLab, Mathematica, etc.). Some links are provided for downloading display software:
Note that the PDS labels which correspond to the FITS image files will contain a pointer and object description for the FITS header as well as the image.
- .gif
- Graphics Interface Format files are low-resolution image files which may appear in the document/ directory either as part of a larger collection of files or as stand-alone graphics. They will be listed in a PDS label and can be opened using most image manipulation software (like XV, Photoshop, etc.) or a browser.
- .html/.htm
- HyperText Markup Language (HTML/HTM) files can be included in a PDS archive so long as they are human-readable and do not have links external to the archive.
- .img
- These are PDS binary image files with attached or detached PDS labels. They may be found in the /data directory. They can be displayed using the PDS NASAView tool. The SBN utility ReadPDS will read the data into IDL. (Be sure to use the PDS4 version for PDS4 data sets.)
- .jpg
- These are compressed image files which may appear in the document/ directory either as part of a larger document or as stand-alone images. They will be referenced by a PDS label and can be opened using most image manipulation software (like XV, Photoshop, etc.) or a browser.
- .lbl
- (PDS3 only) The PDS label files describe the contents of each referenced file in detail, field-by-field, and are a PDS3 archive requirement. Labels include a physical description of the storage format as well as a logical explanation of the significance or content of each field. Detached labels accompany most files in the SBN holdings and are ASCII text, so they can be read with any standard text editor or browser.
- .pdf
- These are Adobe Portable Document Format (PDF) files. They may be found in the document/ directory and should have an associated PDS label. They can be opened using any standard PDF viewer.
- .png
- These are Portable Network Graphics images, another image format. They may appear in the document/ directory as part of a larger document or as stand-alone images. They can be opened using most image manipulation software (like XV, Photoshop, etc.) or a browser.
- .sch
- This is the Schematron document. It is one of the two schema files referenced in PDS4 labels. The Schematron defines the syntax for relationships in XML documents and standard values. The SBN Wiki contains a useful page on viewing XML files which also applies to .sch files.
- .tab
- These are ASCII table files. Table files may be found in most directories. The tables should be accompanied by PDS labels. The tables should be displayable in a standard text editor or browser.
- .tar
- These files are tape archive format files, which are used to simplify storage and downloads of large data sets. They preserve the directory structure of the data set volume. Data reviewers and archive users may encounter .tar files when downloading an entire data directory or a large set of documentation. Tar files can be opened by using GNU Tar software or a similar program. If the .tar file contains FITS files, do not use WinZip because it may corrupt the FITS files.
- .tgz
- These files are tape archive format (tar) files that have been compressed by gzip (GNU zip). This type of file is used to simplify storage and downloads of large data sets while preserving the directory structure. Data reviewers and archive users may encounter .tgz files when downloading an entire data directory or a large set of documentation. Tgz files can be opened by using:
- On a Mac, the Archive Utility
- On a Linux machine, GNU Tar software (tar xcvz file.tgz)
- On a Windows machine, a combination of WinGzip software and GNU Win32 BsdTar software to uncompress then unpack the file. If the .tgz file contains FITS files, do not use WinZip because it may corrupt the FITS files.
- .tif
- Tagged Image File Format files are image files that may appear in the document/ directory either as part of a larger document or as stand-alone images. They can be opened using most image manipulation software (like XV, Photoshop, etc.) or a browser.
- .txt
- Typically the .txt extension is used in PDS to indicate small, simple text files that provide information about directory contents. Occasionally they will also appear as labeled ASCII documents in the document/ directory. These files will begin with PDS labels that are general only about a dozen lines long, followed immediately by the explanatory text. They can be read with any standard text editor or a browser.
- .xls
- These are Microsoft Excel (2003 and earlier) Spreadsheet files which may be found in the document/ directory. They may contain tabular data specific to the instrument and data reduction or details of the data acquisition. Typically, they are accompanied by a .tab or .asc version of the file and a PDS label. They can be opened using Microsoft Excel.
- .xml
- IN PDS4 .xml are used as label files that contain unique ID's for the products they are paired with, point to the physical files that contain the data, describe the structure of the data files, document various important aspects of the data, and are a PDS archive requirement. The SBN Wiki contains a useful page on viewing XML files. Do note that although .xml files will largely be label files, it is conceivable that a .xml file could be used in another way within a dataset.
- .xsd
- This is the XML Schema document. It is one of the two schema files referenced in PDS4 labels. The XML Schema defines the structure of the XML documents with classes and attributes. The SBN Wiki contains a useful page on viewing XML files which also applies to .xsd files.
- .zip
- Zip files are compressed files. Data reviewers and archive users may encounter .zip files when downloading an entire data set, data directory or a large set of documentation. Zip files can be unpacked by using Zip software, GNU Zip software, WinZip or a similar program.
- SPICE files
- Spacecraft, Planet, Instrument C-Matrix Events (SPICE) is an information system focused on solar system geometry, time, and related information. The Navigation and Ancillary Information Facility (NAIF) of the PDS has documentation, tools, tutorials, and sub-routines to read SPICE kernels (in C, Fortran, or IDL) for mission SPICE data. When supplied with a data set, SPICE files are in their own directory.