Supported Image File Formats
================================================================================

CCP4
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Format used by the ccp4 software package

* Recognized file extensions: *ccp4, map*  
* Recognized based on content: *yes*
* File import: *yes*
* File export: *yes*

.. class:: ost.io.CCP4(normalize_on_save=false, endianess_on_save=OST_LOCAL_ENDIAN)
 
  :param normalize_on_save: Determines wether to renormalize image upon saving.
  :type  normalize_on_save: bool
  :param endianess_on_save: Byte order for saving.
  :type  endianess_on_save: ost.io.Endianess


DAT
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Simple binary format for square images

* Recognized file extensions: *dat, img*  
* Recognized based on content: *no*
* File import: *yes*
* File export: *yes*

.. class:: ost.io.DAT(normalize_on_save=false, format=OST_DEFAULT_FORMAT, signed=false, endianess=OST_LOCAL_ENDIAN)
 
  :param normalize_on_save: Determines wether to renormalize image upon saving.
  :type  normalize_on_save: bool
  :param format: Data format for loading and saving.
  :type  format: ost.io.Format
  :param signed: Determines wether data is interpreted as signed or unsigned values during loading and saving.
  :type  signed: bool
  :param endianess: Byte order for loading and saving.
  :type  endianess: ost.io.Endianess

DF3
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

PovRay Density file format

* Recognized file extensions: *df3*  
* Recognized based on content: *no*
* File import: *no*
* File export: *yes*

.. class:: ost.io.DF3(normalize_on_save=false)
 
  :param normalize_on_save: Determines wether to renormalize image upon saving.
  :type  normalize_on_save: bool


DM3
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Format used by Gatan Inc.'s  Digital Micrograph software

* Recognized file extensions: *dm3*  
* Recognized based on content: *yes*
* File import: *yes*
* File export: *no*

.. class:: ost.io.DM3( )

DX
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Format used by the OpenDX software package

* Recognized file extensions: *dx*  
* Recognized based on content: *no*
* File import: *yes*
* File export: *yes*

.. class:: ost.io.DX(normalize_on_save=false)
 
  :param normalize_on_save: Determines wether to renormalize image upon saving.
  :type  normalize_on_save: bool


IPL
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Ditabis Micron Image Plate Scanner Format

* Recognized file extensions: *ipl*  
* Recognized based on content: *yes*
* File import: *yes*
* File export: *yes*

.. class:: ost.io.IPL(normalize_on_save=false, format=OST_DEFAULT_FORMAT)
 
  :param normalize_on_save: Determines wether to renormalize image upon saving.
  :type  normalize_on_save: bool
  :param format: Data format for loading and saving.
  :type  format: ost.io.Format

JPK
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Format used by JPK Instruments AG's software (Customized Tiff format)

* Recognized file extensions: *jpk*  
* Recognized based on content: *no (jpk files without file extension are recognized as tif)*
* File import: *yes*
* File export: *yes*



.. class:: ost.io.JPK(normalize_on_save=indeterminate, format=OST_DEFAULT_FORMAT, signed=false, phasecolor=false, subimage=-1)
 
  :param normalize_on_save: Determines wether to renormalize image upon saving.
  :type  normalize_on_save: tribool
  :param format: Data format for loading and saving.
  :type  format: ost.io.Format
  :param signed: Determines wether data is interpreted as signed or unsigned values during loading and saving.
  :type  signed: bool
  :param phasecolor: Determines wether the phases of complex values are encoded as color information.
  :type  phasecolor: bool
  :param subimage: Determines which subimage is read from a multi-image jpk (-1 = default image).
  :type  subimage: int

MRC
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Format used by the MRC software package

* Recognized file extensions: *mrc*  
* Recognized based on content: *yes*
* File import: *yes*
* File export: *yes*

.. class:: ost.io.MRC(normalize_on_save=false, subformat=MRC_NEW_FORMAT, endianess_on_save=OST_LOCAL_ENDIAN)
 
  :param normalize_on_save: Determines wether to renormalize image upon saving.
  :type  normalize_on_save: bool
  :param subformat: Determines wether old style or new style mrc files should be saved.
  :type  subformat: ost.io.Subformat
  :param endianess_on_save: Byte order for saving.
  :type  endianess_on_save: ost.io.Endianess
  
.. py:class:: ost.io.Subformat

   .. py:attribute:: MRC_AUTO_FORMAT
   .. py:attribute:: MRC_OLD_FORMAT
   .. py:attribute:: MRC_NEW_FORMAT

Nanoscope
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Format used by software from Veeco

* Recognized file extensions: *mod*  
* Recognized based on content: *no*
* File import: *yes*
* File export: *yes*

.. class:: ost.io.Nanoscope(subimage=-1)
 
  :param subimage: Determines which subimage is read from a multi-image nanoscope file (-1 = default image).
  :type  subimage: int


PNG
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Portable Network Graphic image format

* Recognized file extensions: *png*  
* Recognized based on content: *yes*
* File import: *yes*
* File export: *yes*

.. class:: ost.io.PNG(normalize_on_save=false)
 
  :param normalize_on_save: Determines wether to renormalize image upon saving.
  :type  normalize_on_save: bool

Situs
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Format used by the Situs software package

* Recognized file extensions: *situs, sit*  
* Recognized based on content: *no*
* File import: *yes*
* File export: *yes*

.. class:: ost.io.Situs(normalize_on_save=false)
 
  :param normalize_on_save: Determines wether to renormalize image upon saving.
  :type  normalize_on_save: bool

Spider
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Format used by the Spider software package

* Recognized file extensions: *spi*  
* Recognized based on content: *no*
* File import: *yes*
* File export: *yes*

.. class:: ost.io.Spider(normalize_on_save=false, endianess_on_save=OST_LOCAL_ENDIAN)
 
  :param normalize_on_save: Determines wether to renormalize image upon saving.
  :type  normalize_on_save: bool
  :param endianess_on_save: Byte order for saving.
  :type  endianess_on_save: ost.io.Endianess

TIF
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Tagged Image File Format

* Recognized file extensions: *tif, tiff*  
* Recognized based on content: *yes*
* File import: *yes*
* File export: *yes*

.. class:: ost.io.TIF(normalize_on_save=indeterminate, format=OST_DEFAULT_FORMAT, signed=false, phasecolor=false, subimage=-1)
 
  :param normalize_on_save: Determines wether to renormalize image upon saving.
  :type  normalize_on_save: tribool
  :param format: Data format for loading and saving.
  :type  format: ost.io.Format
  :param signed: Determines wether data is interpreted as signed or unsigned values during loading and saving.
  :type  signed: bool
  :param phasecolor: Determines wether the phases of complex values are encoded as color information.
  :type  phasecolor: bool
  :param subimage: Determines which subimage is read from a multi-image tif (-1 = default image).
  :type  subimage: int

Common parameters
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. py:class:: ost.io.Endianess

   .. py:attribute:: OST_BIG_ENDIAN
   .. py:attribute:: OST_LITTLE_ENDIAN
   .. py:attribute:: OST_VAX_DATA
   .. py:attribute:: OST_LOCAL_ENDIAN

.. py:class:: ost.io.Format

   .. py:attribute:: OST_BIT8_FORMAT
   .. py:attribute:: OST_BIT16_FORMAT
   .. py:attribute:: OST_BIT32_FORMAT
   .. py:attribute:: OST_FLOAT_FORMAT
   .. py:attribute:: OST_DOUBLE_FORMAT
   .. py:attribute:: OST_DEFAULT_FORMAT