ó šßČ[c@`sĀdZddlmZmZmZddlZddlmZddlmZddl m Z d e fd „ƒYZ d e fd „ƒYZd efd„ƒYZd„Zd„Zdd„ZdS(s˜ ``fitsheader`` is a command line script based on astropy.io.fits for printing the header(s) of one or more FITS file(s) to the standard output in a human- readable format. Example uses of fitsheader: 1. Print the header of all the HDUs of a .fits file:: $ fitsheader filename.fits 2. Print the header of the third and fifth HDU extension:: $ fitsheader --extension 3 --extension 5 filename.fits 3. Print the header of a named extension, e.g. select the HDU containing keywords EXTNAME='SCI' and EXTVER='2':: $ fitsheader --extension "SCI,2" filename.fits 4. Print only specific keywords:: $ fitsheader --keyword BITPIX --keyword NAXIS filename.fits 5. Print keywords NAXIS, NAXIS1, NAXIS2, etc using a wildcard:: $ fitsheader --keyword NAXIS* filename.fits 6. Dump the header keywords of all the files in the current directory into a machine-readable csv file:: $ fitsheader --table ascii.csv *.fits > keywords.csv Note that compressed images (HDUs of type :class:`~astropy.io.fits.CompImageHDU`) really have two headers: a real BINTABLE header to describe the compressed data, and a fake IMAGE header representing the image that was compressed. Astropy returns the latter by default. You must supply the ``--compressed`` option if you require the real header that describes the compression. With Astropy installed, please run ``fitsheader --help`` to see the full usage documentation. i(tabsolute_importtdivisiontprint_functionNi(tfitsi(tlog(trangetExtensionNotFoundExceptioncB`seZdZRS(s@Raised if an HDU extension requested by the user does not exist.(t__name__t __module__t__doc__(((sAlib/python2.7/site-packages/astropy/io/fits/scripts/fitsheader.pyR6stHeaderFormattercB`s;eZdZd„Zdded„Zd„Zd„ZRS(sĒClass to format the header(s) of a FITS file for display by the `fitsheader` tool; essentially a wrapper around a `HDUList` object. Example usage: fmt = HeaderFormatter('/path/to/file.fits') print(fmt.parse(extensions=[0, 3], keywords=['NAXIS', 'BITPIX'])) Parameters ---------- filename : str Path to a single FITS file. Raises ------ IOError If `filename` does not exist or cannot be read. cC`s||_tj|ƒ|_dS(N(tfilenameRtopent_hdulist(tselfR ((sAlib/python2.7/site-packages/astropy/io/fits/scripts/fitsheader.pyt__init__Ms c C`sć|dkr$tt|jƒƒ}n¬g}x£|D]›}y|jt|ƒƒWq1tk rĖ|jdƒ}t|ƒdkr»dj|dd!ƒ}t|dƒ}|j||fƒqĢ|j|ƒq1Xq1W|j |||ƒS(sŃReturns the FITS file header(s) in a readable format. Parameters ---------- extensions : list of int or str, optional Format only specific HDU(s), identified by number or name. The name can be composed of the "EXTNAME" or "EXTNAME,EXTVER" keywords. keywords : list of str, optional Keywords for which the value(s) should be returned. If not specified, then the entire header is returned. compressed : boolean, optional If True, shows the header describing the compression, rather than the header obtained after decompression. (Affects FITS files containing `CompImageHDU` extensions only.) Returns ------- formatted_header : str or astropy.table.Table Traditional 80-char wide format in the case of `HeaderFormatter`; an Astropy Table object in the case of `TableHeaderFormatter`. t,iii’’’’N( tNoneRtlenR tappendtintt ValueErrortsplittjoint_parse_internal( Rt extensionstkeywordst compressedthdukeystexttpartstextnametextver((sAlib/python2.7/site-packages/astropy/io/fits/scripts/fitsheader.pytparseQs   c C`sæg}x©t|ƒD]›\}}y|j|||ƒ}Wntk rNqnX|dkrk|jdƒn|jdj||jƒƒx$|D]}|jdj|ƒƒqŽWqWdj|ƒS(sNThe meat of the formatting; in a separate method to allow overriding. is s# HDU {} in {}: s{} t(t enumeratet _get_cardsRRtformatR R( RRRRtresulttidxthdutcardstc((sAlib/python2.7/site-packages/astropy/io/fits/scripts/fitsheader.pyR€s   c C`s#y-|r|j|j}n|j|j}WnEttfk rtdj|j|ƒ}tj|ƒt |ƒ‚nX|s‡|j }n˜g}x|D]‡}yC|j |}t |t j jƒrĻ|j|ƒn |j|ƒWq”tk r} tjdjd|jd|d|ƒƒq”Xq”W|S(sŖReturns a list of `astropy.io.fits.card.Card` objects. This function will return the desired header cards, taking into account the user's preference to see the compressed or uncompressed version. Parameters ---------- hdukey : int or str Key of a single HDU in the HDUList. keywords : list of str, optional Keywords for which the cards should be returned. compressed : boolean, optional If True, shows the header describing the compression. Raises ------ ExtensionNotFoundException If the hdukey does not correspond to an extension. s{0}: Extension {1} not found.s2{filename} (HDU {hdukey}): Keyword {kw} not found.R thdukeytkw(R t_headertheadert IndexErrortKeyErrorR%R RtwarningRR)t isinstanceRtcardtCardRtextend( RR+RRR.tmessageR)R,tcrdte((sAlib/python2.7/site-packages/astropy/io/fits/scripts/fitsheader.pyR$‘s0       N( RRR RRtFalseR!RR$(((sAlib/python2.7/site-packages/astropy/io/fits/scripts/fitsheader.pyR ;s  / tTableHeaderFormattercB`seZdZd„ZRS(sClass to convert the header(s) of a FITS file into a Table object. The table returned by the `parse` method will contain four columns: filename, hdu, keyword, and value. Subclassed from HeaderFormatter, which contains the meat of the formatting. cC`s®g}x~|D]v}y\xU|j|||ƒD]>}|ji|jd6|d6|jd6t|jƒd6ƒq,WWq tk r‚q Xq W|rŖddlm}|j |ƒSdS(s6Method called by the parse method in the parent class.R R(tkeywordtvaluei(ttableN( R$RR R;tstrR<RR"R=tTableR(RRRRt tablerowsR(R3R=((sAlib/python2.7/site-packages/astropy/io/fits/scripts/fitsheader.pyRŃs    (RRR R(((sAlib/python2.7/site-packages/astropy/io/fits/scripts/fitsheader.pyR:ŹscC`s„xžt|jƒD]\}}|dkr<|j r<tƒny8t|ƒ}t|j|j|j|jƒddƒWqtk rœ}t j t |ƒƒqXqWdS(s¾Prints FITS header(s) using the traditional 80-char format. Parameters ---------- args : argparse.Namespace Arguments passed from the command-line as defined below. itendR"N( R#R RtprintR R!RRtIOErrorRterrorR>(targsR'R t formatterR8((sAlib/python2.7/site-packages/astropy/io/fits/scripts/fitsheader.pytprint_headers_traditionaläs  cC`sųg}x~|jD]s}yDt|ƒ}|j|j|j|jƒ}|rY|j|ƒnWqtk r‚}tj t |ƒƒqXqWt |ƒdkrt St |ƒdkr¼|d}nddl m}|j|ƒ}|jtjd|jƒdS(s¼Prints FITS header(s) in a machine-readable table format. Parameters ---------- args : argparse.Namespace Arguments passed from the command-line as defined below. iii(R=R%N(R R:R!RRRRRCRRDR>RR9R"R=tvstacktwritetsyststdout(REttablesR RFttblR8tresulting_tableR=((sAlib/python2.7/site-packages/astropy/io/fits/scripts/fitsheader.pytprint_headers_as_tableųs$    c C`s3ddl}|jddƒ}|jddddd d d d d dƒ|jddddd d d dd dƒ|jdddddtddd dƒ|jddd dd dƒ|jddd d d!ƒ|j|ƒ}|jdkrõd"|_ny$|jrt|ƒn t|ƒWnt k r.}nXdS(#s<This is the main function called by the `fitsheader` script.iNt descriptionsßPrint the header(s) of a FITS file. Optional arguments allow the desired extension(s), keyword(s), and output format to be specified. Note that in the case of a compressed image, the decompressed header is shown by default.s-es --extensiontmetavartHDUtactionRtdestRthelpsdspecify the extension by name or number; this argument can be repeated to select multiple extensionss-ks --keywordtKEYWORDRsespecify a keyword; this argument can be repeated to select multiple keywords; also supports wildcardss-ts--tabletnargst?tdefaulttFORMATsžprint the header(s) in machine-readable table format; the default format is "ascii.fixed_width" (can be "ascii.csv", "ascii.html", "ascii.latex", "fits", etc)s-cs --compressedt store_truesdfor compressed image data, show the true header which describes the compression rather than the dataR t+s2path to one or more files; wildcards are supportedsascii.fixed_width( targparsetArgumentParsert add_argumentR9t parse_argsR=RRORGRC(RER]tparserR8((sAlib/python2.7/site-packages/astropy/io/fits/scripts/fitsheader.pytmains2        (R t __future__RRRRJR"RRtextern.six.movesRt ExceptionRtobjectR R:RGRORRb(((sAlib/python2.7/site-packages/astropy/io/fits/scripts/fitsheader.pyt,s 