healpy.fitsfunc.write_map¶
- healpy.fitsfunc.write_map(filename, m, nest=False, dtype=None, fits_IDL=True, coord=None, partial=False, column_names=None, column_units=None, extra_header=(), overwrite=False)¶
Writes a healpix map into a healpix FITS file.
Starting from healpy 1.15.0, if you do not specify dtype, the map will be written to disk with the same precision it is stored in memory. Previously, by default healpy wrote maps in float32. To reproduce the same behaviour of healpy 1.14.0 and below, set dtype=np.float32.
- Parameters:
- filenamestr
the fits file name
- marray or sequence of 3 arrays
the map to write. Possibly a sequence of 3 maps of same size. They will be considered as I, Q, U maps. Supports masked maps, see the ma function.
- nestbool, optional
If True, ordering scheme is assumed to be NESTED, otherwise, RING. Default: RING. The map ordering is not modified by this function, the input map array should already be in the desired ordering (run ud_grade beforehand).
- fits_IDLbool, optional
If True, reshapes columns in rows of 1024, otherwise all the data will go in one column. Default: True
- coordstr
The coordinate system, typically ‘E’ for Ecliptic, ‘G’ for Galactic or ‘C’ for Celestial (equatorial)
- partialbool, optional
If True, fits file is written as a partial-sky file with explicit indexing. Otherwise, implicit indexing is used. Default: False.
- column_namesstr or list
Column name or list of column names, if None here the default column names based on the number of columns: 1 : “TEMPERATURE”, 2 : [“Q_POLARISATION”, “U_POLARISATION”], 3 : [“TEMPERATURE”, “Q_POLARISATION”, “U_POLARISATION”], 6 : [“II”, “IQ”, “IU”, “QQ”, “QU”, “UU”] COLUMN_1, COLUMN_2… otherwise (FITS is 1-based)
- column_unitsstr or list
Units for each column, or same units for all columns.
- extra_headerlist
Extra records to add to FITS header.
- dtype: np.dtype or list of np.dtypes, optional
The datatype in which the columns will be stored. Will be converted internally from the numpy datatype to the fits convention. If a list, the length must correspond to the number of map arrays. Default: use the data type of the input array(s) .. note:: this changed in 1.15.0, previous versions saved in float32 by default
- overwritebool, optional
If True, existing file is silently overwritten. Otherwise trying to write an existing file raises an OSError (IOError for Python 2).