UnifiedFitsTableWriter instead@Deprecated public class FitsPlusTableWriter extends VOTableFitsTableWriter implements DocumentedIOHandler
FitsTableWriter however, the
primary extension is not left contentless, instead it gets the
text of a DATA-less VOTable written into it. This VOTable describes
the metadata of the table, as if the DATA element contained a FITS
element referencing the first extension HDU of the file.
Tables stored in this format have all the rich metadata associated
with VOTables, and benefit from the compactness of FITS tables,
without the considerable disdvantage of being split into two files.
The header cards in the primary HDU look like this:
SIMPLE = T / Standard FITS format
BITPIX = 8 / Character data
NAXIS = 1 / Text string
NAXIS1 = nnnn / Number of characters
VOTMETA = T / Table metadata in VOTABLE format
EXTEND = T / There are standard extensions
the VOTMETA card in particular marking that this HDU contains VOTable
metadata.| Constructor and Description |
|---|
FitsPlusTableWriter()
Deprecated.
Default constructor.
|
FitsPlusTableWriter(String name,
WideFits wide)
Deprecated.
allows some configuration options but not others;
use no-arg constructor and configuration methods instead
|
| Modifier and Type | Method and Description |
|---|---|
protected FitsTableSerializer |
createSerializer(StarTable table)
Deprecated.
Provides a suitable serializer for a given table.
|
boolean |
docIncludesExample()
Deprecated.
Indicates whether the serialization of some (short) example table
should be added to the user documentation for this handler.
|
protected CardImage[] |
getCustomPrimaryHeaderCards()
Deprecated.
Returns implementation-specific header cards to be added
to the Primary HDU of FITS files written by this writer.
|
String[] |
getExtensions()
Deprecated.
Returns the list of filename extensions recognised by this handler.
|
String |
getXmlDescription()
Deprecated.
Returns user-directed documentation in XML format.
|
protected boolean |
isMagic(int icard,
String key,
Object value)
Deprecated.
Tests a header card to see if it looks like part of the magic number
for the format written by this handler.
|
boolean |
looksLikeFile(String location)
Deprecated.
Indicates whether the destination is of a familiar form for this
kind of writer.
|
isMagic, setAllowSignedByte, setVotableVersion, writeStarTablesgetAllowSignedByte, getAllowZeroLengthString, getConfig, getCurrentDate, getFormatName, getMetadataCards, getMimeType, getPadCharacter, getWide, getWriteDate, setAllowZeroLengthString, setFormatName, setPadCharacter, setWide, setWriteDate, writePrimaryHDU, writeStarTable, writeStarTables, writeTableHDUwriteStarTable, writeStarTableclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitmatchesExtension, readText, toLinkwriteStarTablepublic FitsPlusTableWriter()
@Deprecated public FitsPlusTableWriter(String name, WideFits wide)
public String[] getExtensions()
DocumentedIOHandlergetExtensions in interface DocumentedIOHandlerpublic boolean looksLikeFile(String location)
StarTableWritertrue for values of location which look like
the normal form for their output format, for instance one with
the usual file extension.looksLikeFile in interface StarTableWriterlocation - the location name (probably filename)true iff it looks like a file this writer would
normally writepublic boolean docIncludesExample()
DocumentedIOHandlerDocumented.getXmlDescription()
method already includes some example output, should return false.docIncludesExample in interface DocumentedIOHandlerpublic String getXmlDescription()
DocumentedThe output should be a sequence of one or more <P> elements, using XHTML-like XML. Since rendering may be done in a number of contexts however, use of the full range of XHTML elements is discouraged. Where possible, the content should stick to simple markup such as the elements P, A, UL, OL, LI, DL, DT, DD EM, STRONG, I, B, CODE, TT, PRE.
getXmlDescription in interface Documentedprotected CardImage[] getCustomPrimaryHeaderCards()
VOTableFitsTableWritergetCustomPrimaryHeaderCards in class VOTableFitsTableWriterprotected boolean isMagic(int icard,
String key,
Object value)
VOTableFitsTableWriterVOTableFitsTableWriter implementation tests that
the first four cards read:
SIMPLE = T
BITPIX = 8
NAXIS = 1
NAXIS1 = ???
Subclasses may override this to add tests for later cards
(as provided by VOTableFitsTableWriter.getCustomPrimaryHeaderCards()).isMagic in class VOTableFitsTableWritericard - 0-based card indexkey - card namevalue - card valueprotected FitsTableSerializer createSerializer(StarTable table) throws IOException
AbstractFitsTableWritercreateSerializer in class AbstractFitsTableWritertable - table to serializeIOException - if the table can't be writtenCopyright © 2024 Central Laboratory of the Research Councils. All Rights Reserved.