Metadata-Version: 2.1
Name: ScopeSim-Templates
Version: 0.4.1
Summary: On-sky source templates for ScopeSim
Home-page: https://github.com/AstarVienna/ScopeSim_Templates
Author: A* Vienna
Author-email: astar.astro@univie.ac.at
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Astronomy
License-File: LICENCE.txt
License-File: LICENSE

ScopeSim Templates
==================


Installation
------------

The best way to install the software is to use ``pip``

.. code-block:: bash

    pip install scopesim_templates

To install the development version you can clone the repository

.. code-block:: bash

   git clone https://github.com/AstarVienna/ScopeSim_Templates
   cd ScopeSim_Templates
   pip install -e .


``Source`` templates included
-----------------------------

Currently, the package covers the most typical sources used in astronomy:

- ``stellar``
   - ``star``: Places a single star on the field
   - ``stars``: Places a list of stars on the field
   - ``star_field``: Creates field of stars with random positions
   - ``star_grid``: Creates a field of stars with regular positions
   - ``cluster``: Creates an age=0 cluster with a user selected mass

- ``extragalactic``
   - ``galaxy``: A simple sersic model with a user selected SED from the ``speXtra`` database
   - ``galaxy3D``: A more complex model that includes a velocity field and velocity dispersion field
   - ``spiral_two_component``: Simple two component model with an outer spiral young SED and an old SED bulge
   - ``elliptical``: Another sersic model using the Brown SEDs

- ``misc``
   - ``point_source``: similar to ``star`` but using any SED from the ``speXtra`` database
   - ``uniform_source``: Creates a uniform source with any SED from ``speXtra``
   - ``source_from_file``: Load the source from a fits file. Depending on the characteristics othe functions may be more suitable
   - ``source_from_imagehdu``: creates a source from an ``ImageHDU`` with an arbitrary flux and scale
   - ``source_from_imagehdu_with_flux``: creates a source from an ``ImageHDU`` where the flux/pixel is known
   - ``source_from_array``: General function to create a source from a 2D ``numpy`` array
   - ``source_from_cube``: Wrapper to create a source from a 3D datacube
  
- ``calibration``
   - ``lamp``: Simulates a calibration lamp, i.e. a homogenous source with emissions lines
   - ``flat_field``: Simulates a flat field
   - ``empty_sky``: To simulate a sky without no other sources

Please see the documentation how to use each particular source and contact us 
(raise an issue or submit a pull request) if more specialized sources are needed.

The ``Source`` object
----------------------

The above functions are created to easy the creation of standard sources but the power of the ``Source`` object
doesn't end there and can be used to create endless sources possibilities. 

In a nutshell a ``Source`` object contains a spacial and spectral description of the sources. The spectral description 
are in the form of ``synphot`` spectra and the spacial description can be an ``astropy`` table referencing the spectra
or a fits image.  ``Source`` can also accept datacubes. The ``speXtra`` package contains an extensive library of 
spectral templates that can be used with the sources. Please check the relevant documentation. 


