The Ginga astronomical FITS file viewer
Clone or download
Latest commit f532b5c Jan 20, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
astropy_helpers @ 9f82aac Updated astropy-helpers to v3.1 Dec 14, 2018
doc
experimental MNT: Remove PY2 support Nov 13, 2018
ginga Add buttons to Toolbar plugin Jan 18, 2019
licenses Updates to put license back in root of repository Mar 30, 2017
mkapp
.gitignore
.gitmodules
.travis.yml MNT: Remove PY2 support Nov 13, 2018
CHANGES.rst
CITATION
CODE_OF_CONDUCT.md DOC: Add code of conduct [skip ci] Sep 7, 2018
LICENSE.rst Update copyright notice for dates Jan 25, 2018
LICENSE.txt Update copyright notice for dates Jan 25, 2018
MANIFEST.in Merge pull request #717 from pllim/add-citation Nov 15, 2018
README.txt
ROADMAP.rst MNT: Remove PY2 support Nov 13, 2018
ah_bootstrap.py
appveyor.yml
ginga.desktop
setup.cfg MNT: Remove PY2 support Nov 13, 2018
setup.py MNT: Remove PY2 support Nov 13, 2018

README.txt

GINGA ABOUT
-----------
Ginga is a toolkit designed for building viewers for scientific image
data in Python, visualizing 2D pixel data in numpy arrays.
It can view astronomical data such as contained in files based on the
FITS (Flexible Image Transport System) file format.  It is written and
is maintained by software engineers at the Subaru Telescope, National
Astronomical Observatory of Japan.

The Ginga toolkit centers around an image display object which supports
zooming and panning, color and intensity mapping, a choice of several
automatic cut levels algorithms and canvases for plotting scalable
geometric forms.  In addition to this widget, a general purpose
"reference" FITS viewer is provided, based on a plugin framework.
A fairly complete set of standard plugins are provided for features
that we expect from a modern FITS viewer: panning and zooming windows,
star catalog access, cuts, star pick/fwhm, thumbnails, etc.

COPYRIGHT AND LICENSE
---------------------
Copyright (c) 2011-2018  Eric R. Jeschke.  All rights reserved.
Ginga is distributed under an open-source BSD licence.  Please see the
file LICENSE.txt in the top-level directory for details.

BUILDING AND INSTALLATION
-------------------------
Ginga uses a standard distutils based install, e.g.

    $ python setup.py build

or

    $ python setup.py install

The program can then be run using the command "ginga"

For further information please see the detailed installation
instructions in the documentation.

DOCUMENTATION
-------------
It is online at
http://ginga.readthedocs.io/en/latest/index.html

CODE OF CONDUCT
---------------
See CODE_OF_CONDUCT.md

DEVELOPERS
----------
See examples/*/example{1,2}_*.py .
There is more information for developers in the manual.

ON THE WEB
----------
http://ejeschke.github.com/ginga

ETYMOLOGY
---------
"Ginga" is the romanized spelling of the Japanese word "銀河"
(hiragana: ぎんが), meaning "galaxy" (in general) and, more familiarly,
the Milky Way.  This viewer was written by software engineers at Subaru
Telescope, National Astronomical Observatory of Japan--thus the
connection.

Pronunciation
-------------
Ginga the viewer may be pronounced "ging-ga" (proper japanese) or
"jing-ga" (perhaps easier for western tongues). The latter pronunciation
has meaning in the Brazilian dance/martial art capoeira: a fundamental
rocking or back and forth swinging motion.  Pronounciation as "jin-ja"
is considered poor form.