ginga

The Ginga astronomical FITS file viewer

https://github.com/ejeschke/ginga

Science Score: 54.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    15 of 43 committers (34.9%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (18.0%) to scientific vocabulary

Keywords from Contributors

astropy astronomy astrophysics jwst astropy-affiliated asdf advanced-scientific-data-format closember source-detection photometry
Last synced: 6 months ago · JSON representation ·

Repository

The Ginga astronomical FITS file viewer

Basic Info
  • Host: GitHub
  • Owner: ejeschke
  • License: bsd-3-clause
  • Language: Python
  • Default Branch: main
  • Size: 82.7 MB
Statistics
  • Stars: 124
  • Watchers: 9
  • Forks: 78
  • Open Issues: 99
  • Releases: 28
Created over 13 years ago · Last pushed 6 months ago
Metadata Files
Readme Changelog License Code of conduct Citation Roadmap

README.md

GINGA

Ginga Logo

Powered by Astropy Badge Documentation Status Github Actions CI Status

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 National Astronomical Observatory of Japan (NAOJ), the Space Telescope Science Institute (STScI), and other contributing entities.

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-2025 Ginga Maintainers. 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

The current release of Ginga can be downloaded and installed from pip using:

$ pip install ginga

From source code, you should also use pip, e.g.:

$ cd ginga
$ pip install -e .

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/ (dev) and http://ginga.readthedocs.io/en/stable/ (latest release).

CODE OF CONDUCT

See CODE_OF_CONDUCT.md.

FOR 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 originally 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. Pronunciation as "jin-ja" is considered poor form.

Owner

  • Login: ejeschke
  • Kind: user

Citation (CITATION)

To reference Ginga in publications, please cite:

@inproceedings{Jeschke15A,
        author = {{Jeschke}, E. and {Inagaki}, T. and {Kackley}, R.},
        title  = "Enhancements to {Ginga}: a {Python} Package for Building Astronomical Data Viewers",
        booktitle = "Astronomical Data Analysis Software and Systems XXIV",
        year   = 2015,
        editor = {{Taylor}, A.~R. and {Rosolowsky}, E.},
        publisher = "ASP",
        note   = "Vol. 495" }


Other Related Publications
==========================

ASCL ID: 1303.020

Zenodo: https://zenodo.org/badge/latestdoi/4758330

@inproceedings{Lim19A,
        author = "P. L. Lim and E. Jeschke",
        title  = "stginga: Ginga Plugins for Data Analysis and Quality Assurance of HST and JWST Science Data",
        booktitle = "Astronomical Data Analysis Software and Systems XXVIII",
        editor = "P. J. Teuben and M. W. Pound and B. A. Thomas and E. M. Warner",
        year   = "2019",
        publisher = "ASP",
        note   = "Vol. 523" }

@inproceedings{Jeschke13B,
        author = "E. Jeschke",
        title  = "Ginga: an open-source astronomical image viewer and toolkit",
        booktitle = "Proceedings of the 12th Python in Science Conference",
        year   = "2013",
        editor = "van der Walt, S. and Millman, J. and Huff, K.",
        publisher = "SciPy" }

@inproceedings{Jeschke13A,
        author = "E. Jeschke",
        title  = "Introducing the Ginga FITS Viewer and Toolkit",
        booktitle = "ADASS XXII, ASP Conference Series",
        year   = "2013",
        publisher = "ASP" }

@inproceedings{Jeschke12,
        author = "E. Jeschke and T. Inagaki and R. Kackley",
        title  = "A next-generation open-source toolkit for FITS file image viewing",
        booktitle = "Software and Cyberinfrastructure for Astronomy II",

        year   = "2012",
        editor = "N. Radziwill and G. Chiozzi",
        publisher = "SPIE",
        note   = "Vol. 8451" }

GitHub Events

Total
  • Create event: 8
  • Issues event: 22
  • Release event: 3
  • Watch event: 5
  • Delete event: 6
  • Issue comment event: 34
  • Push event: 48
  • Pull request review event: 7
  • Pull request event: 19
Last Year
  • Create event: 8
  • Issues event: 22
  • Release event: 3
  • Watch event: 5
  • Delete event: 6
  • Issue comment event: 34
  • Push event: 48
  • Pull request review event: 7
  • Pull request event: 19

Committers

Last synced: 10 months ago

All Time
  • Total Commits: 2,479
  • Total Committers: 43
  • Avg Commits per committer: 57.651
  • Development Distribution Score (DDS): 0.284
Past Year
  • Commits: 65
  • Committers: 4
  • Avg Commits per committer: 16.25
  • Development Distribution Score (DDS): 0.231
Top Committers
Name Email Commits
Eric Jeschke e****c@n****g 1,774
Pey Lian Lim l****m@s****u 495
Rajul r****9@g****m 52
Rupak Das r****7@g****m 32
Erik Tollerud e****d@g****m 19
Stuart Mumford s****t@m****k 12
Brigitta Sipocz b****z@g****m 10
Christoph Deil D****h@g****m 8
dependabot[bot] 4****] 6
Russell Kackley r****y@n****g 5
Chi-Hung Yan c****n@a****w 4
Sergio Pascual s****r@f****s 4
Thomas Robitaille t****e@g****m 4
rirze c****h@g****m 4
Justin Kunimune j****u@c****p 3
Chris Beaumont b****t@h****u 3
J. Xavier Prochaska x****r@u****g 3
Joe Catera z****i@g****m 3
Ray Plante r****e@n****u 3
supersandra s****e@h****m 3
Raj Karamchedu r****u@s****m 3
Miguel de Val-Borro m****l@a****t 2
Nabil Freij n****j@g****m 2
Megan Sosey s****y@s****u 2
Jonathan Eisenhamer e****r@s****u 2
Austin Beauchamp a****h@g****m 2
Christine Chang x****g@g****m 2
Ole Streicher o****e@d****g 2
jkunimune15 j****5@p****u 1
Brian Cole b****e@g****u 1
and 13 more...

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 70
  • Total pull requests: 141
  • Average time to close issues: 9 months
  • Average time to close pull requests: 4 months
  • Total issue authors: 19
  • Total pull request authors: 8
  • Average comments per issue: 4.34
  • Average comments per pull request: 4.98
  • Merged pull requests: 117
  • Bot issues: 0
  • Bot pull requests: 14
Past Year
  • Issues: 12
  • Pull requests: 20
  • Average time to close issues: 1 day
  • Average time to close pull requests: 9 days
  • Issue authors: 4
  • Pull request authors: 3
  • Average comments per issue: 1.0
  • Average comments per pull request: 0.4
  • Merged pull requests: 18
  • Bot issues: 0
  • Bot pull requests: 10
Top Authors
Issue Authors
  • pllim (30)
  • ejeschke (21)
  • olebole (2)
  • StuartLittlefair (2)
  • jhennawi (1)
  • obi-wan76 (1)
  • SunilSimha (1)
  • timj (1)
  • bmorris3 (1)
  • fmadec (1)
  • MNBrod (1)
  • JuanCab (1)
  • eilatg (1)
  • Tang-SL (1)
  • tbowers7 (1)
Pull Request Authors
  • ejeschke (75)
  • pllim (46)
  • dependabot[bot] (14)
  • olebole (2)
  • ayshih (1)
  • eteq (1)
  • ebroens (1)
  • captainshar (1)
Top Labels
Issue Labels
bug (23) maintenance (9) Feature Request (6) documentation (4) plugin (4) question (3) enhancement (3) reference viewer (3) affects-dev (2) widget (2) upstream fix required (2) invalid (2) help wanted (1) duplicate (1) dependencies (1)
Pull Request Labels
maintenance (70) reference viewer (45) enhancement (39) plugin (37) documentation (34) widget (24) dependencies (16) needs testing (13) github_actions (12) bug (6) affects-dev (4) Feature Request (3) python (2) duplicate (1)

Packages

  • Total packages: 2
  • Total downloads:
    • pypi 8,908 last-month
  • Total dependent packages: 16
    (may contain duplicates)
  • Total dependent repositories: 24
    (may contain duplicates)
  • Total versions: 133
  • Total maintainers: 2
pypi.org: ginga

A scientific image viewer and toolkit

  • Versions: 119
  • Dependent Packages: 8
  • Dependent Repositories: 19
  • Downloads: 8,908 Last month
  • Docker Downloads: 0
Rankings
Dependent packages count: 1.3%
Downloads: 3.2%
Dependent repos count: 3.4%
Docker downloads count: 3.4%
Average: 3.8%
Forks count: 5.0%
Stargazers count: 6.7%
Maintainers (2)
Last synced: 6 months ago
conda-forge.org: ginga

Ginga is a toolkit designed for building viewers for scientific image data in Python, visualizing 2D pixel data in numpy arrays. 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. Ginga is distributed under an open-source BSD licence. Please see the file LICENSE.txt in the top-level directory for details.

  • Versions: 14
  • Dependent Packages: 8
  • Dependent Repositories: 5
Rankings
Dependent packages count: 7.1%
Dependent repos count: 14.7%
Average: 18.7%
Forks count: 20.9%
Stargazers count: 32.0%
Last synced: 6 months ago