.. _sphx_glr_generated_examples_io:

.. _example-gallery-io:

astropy.io
----------

General examples of the ``astropy.io`` subpackages.



.. raw:: html

    <div class="sphx-glr-thumbnails">


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates how to create a multi-extension FITS (MEF) file from scratch using as...">

.. only:: html

  .. image:: /generated/examples/io/images/thumb/sphx_glr_create-mef_thumb.png
    :alt:

  :ref:`sphx_glr_generated_examples_io_create-mef.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Create a multi-extension FITS (MEF) file from scratch</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="FITS files can often contain large amount of multi-dimensional data and tables. This example op...">

.. only:: html

  .. image:: /generated/examples/io/images/thumb/sphx_glr_fits-tables_thumb.png
    :alt:

  :ref:`sphx_glr_generated_examples_io_fits-tables.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Accessing data stored as a table in a multi-extension FITS (MEF) file</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example opens an image stored in a FITS file and displays it to the screen.">

.. only:: html

  .. image:: /generated/examples/io/images/thumb/sphx_glr_plot_fits-image_thumb.png
    :alt:

  :ref:`sphx_glr_generated_examples_io_plot_fits-image.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Read and plot an image from a FITS file</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example describes how to edit a value in a FITS header using astropy.io.fits.">

.. only:: html

  .. image:: /generated/examples/io/images/thumb/sphx_glr_modify-fits-header_thumb.png
    :alt:

  :ref:`sphx_glr_generated_examples_io_modify-fits-header.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Edit a FITS header</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates how to create a large file (larger than will fit in memory) from scra...">

.. only:: html

  .. image:: /generated/examples/io/images/thumb/sphx_glr_skip_create-large-fits_thumb.png
    :alt:

  :ref:`sphx_glr_generated_examples_io_skip_create-large-fits.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Create a very large FITS file from scratch</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example opens an RGB JPEG image and writes out each channel as a separate FITS (image) fil...">

.. only:: html

  .. image:: /generated/examples/io/images/thumb/sphx_glr_split-jpeg-to-fits_thumb.png
    :alt:

  :ref:`sphx_glr_generated_examples_io_split-jpeg-to-fits.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Convert a 3-color image (JPG) to separate FITS images</div>
    </div>


.. raw:: html

    </div>


.. toctree::
   :hidden:

   /generated/examples/io/create-mef
   /generated/examples/io/fits-tables
   /generated/examples/io/plot_fits-image
   /generated/examples/io/modify-fits-header
   /generated/examples/io/skip_create-large-fits
   /generated/examples/io/split-jpeg-to-fits