semvec/pypi-packages huggingface dataset:
hcam-finder 1.3.10
Observation planning and finding charts for HiPerCAM
License: MIT license
Keywords: hcam_finder

===============================
hcam-finder
===============================


.. image:: https://img.shields.io/pypi/v/hcam_finder.svg
        :target: https://pypi.python.org/pypi/hcam_finder

.. image:: https://img.shields.io/travis/StuartLittlefair/hcam_finder.svg
        :target: https://travis-ci.org/StuartLittlefair/hcam_finder

.. image:: https://readthedocs.org/projects/hcam-finder/badge/?version=latest
        :target: https://hcam-finder.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

.. image:: https://pyup.io/repos/github/StuartLittlefair/hcam_finder/shield.svg
     :target: https://pyup.io/repos/github/StuartLittlefair/hcam_finder/
     :alt: Updates


Observation planning and finding charts for HiPERCAM, ULTRACAM and ULTRASPEC

The ``hcam_finder`` package provides Python scripts ``hfinder``, ``ufinder`` and ``usfinder``
for observation planning with HiPERCAM on the WHT and GTC, ULTRACAM on the NTT and
ULTRASPEC on the TNT, respectively.

These tools allow you to generate finding charts as well as specify the instrument setup
you require, whilst providing an estimate of observing cadence, exposure time and
S/N estimates.

.. Note::

        Creating a finding chart and instrument setup for the above instruments are more
        tightly connected than is usually the case with CCD imagers. To avoid errors in
        phase II setups, you **must** use the tools above to generate finding charts. By 
        doing so, and reading the instrument-specific documentation below, you will avoid
        the non-optimal phase II setups that arise from a lack of awareness of the peculiarities
        of imagers designed for high time resolution.

``hcam_finder`` is written in Python and is based on TKinter. It should be compatible
with Python2 and Python3.

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

The software is written as much as possible to make use of core Python
components. It requires my own `hcam_widgets <https://github.com/HiPERCAM/hcam_widgets>`_ module.
It also relies on the third party libraries `astropy <http://astropy.org/>`_ for astronomical
calculations and catalog lookup, as well as `ginga <https://ginga.readthedocs.io/en/latest/>`_ for
image display. Optionally, you can also use `astroquery <https://astroquery.readthedocs.io>`_ to expand
the range of surveys one can download images from.

Installing using ``pip`` should take care of these dependencies. Simply install with::

 pip install hcam_finder

or if you don't have root access::

 sudo pip install hcam_finder

or::

 pip install --user hcam_finder

* Free software: MIT license
* Documentation: https://hcam-finder.readthedocs.io.





=======
History
=======

0.1.0 (2017-02-11)
------------------

* First release on PyPI.
hcam-widgets 1.2.2
Common Tkinter widgets for HiPerCAM
License: MIT license
Requires Python: >=3.6
Keywords: hcam_widgets

===============================
hcam-widgets
===============================


.. image:: https://img.shields.io/pypi/v/hcam_widgets.svg
        :target: https://pypi.python.org/pypi/hcam_widgets

.. image:: https://img.shields.io/travis/StuartLittlefair/hcam_widgets.svg
        :target: https://travis-ci.org/StuartLittlefair/hcam_widgets

.. image:: https://readthedocs.org/projects/hcam-widgets/badge/?version=latest
        :target: https://hcam-widgets.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

.. image:: https://pyup.io/repos/github/StuartLittlefair/hcam_widgets/shield.svg
     :target: https://pyup.io/repos/github/StuartLittlefair/hcam_widgets/
     :alt: Updates


Tkinter Widgets for HiPerCAM tools

``hcam_widgets`` provides a set of TKinter widgets and utility functions for writing tools to
plan and carry out HiPERCAM observations. The idea is to create a lightweight and easily-installed
collection of common widgets. It is compatible with Python2 and Python3.

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

The software is written as much as possible to make use of core Python components. It relies
on the third party library `astropy <http://astropy.org/>`_ for astronomical calculations.

Once you have installed astropy, install with the usual::

 pip install .

or if you don't have root access::

 pip install --user .

Optional package dependencies
-----------------------------

``hcam_widgets`` supports several other tools, such as the finding chart tool ``hfinder`` and the
instrument control GUI ``hdriver``. Most users will need no extra modules installed. However,
If you want to be able to run ``hdriver``, *and* you want full communication with the telescope
whilst running at the GTC, you need to install the CORBA implementation ``omniORBpy``.

Full install instructions are found at the omniORB project `homepage <http://omniorb.sourceforge.net/>`_.
Be sure to install both omniORB and omniORBpy. Also, the omniORBpy module and the lib64 variant must
both be in the ``PYTHONPATH``. Finally, communicating with the GTC requires the installation of
Interface Definition Language (IDL) files, and the python modules compiled from them. Contact S. Littlefair
for these files, which must also be in the ``PYTHONPATH``.

* Free software: MIT license





=======
History
=======

0.1.0 (2017-02-11)
------------------

* First release on PyPI.