:orphan:

.. _example-gallery:

Example gallery
===============

This gallery of examples shows a variety of relatively small snippets or
examples of tasks that can be done with the Astropy core package.
Contributions from the community are encouraged!

Longer-form tutorials (or tutorials for
`affiliated packages <https://www.astropy.org/affiliated/index.html>`_) belong at
https://learn.astropy.org (and can be submitted at
`the associated github repository <https://github.com/astropy/astropy-tutorials>`_).



.. raw:: html

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


.. raw:: html

    </div>


astropy.coordinates
-------------------

General examples of the `astropy.coordinates` subpackage.



.. raw:: html

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


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="Radial or line-of-sight velocities of sources are often reported in a Heliocentric or Solar-sys...">

.. only:: html

  .. image:: /generated/examples/coordinates/images/thumb/sphx_glr_rv-to-gsr_thumb.png
    :alt:

  :ref:`sphx_glr_generated_examples_coordinates_rv-to-gsr.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Convert a radial velocity to the Galactic Standard of Rest (GSR)</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This example demonstrates coordinate transformations and the creation of visibility curves to a...">

.. only:: html

  .. image:: /generated/examples/coordinates/images/thumb/sphx_glr_plot_obs-planning_thumb.png
    :alt:

  :ref:`sphx_glr_generated_examples_coordinates_plot_obs-planning.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Determining and plotting the altitude/azimuth of a celestial object</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This document shows a few examples of how to use and customize the ~astropy.coordinates.Galacto...">

.. only:: html

  .. image:: /generated/examples/coordinates/images/thumb/sphx_glr_plot_galactocentric-frame_thumb.png
    :alt:

  :ref:`sphx_glr_generated_examples_coordinates_plot_galactocentric-frame.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Transforming positions and velocities to and from a Galactocentric frame</div>
    </div>


.. raw:: html

    <div class="sphx-glr-thumbcontainer" tooltip="This document describes in detail how to subclass and define a custom spherical coordinate fram...">

.. only:: html

  .. image:: /generated/examples/coordinates/images/thumb/sphx_glr_plot_sgr-coordinate-frame_thumb.png
    :alt:

  :ref:`sphx_glr_generated_examples_coordinates_plot_sgr-coordinate-frame.py`

.. raw:: html

      <div class="sphx-glr-thumbnail-title">Create a new coordinate class (for the Sagittarius stream)</div>
    </div>


.. raw:: html

    </div>


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:
   :includehidden:


   /generated/examples/coordinates/index.rst
   /generated/examples/io/index.rst


.. only:: html

  .. container:: sphx-glr-footer sphx-glr-footer-gallery

    .. container:: sphx-glr-download sphx-glr-download-python

      :download:`Download all examples in Python source code: examples_python.zip </generated/examples/examples_python.zip>`

    .. container:: sphx-glr-download sphx-glr-download-jupyter

      :download:`Download all examples in Jupyter notebooks: examples_jupyter.zip </generated/examples/examples_jupyter.zip>`


.. only:: html

 .. rst-class:: sphx-glr-signature

    `Gallery generated by Sphinx-Gallery <https://sphinx-gallery.github.io>`_