Ginga Documentation

Ginga Documentation

Release 2.5.20160420043855 Eric Jeschke

May 05, 2016

Contents

1 About Ginga

1

2 Copyright and License

3

3 Requirements and Supported Platforms

5

4 Getting the source

7

5 Building and Installation

9

5.1 Detailed Installation Instructions for Ginga . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

6 Documentation

15

6.1 What's New in Ginga? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

6.2 Ginga Quick Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

6.3 The Ginga FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

6.4 The Ginga Viewer and Toolkit Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

6.5 Reference/API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

7 Bug reports

107

8 Developer Info

109

9 Etymology

111

10 Pronunciation

113

11 Indices and tables

115

Python Module Index

117

i

ii

CHAPTER 1

About Ginga

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 class 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.

1

Ginga Documentation, Release 2.5.20160420043855

2

Chapter 1. About Ginga

CHAPTER 2 Copyright and License

Copyright (c) 2011-2015 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.

3

Ginga Documentation, Release 2.5.20160420043855

4

Chapter 2. Copyright and License

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download