Software:Nom.tam.fits: Difference between revisions

From HandWiki
(import)
 
(import)
 
Line 3: Line 3:
| logo = Nom.tam.fits project logo.png
| logo = Nom.tam.fits project logo.png
| released = 2008 July 11
| released = 2008 July 11
| latest release version = 1.19.1
| latest release version = 1.20.1
| latest release date = 2024 March 11
| latest release date = 2024 September 1
| latest preview version = 1.20.0-rc1
<!--
| latest preview date = 2024 April 30
| latest preview version = 1.20.2-rc1
| latest preview date = 2024 October 1
-->
| developer = Thomas A. McGlynn, Attila Kov&aacute;cs, Richard van Nieuwhoven, et al.
| developer = Thomas A. McGlynn, Attila Kov&aacute;cs, Richard van Nieuwhoven, et al.
| programming language = [[Java (programming language)|Java]]
| programming language = [[Java (programming language)|Java]]
Line 16: Line 18:
}}
}}


'''nom.tam.fits''' is a full-featured, fast, 100% pure [[Java (programming language)|Java]] library for reading, writing, and modifying [[FITS]] files. The library owes its origins to Thomas A. McGlynn (hence the ''nom.tam'' prefix) at [[Organization:Goddard Space Flight Center|NASA Goddard Space Flight Center]]. Currently, it is maintained by Attila Kov&aacute;cs at the [[Harvard–Smithsonian Center for Astrophysics|Center for Astrophysics | Harvard & Smithsonian]].
'''nom.tam.fits''' is a free [[Java (programming language)|Java]] library for reading, writing, and modifying [[FITS]] files<ref name="github-repo"></ref>. The library owes its origins to Thomas A. McGlynn (hence the ''nom.tam'' prefix) at [[Organization:Goddard Space Flight Center|NASA Goddard Space Flight Center]]<ref name="heasarch-home"></ref>. Currently, it is maintained by Attila Kov&aacute;cs at the [[Harvard–Smithsonian Center for Astrophysics|Center for Astrophysics | Harvard & Smithsonian]]<ref name="github-repo"></ref>.


Using the library effectively requires a level of familiarity with the [[FITS]] standards.<ref name="fits_standard">{{cite web|url=https://fits.gsfc.nasa.gov/fits_standard.html|title=Definition of the Flexible Image Transport System (FITS)|author=IAU FITS working group|date=2018-08-13|orig-date=2016-07-22}}</ref><ref name="fits-3.0">{{cite journal|last1=Pence|first1=W.D.|last2=Chiappetti|first2=L.|last3=Page|first3=C.G.|last4=Shaw|first4=R.A|last5=Stobie|first5=E.|display-authors=3|title=Definition of the Flexible Image Transport System (FITS), version 3.0|journal=Astronomy & Astrophysics|volume=524|pages=A42|date=2010|doi=10.1051/0004-6361/201015362 |bibcode=2010A&A...524A..42P }}</ref> and conventions<ref name="registered_conventions">{{cite web|url=https://fits.gsfc.nasa.gov/fits_registry.html|title=The Registry of FITS Conventions|author=IAU FITS working group|date=2023}}</ref>. For example, while the library will automatically interpret and populate the mandatory minimum data description in FITS headers, it will not automatically process most optional standard or conventional header entries. It is up to the users to extract or complete the description of data, for example to include FITS world coordinate systems (WCS)<ref name="wcs">{{cite journal|last1=Greisen|first1=E.W.|last2=Calabretta|first2=M.R.|title=Representations of world coordinates in FITS|journal=Astronomy & Astrophysics|volume=395|pages=1061–1075|date=2002|issue=3 |doi=10.1051/0004-6361:20021326|arxiv=astro-ph/0207407 |bibcode=2002A&A...395.1061G }}</ref><ref name="celestial-coordinates">
Using the library effectively requires<ref name="github-repo"></ref> a level of familiarity with the [[FITS]] standards.<ref name="fits_standard">{{cite web|url=https://fits.gsfc.nasa.gov/fits_standard.html|title=Definition of the Flexible Image Transport System (FITS)|author=IAU FITS working group|date=2018-08-13|orig-date=2016-07-22}}</ref><ref name="fits-3.0">{{cite journal|last1=Pence|first1=W.D.|last2=Chiappetti|first2=L.|last3=Page|first3=C.G.|last4=Shaw|first4=R.A|last5=Stobie|first5=E.|display-authors=3|title=Definition of the Flexible Image Transport System (FITS), version 3.0|journal=Astronomy & Astrophysics|volume=524|pages=A42|date=2010|doi=10.1051/0004-6361/201015362 |bibcode=2010A&A...524A..42P }}</ref> and conventions<ref name="registered_conventions">{{cite web|url=https://fits.gsfc.nasa.gov/fits_registry.html|title=The Registry of FITS Conventions|author=IAU FITS working group|date=2023}}</ref>, such as the FITS world coordinate systems (WCS)<ref name="wcs">{{cite journal|last1=Greisen|first1=E.W.|last2=Calabretta|first2=M.R.|title=Representations of world coordinates in FITS|journal=Astronomy & Astrophysics|volume=395|pages=1061–1075|date=2002|issue=3 |doi=10.1051/0004-6361:20021326|arxiv=astro-ph/0207407 |bibcode=2002A&A...395.1061G }}</ref><ref name="celestial-coordinates">
{{cite journal|last2=Calabretta|first2=M.R.|last1=Greisen|first1=E.W.|title=Representations of celestial coordinates in FITS|journal=Astronomy & Astrophysics|volume=395|pages=1077–1122|date=2002|issue=3 |doi=10.1051/0004-6361:20021327|arxiv=astro-ph/0207413 |bibcode=2002A&A...395.1077C }}</ref><ref name="spectral coordinates">
{{cite journal|last2=Calabretta|first2=M.R.|last1=Greisen|first1=E.W.|title=Representations of celestial coordinates in FITS|journal=Astronomy & Astrophysics|volume=395|pages=1077–1122|date=2002|issue=3 |doi=10.1051/0004-6361:20021327|arxiv=astro-ph/0207413 |bibcode=2002A&A...395.1077C }}</ref><ref name="spectral coordinates">
{{cite journal|last1=Greisen|first1=E.W.|last2=Calabretta|first2=M.R.|last3=Valdes|first3=F.G.|last4=Allen|first4=S.L.|display-authors=3|title=Representations of spectral coordinates in FITS|journal=Astronomy & Astrophysics|volume=446|issue=2|pages=747–771|date=2006|doi=10.1051/0004-6361:20053818|arxiv=astro-ph/0507293 |bibcode=2006A&A...446..747G }}
{{cite journal|last1=Greisen|first1=E.W.|last2=Calabretta|first2=M.R.|last3=Valdes|first3=F.G.|last4=Allen|first4=S.L.|display-authors=3|title=Representations of spectral coordinates in FITS|journal=Astronomy & Astrophysics|volume=446|issue=2|pages=747–771|date=2006|doi=10.1051/0004-6361:20053818|arxiv=astro-ph/0507293 |bibcode=2006A&A...446..747G }}
</ref>, physical units, etc.
</ref>, physical units, etc.


'''nom.tam.fits''' is an [[Open source|open-source]], community maintained project hosted on [[GitHub]] as ''nom-tam-fits/nom-tam-fits''<ref name="github-repo"></ref>. Further information and documentation, including a User's Guide and [[API]] documentation, can be found there.
nom.tam.fits is a [[Open source|open-source]], community maintained, project hosted on [[GitHub]] as ''nom-tam-fits/nom-tam-fits''<ref name="github-repo"></ref>.


== History ==
== History ==
Line 29: Line 31:
The brief history of the library presented here is derived from ''(a)'' release notes and documentation published on the original HEASARCH home page<ref name="heasarch-home"></ref> of the project; ''(b)'' the [[Commit (version control)|commit]] history, release notes, and other documentation, published in the [[GitHub]] repository<ref name="github-repo">{{cite web|title=nom.tam.fits GitHub repository|url=https://github.com/nom-tam-fits/nom-tam-fits|website=github.com/nom-tam-fits/nom-tam-fits}}</ref>; ''(c)'' public<ref name="github-repo"></ref> and private communications among the three lead maintainers who spearheaded the project at various stages of its existence.
The brief history of the library presented here is derived from ''(a)'' release notes and documentation published on the original HEASARCH home page<ref name="heasarch-home"></ref> of the project; ''(b)'' the [[Commit (version control)|commit]] history, release notes, and other documentation, published in the [[GitHub]] repository<ref name="github-repo">{{cite web|title=nom.tam.fits GitHub repository|url=https://github.com/nom-tam-fits/nom-tam-fits|website=github.com/nom-tam-fits/nom-tam-fits}}</ref>; ''(c)'' public<ref name="github-repo"></ref> and private communications among the three lead maintainers who spearheaded the project at various stages of its existence.


The library was originally conceived and developed by Thomas A. McGlynn at [[Organization:Goddard Space Flight Center|NASA Goddard Space Flight Center]]. It was originally written for [[Java]] 1.0, which influenced many of the original design choices that remain in place to this day. The first published version was version '''0.92''' (12 October 2000), and was followed by a series of development releases, up until '''0.99.6''' (4 December 2007)<ref name="heasarch-home"></ref>.
The library was originally conceived and developed by Thomas A. McGlynn at [[Organization:Goddard Space Flight Center|NASA Goddard Space Flight Center]]<ref name="heasarch-home"></ref>. It was originally written for [[Java]] 1.0, which influenced many of the original design choices that remain in place to this day. The first published version was version 0.92 (12 October 2000), and was followed by a series of development releases, up until 0.99.6 (4 December 2007)<ref name="heasarch-home"></ref>.


The library reached 'stable' status with the '''1.0.0''' release on 11 July 2008. Tom McGlynn remained the lead developer through version '''1.12.0''' (25 February 2015), occasionally integrating contributions from users, as attested by the release notes<ref name="heasarch-home"></ref>.
The library reached 'stable' status with the 1.0.0 release on 11 July 2008. Tom McGlynn remained the lead developer through version 1.12.0 (25 February 2015), occasionally integrating contributions from users, as attested by the release notes<ref name="heasarch-home"></ref>.


In 2015, Tom passed the baton to Richard van Nieuwhoven, who has already contributed significantly to version '''1.12.0''', and who then continued to oversee releases '''1.13.0''' (20 July 2016) through '''1.15.2''' (28 April 2017)<ref name="heasarch-home"></ref><ref name="github-repo"></ref> as Tom took on a less active advisory role in the project. Ritchie has been instrumental in adding the initial image and table compression support to the library, as well as modernizing the [[API]] to use Java 6 features, such as [[Generic programming|generic types]] and the java.nio package. He also  migrated the source code to [[GitHub]] (at version '''1.12.0'''), set up [[Continuous integration|continuous integration]], added [[Unit testing|unit testing]] with nearly complete [[Code coverage|code coverage]], set up a build system with [[Software:Apache Maven|Apache Maven]], and began publishing [[Software:GNU Privacy Guard|GPG]]-signed release packages to both [[GitHub]]<ref name="github-repo"></ref> and the Maven Central repository<ref name="maven-central">{{cite web|title="nom-tam-fits on Maven Central"|url=https://mvnrepository.com/artifact/gov.nasa.gsfc.heasarc/nom-tam-fits}}</ref>.
In 2015, Richard van Nieuwhoven took over as the lead maintainer. He contributed significantly to version 1.12.0, and then oversaw releases 1.13.0 (20 July 2016) through 1.15.2 (28 April 2017)<ref name="heasarch-home"></ref><ref name="github-repo"></ref> as Tom took on a less active advisory role in the project. Ritchie has been instrumental in adding the initial image and table compression support to the library, as well as modernizing the [[API]] to use Java 6 features, such as [[Generic programming|generic types]] and the java.nio package<ref name="github-repo"></ref>. He also  migrated the source code to [[GitHub]] (at version 1.12.0), set up [[Continuous integration|continuous integration]], added [[Unit testing|unit testing]] with nearly complete [[Code coverage|code coverage]], set up a build system with [[Software:Apache Maven|Apache Maven]], and began publishing [[Software:GNU Privacy Guard|GPG]]-signed release packages to both [[GitHub]]<ref name="github-repo"></ref> and the Maven Central repository<ref name="maven-central">{{cite web|title="nom-tam-fits on Maven Central"|url=https://mvnrepository.com/artifact/gov.nasa.gsfc.heasarc/nom-tam-fits}}</ref>.


In 2021, Attila Kov&aacute;cs from the [[Harvard–Smithsonian Center for Astrophysics|Center for Astrophysics | Harvard & Smithsonian]] took over as the lead maintainer (still with the blessing from Tom McGlynn), and continued overseeing releases starting with '''1.16.0''' (13 December 2021). Continuous integration was migrated from Travis CI to GitHub Actions, and successive releases were/are aimed at fixing outstanding bugs, improving compliance to the FITS standard, providing a more consistent user experience, and more complete, more accurate documentation. The source was also updated to utilize Java 8 features, such as [[Generics in Java#Diamond operator|diamond operators]], ''try-with-resources'' constructs, and default methods in [[Interface (Java)|interfaces]]<ref name="github-repo"></ref>.
Since 2021, the lead maintainer has been Attila Kov&aacute;cs from the [[Harvard–Smithsonian Center for Astrophysics|Center for Astrophysics | Harvard & Smithsonian]], overseeing releases starting from 1.16.0 (13 December 2021)<ref name="github-repo"></ref>. Continuous integration was migrated from Travis CI to GitHub Actions, and the successive releases have fixed bugs, improved compliance to the FITS standard, and focused on documentation<ref name="github-repo"></ref>. The language standard was bumped to Java 8 to utilize features, such as [[Generics in Java#Diamond operator|diamond operators]], ''try-with-resources'' constructs, and default methods in [[Interface (Java)|interfaces]]<ref name="github-repo"></ref>.


At least 14 other developers (excluding bots) have also contributed bits and pieces to the library since the project's presence on [[GitHub]], based on the contributor statistics available in the GitHub [[Repository (version control)|repository]]<ref name="github-repo"></ref>.
At least 14 other developers (excluding bots) have contributed bits and pieces to the library since the project's presence on [[GitHub]], based on the contributor statistics available in the GitHub [[Repository (version control)|repository]]<ref name="github-repo"></ref>.


== Adoption ==
== Adoption ==


At the time of writing this article, the GitHub project repository lists 73 other [[GitHub]] repositories that utilize '''nom.tam.fits'''<ref name="dependents">{{cite web | url=https://github.com/nom-tam-fits/nom-tam-fits/network/dependents | title=Network Dependents · nom-tam-fits/Nom-tam-fits | website=[[GitHub]] }}</ref>. A few are also listed as dependents on Maven Central<ref name="maven-central"></ref>.  
At the time of writing this article, the GitHub project repository lists 77 other [[GitHub]] repositories that utilize nom.tam.fits<ref name="dependents">{{cite web | url=https://github.com/nom-tam-fits/nom-tam-fits/network/dependents | title=Network Dependents · nom-tam-fits/Nom-tam-fits | website=[[GitHub]] }}</ref>. A few are also listed as dependents on Maven Central<ref name="maven-central"></ref>.  


Some examples of software that rely on '''nom.tam.fits''' to handle [[FITS|FITS files]] (in no particular order):
Some examples of software that rely on nom.tam.fits to handle [[FITS|FITS files]] (in no particular order):


* [[Organization:NASA|NASA]]'s [[Organization:Planetary Data System|Planetary Data System]] (PDS), specifically its Transform Tool<ref name="pds-transform">{{cite web|url=https://github.com/NASA-PDS/transform|title=PDS Transform Tool|website=[[GitHub]] }}</ref>, PDSView<ref name=pdsview">{{cite web|url=https://github.com/NASA-PDS/pds-view|title=PDSView|website=[[GitHub]] }}</ref> and PDS4 JParser<ref name="pds4-jparser">{{cite web|url=https://nasa-pds.github.io/pds4-jparser/|title=PDS4 JParser}}</ref> components.
* [[Organization:NASA|NASA]]'s [[Organization:Planetary Data System|Planetary Data System]] (PDS), specifically its Transform Tool<ref name="pds-transform">{{cite web|url=https://github.com/NASA-PDS/transform|title=PDS Transform Tool|website=[[GitHub]] }}</ref>, PDSView<ref name=pdsview">{{cite web|url=https://github.com/NASA-PDS/pds-view|title=PDSView|website=[[GitHub]] }}</ref> and PDS4 JParser<ref name="pds4-jparser">{{cite web|url=https://nasa-pds.github.io/pds4-jparser/|title=PDS4 JParser}}</ref> components.


* [[Organization:NASA|NASA]]'s Interoperable Remote Component (IRC)<ref name="irc">{{cite web|url=https://opensource.gsfc.nasa.gov/projects/IRC/index.php|title=Interoperable Remote Component (IRC)}}</ref> software, which provided [[Data acquisition|data aquisition]] for astronomical cameras such as [[Astronomy:Caltech Submillimeter Observatory|CSO]]/SHARC-2<ref name="sharc2">{{cite journal|last1=Dowell|first1=C. D.|last2=Allen|first2=C. A.|last3=Babu|first3=R. S.| last4=Freund|first4=M. M.|last5=Gardner|first5=M.|last6= Groseth|first6=J.| last7=Jhabvala|first7=M. D.|last8=Kov&aacute;cs|first8=A.|editor-first1=Thomas G. |editor-first2=Jonas |editor-last1=Phillips |editor-last2=Zmuidzinas |display-authors=3|title=SHARC II: a Caltech submillimeter observatory facility camera with 384 pixels|journal=Proc. SPIE|series=Millimeter and Submillimeter Detectors for Astronomy |volume=4855|pages=73|date=2003|doi=10.1117/12.459360 |bibcode=2003SPIE.4855...73D |url=https://resolver.caltech.edu/CaltechAUTHORS:20150120-140348785 }}</ref> and [[Astronomy:IRAM 30m telescope|IRAM]]/GISMO<ref name="gismo">{{cite journal|last1=Staguhn|first1=Johannes G.|last2=Allen|first2=Christine|last3=Benford|first3=Dominic J.|last4=Sharp|first4=Elmer|display-authors=3|title=GISMO, a 2 mm Bolometer Camera Optimized for the Study of High Redshift Galaxies|journal=Journal of Low Temperature Physics|volume=151|issue=3-4|pages=709-714|date=2008|doi=10.1007/s10909-008-9733-6|bibcode=2008JLTP..151..709S}}</ref>.
* [[Organization:NASA|NASA]]'s Interoperable Remote Component (IRC)<ref name="irc">{{cite web|url=https://opensource.gsfc.nasa.gov/projects/IRC/index.php|title=Interoperable Remote Component (IRC)}}</ref> software, which provided [[Data acquisition|data aquisition]] for astronomical cameras such as [[Astronomy:Caltech Submillimeter Observatory|CSO]]/SHARC-2<ref name="sharc2">{{cite journal|last1=Dowell|first1=C. D.|last2=Allen|first2=C. A.|last3=Babu|first3=R. S.| last4=Freund|first4=M. M.|last5=Gardner|first5=M.|last6= Groseth|first6=J.| last7=Jhabvala|first7=M. D.|last8=Kov&aacute;cs|first8=A.|editor-first1=Thomas G. |editor-first2=Jonas |editor-last1=Phillips |editor-last2=Zmuidzinas |display-authors=3|title=SHARC II: a Caltech submillimeter observatory facility camera with 384 pixels|journal=Proc. SPIE|series=Millimeter and Submillimeter Detectors for Astronomy |volume=4855|pages=73|date=2003|doi=10.1117/12.459360 |bibcode=2003SPIE.4855...73D |url=https://resolver.caltech.edu/CaltechAUTHORS:20150120-140348785 }}</ref> and [[Astronomy:IRAM 30m telescope|IRAM]]/GISMO<ref name="gismo">{{cite journal|last1=Staguhn|first1=Johannes G.|last2=Allen|first2=Christine|last3=Benford|first3=Dominic J.|last4=Sharp|first4=Elmer|display-authors=3|title=GISMO, a 2 mm Bolometer Camera Optimized for the Study of High Redshift Galaxies|journal=Journal of Low Temperature Physics|volume=151|issue=3–4|pages=709–714|date=2008|doi=10.1007/s10909-008-9733-6|bibcode=2008JLTP..151..709S}}</ref>.


* [[Astronomy:Starlink Project|Starlink Project]]'s Starlink Tables Infrastructure Library (STIL)<ref name="stil">{{cite book|first1=M.B.|last1=Taylor|chapter=TOPCAT & STIL: Starlink Table/VOTable Processing Software|title=Astronomical Data Analysis Software and Systems XIV |series=ASP Conference Series|volume=347|date=2005|pages=29}}</ref>, used e.g. by [[Software:TOPCAT|TOPCAT]].
* [[Astronomy:Starlink Project|Starlink Project]]'s Starlink Tables Infrastructure Library (STIL)<ref name="stil">{{cite book|first1=M.B.|last1=Taylor|chapter=TOPCAT & STIL: Starlink Table/VOTable Processing Software|title=Astronomical Data Analysis Software and Systems XIV |series=ASP Conference Series|volume=347|date=2005|pages=29}}</ref>, used e.g. by [[Software:TOPCAT|TOPCAT]].
Line 61: Line 63:
* Advanced Data mining And Machine learning System (ADAMS)<ref name=adams>{{cite book|last1=Reutemann| first1=Peter|last2=Vanschoren|first2=Joaquin|date=2012|chapter=Scientific Workflow Management with ADAMS|title=Proceedings of the Machine Learning and Knowledge Discovery in Databases (ECML-PKDD), Part II|series=Lecture Notes in Computer Science|volume=7524|pages=833–837}}</ref> spectral base modules <ref name="specral-base-modules">{{cite web|title=ADAMS Spectral Base Modules|website=[[GitHub]] |url=https://github.com/waikato-datamining/adams-spectral-base}}</ref>.
* Advanced Data mining And Machine learning System (ADAMS)<ref name=adams>{{cite book|last1=Reutemann| first1=Peter|last2=Vanschoren|first2=Joaquin|date=2012|chapter=Scientific Workflow Management with ADAMS|title=Proceedings of the Machine Learning and Knowledge Discovery in Databases (ECML-PKDD), Part II|series=Lecture Notes in Computer Science|volume=7524|pages=833–837}}</ref> spectral base modules <ref name="specral-base-modules">{{cite web|title=ADAMS Spectral Base Modules|website=[[GitHub]] |url=https://github.com/waikato-datamining/adams-spectral-base}}</ref>.


* Spectral Line Identification and Modelling (SLIM)<ref name="slim">{{cite journal|title=Spectral Line Identification and Modelling (SLIM) in the MAdrid Data CUBe Analysis (MADCUBA) package|first1=S.|last1= Martín|first2=J.|last2=Martín-Pintado|first3=C.|last3= Blanco-Sánchez|first4=V. M.|last4=Rivilla|first5=A.|last5=Rodríguez-Franco|first6=F.|last6=Rico-Villas|display-authors=3|journal=Astronomy & Astrophysics|volume=631|pages=A159|date=2019|doi=10.1051/0004-6361/201936144|eprint=1909.02147|bibcode=2019A&A...631A.159M}}</ref> component of the MADCUBA<ref name="madcuba-site">{{cite web|title=MAdrid Data CUBe Analysis (MADCUBA)|url=https://cab.inta-csic.es/madcuba/}}</ref> software package for the analysis of astronomical [[Data cube|data cubes]].
* Spectral Line Identification and Modelling (SLIM)<ref name="slim">{{cite journal|title=Spectral Line Identification and Modelling (SLIM) in the MAdrid Data CUBe Analysis (MADCUBA) package|first1=S.|last1= Martín|first2=J.|last2=Martín-Pintado|first3=C.|last3= Blanco-Sánchez|first4=V. M.|last4=Rivilla|first5=A.|last5=Rodríguez-Franco|first6=F.|last6=Rico-Villas|display-authors=3|journal=Astronomy & Astrophysics|volume=631|pages=A159|date=2019|doi=10.1051/0004-6361/201936144|arxiv=1909.02147|bibcode=2019A&A...631A.159M}}</ref> component of the MADCUBA<ref name="madcuba-site">{{cite web|title=MAdrid Data CUBe Analysis (MADCUBA)|url=https://cab.inta-csic.es/madcuba/}}</ref> software package for the analysis of astronomical [[Data cube|data cubes]].


* CRUSH<ref name="crush">
* CRUSH<ref name="crush">
Line 81: Line 83:
== Releases ==
== Releases ==


Early releases, and related documentation, for versions '''0.92''' through '''1.15.1''' are available at the original HEASARCH site<ref name="heasarch-home">{{cite web | url=https://heasarc.gsfc.nasa.gov/docs/heasarc/fits/java/ | title=Index of /Docs/Heasarc/Fits/Java }}</ref>.
Early releases, and related documentation, for versions 0.92 through 1.15.1 are available at the original HEASARCH site<ref name="heasarch-home">{{cite web | url=https://heasarc.gsfc.nasa.gov/docs/heasarc/fits/java/ | title=Index of /Docs/Heasarc/Fits/Java }}</ref>


More recent releases ('''1.15.2''' and later) are available on the [[GitHub]] project site<ref name="github-repo"></ref>.
Since version 1.12.0 (21 February 2015) releases are available on the [[GitHub]] repository<ref name="github-repo"></ref>, and are published to the Maven Central Repository<ref name="maven-central"></ref> also.


Starting with version '''1.12.0''' (21 February 2015) releases are also published to the Maven Central Repository<ref name="maven-central"></ref>.
New versions of the library are released on a predictable quarterly schedule, around the 15th of March, June, September, and/or December<ref name="github-repo"></ref>. In the weeks and month(s) leading up to releases, a number of release candidates are published briefly on the [[GitHub]] project site<ref name="github-repo"></ref> to allow sufficient testing of the fixes and new features.
 
Starting with version '''1.16.0''', releases now follow a predictable, quarterly schedule with releases targeted around the 15th of March, June, September, and/or December<ref name="github-repo"></ref>. In the weeks and month(s) leading up to releases, a number of release candidates are published briefly on the [[GitHub]] project site<ref name="github-repo"></ref> to allow sufficient testing of the fixes and new features.


== Redistribution ==
== Redistribution ==


The '''nom.tam.fits''' library is also redistributed as the '''libfits-java''' package<ref name="libfits-java">{{cite web|title=Debian libfits-java package|url=https://packages.debian.org/sid/libfits-java}}</ref> for [[Software:Debian|Debian Linux]], and as the '''nom-tam-fits''' [[Software:RPM Package Manager|RPM]] package<ref name="rpm">{{cite web|title=Fedora Linux nom-tam-fits RPM package|url=https://src.fedoraproject.org/rpms/nom-tam-fits}}</ref> by [[Software:Fedora Linux|Fedora Linux]]. However, as of the writing of this article both of these redistributions are based on outdated versions of the library (specifically version '''1.15.2''').
The nom.tam.fits library is also redistributed as the libfits-java package<ref name="libfits-java">{{cite web|title=Debian libfits-java package|url=https://packages.debian.org/sid/libfits-java}}</ref> for [[Software:Debian|Debian Linux]], and as the nom-tam-fits [[Software:RPM Package Manager|RPM]] package<ref name="rpm">{{cite web|title=Fedora Linux nom-tam-fits RPM package|url=https://src.fedoraproject.org/rpms/nom-tam-fits}}</ref> by [[Software:Fedora Linux|Fedora Linux]].


== External links ==
== External links ==

Latest revision as of 03:16, 29 September 2024

nom.tam.fits
Nom.tam.fits project logo.png
Developer(s)Thomas A. McGlynn, Attila Kovács, Richard van Nieuwhoven, et al.
Initial release2008 July 11
Stable release
1.20.1 / 2024 September 1
Repositorygithub.com/nom-tam-fits/nom-tam-fits
Written inJava
Operating systemCross-platform
TypeTechnical computing
LicenseUnlicense
Websitenom-tam-fits.github.io/nom-tam-fits

nom.tam.fits is a free Java library for reading, writing, and modifying FITS files[1]. The library owes its origins to Thomas A. McGlynn (hence the nom.tam prefix) at NASA Goddard Space Flight Center[2]. Currently, it is maintained by Attila Kovács at the Center for Astrophysics | Harvard & Smithsonian[1].

Using the library effectively requires[1] a level of familiarity with the FITS standards.[3][4] and conventions[5], such as the FITS world coordinate systems (WCS)[6][7][8], physical units, etc.

nom.tam.fits is a open-source, community maintained, project hosted on GitHub as nom-tam-fits/nom-tam-fits[1].

History

The brief history of the library presented here is derived from (a) release notes and documentation published on the original HEASARCH home page[2] of the project; (b) the commit history, release notes, and other documentation, published in the GitHub repository[1]; (c) public[1] and private communications among the three lead maintainers who spearheaded the project at various stages of its existence.

The library was originally conceived and developed by Thomas A. McGlynn at NASA Goddard Space Flight Center[2]. It was originally written for Java 1.0, which influenced many of the original design choices that remain in place to this day. The first published version was version 0.92 (12 October 2000), and was followed by a series of development releases, up until 0.99.6 (4 December 2007)[2].

The library reached 'stable' status with the 1.0.0 release on 11 July 2008. Tom McGlynn remained the lead developer through version 1.12.0 (25 February 2015), occasionally integrating contributions from users, as attested by the release notes[2].

In 2015, Richard van Nieuwhoven took over as the lead maintainer. He contributed significantly to version 1.12.0, and then oversaw releases 1.13.0 (20 July 2016) through 1.15.2 (28 April 2017)[2][1] as Tom took on a less active advisory role in the project. Ritchie has been instrumental in adding the initial image and table compression support to the library, as well as modernizing the API to use Java 6 features, such as generic types and the java.nio package[1]. He also migrated the source code to GitHub (at version 1.12.0), set up continuous integration, added unit testing with nearly complete code coverage, set up a build system with Apache Maven, and began publishing GPG-signed release packages to both GitHub[1] and the Maven Central repository[9].

Since 2021, the lead maintainer has been Attila Kovács from the Center for Astrophysics | Harvard & Smithsonian, overseeing releases starting from 1.16.0 (13 December 2021)[1]. Continuous integration was migrated from Travis CI to GitHub Actions, and the successive releases have fixed bugs, improved compliance to the FITS standard, and focused on documentation[1]. The language standard was bumped to Java 8 to utilize features, such as diamond operators, try-with-resources constructs, and default methods in interfaces[1].

At least 14 other developers (excluding bots) have contributed bits and pieces to the library since the project's presence on GitHub, based on the contributor statistics available in the GitHub repository[1].

Adoption

At the time of writing this article, the GitHub project repository lists 77 other GitHub repositories that utilize nom.tam.fits[10]. A few are also listed as dependents on Maven Central[9].

Some examples of software that rely on nom.tam.fits to handle FITS files (in no particular order):

  • Advanced Data mining And Machine learning System (ADAMS)[24] spectral base modules [25].
  • Spectral Line Identification and Modelling (SLIM)[26] component of the MADCUBA[27] software package for the analysis of astronomical data cubes.
  • Terran Interstellar Plotter System (TRIPS)[32], a stellar cartography system for stellar databases.
  • AstroToolBox[33] for visualizing, identifying, and classifying astronomical objects.
  • Control and Data Handling (CDH) component for the SOFIA/HAWC+[30] camera.

Releases

Early releases, and related documentation, for versions 0.92 through 1.15.1 are available at the original HEASARCH site[2]

Since version 1.12.0 (21 February 2015) releases are available on the GitHub repository[1], and are published to the Maven Central Repository[9] also.

New versions of the library are released on a predictable quarterly schedule, around the 15th of March, June, September, and/or December[1]. In the weeks and month(s) leading up to releases, a number of release candidates are published briefly on the GitHub project site[1] to allow sufficient testing of the fixes and new features.

Redistribution

The nom.tam.fits library is also redistributed as the libfits-java package[35] for Debian Linux, and as the nom-tam-fits RPM package[36] by Fedora Linux.

External links

References

  1. ↑ 1.00 1.01 1.02 1.03 1.04 1.05 1.06 1.07 1.08 1.09 1.10 1.11 1.12 1.13 1.14 1.15 "nom.tam.fits GitHub repository". https://github.com/nom-tam-fits/nom-tam-fits. 
  2. ↑ 2.0 2.1 2.2 2.3 2.4 2.5 2.6 "Index of /Docs/Heasarc/Fits/Java". https://heasarc.gsfc.nasa.gov/docs/heasarc/fits/java/. 
  3. ↑ IAU FITS working group (2018-08-13). "Definition of the Flexible Image Transport System (FITS)". https://fits.gsfc.nasa.gov/fits_standard.html. 
  4. ↑ Pence, W.D.; Chiappetti, L.; Page, C.G. et al. (2010). "Definition of the Flexible Image Transport System (FITS), version 3.0". Astronomy & Astrophysics 524: A42. doi:10.1051/0004-6361/201015362. Bibcode: 2010A&A...524A..42P. 
  5. ↑ IAU FITS working group (2023). "The Registry of FITS Conventions". https://fits.gsfc.nasa.gov/fits_registry.html. 
  6. ↑ Greisen, E.W.; Calabretta, M.R. (2002). "Representations of world coordinates in FITS". Astronomy & Astrophysics 395 (3): 1061–1075. doi:10.1051/0004-6361:20021326. Bibcode: 2002A&A...395.1061G. 
  7. ↑ Greisen, E.W.; Calabretta, M.R. (2002). "Representations of celestial coordinates in FITS". Astronomy & Astrophysics 395 (3): 1077–1122. doi:10.1051/0004-6361:20021327. Bibcode: 2002A&A...395.1077C. 
  8. ↑ Greisen, E.W.; Calabretta, M.R.; Valdes, F.G. et al. (2006). "Representations of spectral coordinates in FITS". Astronomy & Astrophysics 446 (2): 747–771. doi:10.1051/0004-6361:20053818. Bibcode: 2006A&A...446..747G. 
  9. ↑ 9.0 9.1 9.2 ""nom-tam-fits on Maven Central"". https://mvnrepository.com/artifact/gov.nasa.gsfc.heasarc/nom-tam-fits. 
  10. ↑ "Network Dependents · nom-tam-fits/Nom-tam-fits". https://github.com/nom-tam-fits/nom-tam-fits/network/dependents. 
  11. ↑ "PDS Transform Tool". https://github.com/NASA-PDS/transform. 
  12. ↑ "PDSView". https://github.com/NASA-PDS/pds-view. 
  13. ↑ "PDS4 JParser". https://nasa-pds.github.io/pds4-jparser/. 
  14. ↑ "Interoperable Remote Component (IRC)". https://opensource.gsfc.nasa.gov/projects/IRC/index.php. 
  15. ↑ 15.0 15.1 Dowell, C. D.; Allen, C. A.; Babu, R. S. et al. (2003). "SHARC II: a Caltech submillimeter observatory facility camera with 384 pixels". Proc. SPIE. Millimeter and Submillimeter Detectors for Astronomy 4855: 73. doi:10.1117/12.459360. Bibcode: 2003SPIE.4855...73D. https://resolver.caltech.edu/CaltechAUTHORS:20150120-140348785. 
  16. ↑ Staguhn, Johannes G.; Allen, Christine; Benford, Dominic J. et al. (2008). "GISMO, a 2 mm Bolometer Camera Optimized for the Study of High Redshift Galaxies". Journal of Low Temperature Physics 151 (3–4): 709–714. doi:10.1007/s10909-008-9733-6. Bibcode: 2008JLTP..151..709S. 
  17. ↑ Taylor, M.B. (2005). "TOPCAT & STIL: Starlink Table/VOTable Processing Software". Astronomical Data Analysis Software and Systems XIV. ASP Conference Series. 347. pp. 29. 
  18. ↑ King, Gary (2007). "An Introduction to the Dataverse Network as an Infrastructure for Data Sharing". Sociological Methods and Research 36 (2): 173–199. doi:10.1177/0049124107306660. http://nrs.harvard.edu/urn-3:HUL.InstRepos:4215067. 
  19. ↑ "IVOA Data Access Layer". https://github.com/opencadc/dal. 
  20. ↑ "IVOA Data Access Layer / cadc-data-ops-fits module". https://github.com/opencadc/dal/tree/master/cadc-data-ops-fits. 
  21. ↑ "IVOA FITS package". https://skyservice.pha.jhu.edu/develop/vo/ivoafits/. 
  22. ↑ Collins, Karen A.; Kielkopf, John F.; Stassun, Keivan G. et al. (2017). "AstroImageJ: Image Processing and Photometric Extraction for Ultra-Precise Astronomical Light Curves". The Astronomical Journal 153 (2): 77. doi:10.3847/1538-3881/153/2/77. Bibcode: 2017AJ....153...77C. 
  23. ↑ "AstroImageJ". https://www.astro.louisville.edu/software/astroimagej/. 
  24. ↑ Reutemann, Peter; Vanschoren, Joaquin (2012). "Scientific Workflow Management with ADAMS". Proceedings of the Machine Learning and Knowledge Discovery in Databases (ECML-PKDD), Part II. Lecture Notes in Computer Science. 7524. pp. 833–837. 
  25. ↑ "ADAMS Spectral Base Modules". https://github.com/waikato-datamining/adams-spectral-base. 
  26. ↑ Martín, S.; Martín-Pintado, J.; Blanco-Sánchez, C. et al. (2019). "Spectral Line Identification and Modelling (SLIM) in the MAdrid Data CUBe Analysis (MADCUBA) package". Astronomy & Astrophysics 631: A159. doi:10.1051/0004-6361/201936144. Bibcode: 2019A&A...631A.159M. 
  27. ↑ "MAdrid Data CUBe Analysis (MADCUBA)". https://cab.inta-csic.es/madcuba/. 
  28. ↑ Kovács, A. (2008). "CRUSH: a fast and scalable data reduction for imaging arrays". Proc. SPIE. Millimeter and Submillimeter Detectors and Instrumentation for Astronomy IV 7020: 45. doi:10.1117/12.790276. Bibcode: 2008SPIE.7020E..1SK. 
  29. ↑ "CRUSH: Comprehensive Reduction Utility for SHARC-II". https://www.sigmyne.com/crush. 
  30. ↑ 30.0 30.1 Harper, Doyal A.; Runyan, Marcus C.; Dowell, C. Darren et al. (2018). "HAWC+, the Far-Infrared Camera and Polarimeter for SOFIA". Journal of Astronomical Instrumentation 07 (4): 1840008–1841025. doi:10.1142/S2251171718400081. Bibcode: 2018JAI.....740008H. 
  31. ↑ "attipaci/jnum". https://www.github.com/attipaci/jnum. 
  32. ↑ "Terran Interstella Plotter System (TRIPS)". https://github.com/ljramones/trips. 
  33. ↑ Kiwy, Frank (2022). "AstroToolBox: Java tools for identifying and classifying astronomical objects". https://ascl.net/2201.002. 
  34. ↑ Albi, Tomás Alonso (2018). "JPARSEC: a Java package for astronomy with twelve years of development and use". arXiv:1806.03088 [astro-ph.IM].
  35. ↑ "Debian libfits-java package". https://packages.debian.org/sid/libfits-java. 
  36. ↑ "Fedora Linux nom-tam-fits RPM package". https://src.fedoraproject.org/rpms/nom-tam-fits. 


Retrieved from "https://handwiki.org/wiki/index.php?title=Software:Nom.tam.fits&oldid=3737627"