Aperture Photometry Tool

Last updated
Aperture Photometry Tool (APT)
MottoInviso notitia ("Look at the data!")
DeveloperRuss Laher (IPAC)
Initial release2007;17 years ago (2007)
Stable releasev. 3.0.9 / 24 September 2024;37 days ago (2024-09-24)
Development statusActive
Programming language Java
Platforms Windows, Linux, and Mac OS
TypeAstronomy
LicenseFree software for research & education
Website aperturephotometry.org

Aperture Photometry Tool (APT) is software with a graphical user interface for computing aperture photometry on astronomical imagery. Image overlays, graphical representations, statistics, models, options and controls for aperture-photometry calculations are brought together into a single package. The software handles only images in FITS file format. The software also can be used as a FITS-image viewer. APT is executed on desktop and laptop computers, and is free of charge under a license that limits its use to astronomical research and education. The software may be downloaded from its official website, and requires the Java Virtual Machine to be installed on the user's computer.

Contents

APT's Main Graphical User Interface AperturePhotometryTool v3.0.9.png
APT's Main Graphical User Interface

History

The initial version of APT was released on November 2, 2007. The latest version is APT v. 3.0.9, released on September 24, 2024. The software was developed by Dr. Russ Laher, a member of the professional staff at the NASA Exoplanet Science Institute (NExScI), part of the Infrared Processing and Analysis Center (IPAC) at the California Institute of Technology. A paper on APT was published in July 2012 in the journal Publications of the Astronomy Society of the Pacific. [1] A companion paper [2] compares the performance of APT vs. SExtractor, [3] an established command-line software program for aperture photometry.

Aperture and Sky Annulus

Aperture geometry, size, and location in the image are important parameters in aperture photometry. APT allows circular and elliptical shapes for apertures and sky annuli (the latter are used for background estimation). The rotation can be controlled in the case of an ellipse. The sky annulus will have the same shape as the aperture, but with larger inner and outer radii than the aperture. Although there is no hard limitation on the aperture size, it is practically limited by the software's response time in the calculation for a large aperture and sky annulus, and the tool for the user to interactively specify the size parameters includes a discretely zoomable subimage that is 801x801 pixels. The aperture is placed on the desired image location with a mouse click. Options to allow minor adjustments of the aperture position via centroiding are available. APT also has pixel-zapping functionality, which can be used to temporarily set the value of select pixels to NaN (not a number), effectively removing them from the aperture-photometry calculations.

Sky Coordinates

For aperture photometry on an astronomical image, it is often useful to know the sky coordinates of an image pixel. APT computes and displays sky coordinates if keywords that define a World Coordinate System (WCS) are present in the header of the FITS-image file. APT handles the commonly used tangent or gnomonic projection (TAN, TPV, and SIP subtypes), as well as the sine (a.k.a. orthographic), Cartesian, and Aitoff projections (the latter is probably only useful for display purposes).

APT calculates geometric image distortion only for the tangent projection at this time. Two distortion conventions are supported, which are the two major methods employed in modern astronomy. The SIP convention is applied for images with CTYPE1 = 'RA---TAN-SIP' and CTYPE2 = 'DEC—TAN-SIP'. In the absence of SIP keywords, APT will attempt to read in and apply any PV distortion keywords in the FITS header for images with either CTYPE1 = 'RA---TAN' and CTYPE2 = 'DEC—TAN' or with CTYPE1 = 'RA---TPV' and CTYPE2 = 'DEC—TPV'. APT computes SIP distortion up to ninth polynomial order and PV distortion up to seventh polynomial order.

Recent updates to APT include a modification to display a warning when the reverse SIP transformation is not included in the FITS header with SIP distortion model.

Java Requirements

APT is written in the Java computing language. The latest APT version was built with the JDK 13 on a MacBook Pro laptop under macOS Monterey, Version 12.7.6 (and using apache-ant-1.9.16). Generally, APT can be executed with JRE versions greater than or equal to 13, since Java is "forward-compatible". APT can be executed by clicking or double-clicking on the APT icon in the case of Apple and Windows machines. The wrapper script APT.csh can be executed from a terminal window to start APT running from any machine, including those with Linux-type or Unix-type operating systems.

Related Research Articles

<span class="mw-page-title-main">Astrophotography</span> Imaging of astronomical objects

Astrophotography, also known as astronomical imaging, is the photography or imaging of astronomical objects, celestial events, or areas of the night sky. The first photograph of an astronomical object was taken in 1840, but it was not until the late 19th century that advances in technology allowed for detailed stellar photography. Besides being able to record the details of extended objects such as the Moon, Sun, and planets, modern astrophotography has the ability to image objects outside of the visible spectrum of the human eye such as dim stars, nebulae, and galaxies. This is accomplished through long time exposure as both film and digital cameras can accumulate and sum photons over long periods of time or using specialized optical filters which limit the photons to a certain wavelength.

<span class="mw-page-title-main">Texture mapping</span> Method of defining surface detail on a computer-generated graphic or 3D model

Texture mapping is a method for mapping a texture on a computer-generated graphic. "Texture" in this context can be high frequency detail, surface texture, or color.

<span class="mw-page-title-main">Photometry (astronomy)</span> Determination of light intensities of astronomical bodies

In astronomy, photometry, from Greek photo- ("light") and -metry ("measure"), is a technique used in astronomy that is concerned with measuring the flux or intensity of light radiated by astronomical objects. This light is measured through a telescope using a photometer, often made using electronic devices such as a CCD photometer or a photoelectric photometer that converts light into an electric current by the photoelectric effect. When calibrated against standard stars of known intensity and colour, photometers can measure the brightness or apparent magnitude of celestial objects.

Flexible Image Transport System (FITS) is an open standard defining a digital file format useful for storage, transmission and processing of data: formatted as multi-dimensional arrays, or tables. FITS is the most commonly used digital file format in astronomy. The FITS standard was designed specifically for astronomical data, and includes provisions such as describing photometric and spatial calibration information, together with image origin metadata.

<span class="mw-page-title-main">Astronomical transit</span> Term in astronomy

In astronomy, a transit is the passage of a celestial body directly between a larger body and the observer. As viewed from a particular vantage point, the transiting body appears to move across the face of the larger body, covering a small portion of it.

<span class="mw-page-title-main">IRAF</span> Software collection for astronomical data reduction and data analysis

IRAF is a collection of software written at the National Optical Astronomy Observatory (NOAO) geared towards the reduction of astronomical images and spectra in pixel array form. This is primarily data taken from imaging array detectors such as CCDs. It is available for all major operating systems for mainframes and desktop computers. IRAF was designed cross-platform, supporting VMS and UNIX-like operating systems. Use on Microsoft Windows was made possible by Cygwin in earlier versions, and can be today done with the Windows Subsystem for Linux. Today, it is primarily used on macOS and Linux.

<span class="mw-page-title-main">Image stitching</span> Combining multiple photographic images with overlapping fields of view

Image stitching or photo stitching is the process of combining multiple photographic images with overlapping fields of view to produce a segmented panorama or high-resolution image. Commonly performed through the use of computer software, most approaches to image stitching require nearly exact overlaps between images and identical exposures to produce seamless results, although some stitching algorithms actually benefit from differently exposed images by doing high-dynamic-range imaging in regions of overlap. Some digital cameras can stitch their photos internally.

<span class="mw-page-title-main">Aperture (software)</span> Image organizer for macOS

Aperture is a discontinued professional image organizer and editor developed by Apple between 2005 and 2015 for the Mac, as a professional alternative to iPhoto.

A camera raw image file contains unprocessed or minimally processed data from the image sensor of either a digital camera, a motion picture film scanner, or other image scanner. Raw files are so named because they are not yet processed, and contain large amounts of potentially redundant data. Normally, the image is processed by a raw converter, in a wide-gamut internal color space where precise adjustments can be made before conversion to a viewable file format such as JPEG or PNG for storage, printing, or further manipulation. There are dozens of raw formats in use by different manufacturers of digital image capture equipment.

Radiance is a suite of tools for performing lighting simulation originally written by Greg Ward. It includes a renderer as well as many other tools for measuring the simulated light levels. It uses ray tracing to perform all lighting calculations, accelerated by the use of an octree data structure. It pioneered the concept of high-dynamic-range imaging, where light levels are (theoretically) open-ended values instead of a decimal proportion of a maximum or integer fraction of a maximum. It also implements global illumination using the Monte Carlo method to sample light falling on a point.

<span class="mw-page-title-main">Infrared Processing and Analysis Center</span> NASA science center at Caltech in the US

The Infrared Processing and Analysis Center (IPAC) provides science operations, data management, data archives and community support for astronomy and planetary science missions. IPAC has a historical emphasis on infrared-submillimeter astronomy and exoplanet science. IPAC has supported NASA, NSF and privately funded projects and missions. It is located on the campus of the California Institute of Technology in Pasadena, California.

Georeferencing or georegistration is a type of coordinate transformation that binds a digital raster image or vector database that represents a geographic space to a spatial reference system, thus locating the digital data in the real world. It is thus the geographic form of image registration. The term can refer to the mathematical formulas used to perform the transformation, the metadata stored alongside or within the image file to specify the transformation, or the process of manually or automatically aligning the image to the real world to create such metadata. The most common result is that the image can be visually and analytically integrated with other geographic data in geographic information systems and remote sensing software.

<span class="mw-page-title-main">FITS Liberator</span> Software program

The ESA/ESO/NASA FITS Liberator is a free software program for processing and editing astronomical data in the FITS format to reproduce images of the universe. Version 3 and later are standalone programs; earlier versions were plugins for Adobe Photoshop. FITS Liberator is free software released under the BSD-3 license. The engine behind the FITS Liberator is NASA's CFITSIO library.

<span class="mw-page-title-main">JFreeChart</span> Open-source framework for the programming language Java

JFreeChart is an open-source framework for the programming language Java, which allows the creation of a wide variety of both interactive and non-interactive charts.

<span class="mw-page-title-main">Bahtinov mask</span> Telescope focusing device

The Bahtinov mask is a device used to focus small astronomical telescopes accurately. Although masks have long been used as focusing aids, the distinctive pattern was invented by Russian amateur astrophotographer Pavel Bahtinov in 2005. Precise focusing of telescopes and astrographs is critical to performing astrophotography.

<span class="mw-page-title-main">Integral field spectrograph</span> Spectrograph equipped with an integral field unit

Integral field spectrographs (IFS) combine spectrographic and imaging capabilities in the optical or infrared wavelength domains (0.32 μm – 24 μm) to get from a single exposure spatially resolved spectra in a bi-dimensional region. The name originates from the fact that the measurements result from integrating the light on multiple sub-regions of the field. Developed at first for the study of astronomical objects, this technique is now also used in many other fields, such as bio-medical science and Earth remote sensing. Integral field spectrography is part of the broader category of snapshot hyperspectral imaging techniques, itself a part of hyperspectral imaging.

<span class="mw-page-title-main">HEALPix</span> Pseudocylindrical equal-area map projection

HEALPix, an acronym for Hierarchical Equal Area isoLatitude Pixelisation of a 2-sphere, is an algorithm for pixelisation of the 2-sphere based on subdivision of a distorted rhombic dodecahedron, and the associated class of map projections. The pixelisation algorithm was devised in 1997 by Krzysztof M. Górski at the Theoretical Astrophysics Center in Copenhagen, Denmark, and first published as a preprint in 1998.

<span class="mw-page-title-main">Snapshot hyperspectral imaging</span> Method for capturing hyperspectral images

Snapshot hyperspectral imaging is a method for capturing hyperspectral images during a single integration time of a detector array. No scanning is involved with this method, in contrast to push broom and whisk broom scanning techniques. The lack of moving parts means that motion artifacts should be avoided. This instrument typically features detector arrays with a high number of pixels.

Instrumental magnitude refers to an uncalibrated apparent magnitude, and, like its counterpart, it refers to the brightness of an astronomical object, but unlike its counterpart, it is only useful in relative comparisons to other astronomical objects in the same image. Instrumental magnitude is defined in various ways, and so when working with instrumental magnitudes, it is important to know how they are defined. The most basic definition of instrumental magnitude, , is given by

Astrometric solving or Plate solving or Astrometric calibration of an astronomical image is a technique used in astronomy and applied on celestial images. Solving an image is finding match between the imaged stars and a star catalogue. The solution is a math model describing the corresponding astronomical position of each image pixel. The position of reference catalogue stars has to be known to a high accuracy so an astrometric reference catalogue is used such as the Gaia catalogue. The image solution contains a reference point, often the image centre, image scale, image orientation and in some cases an image distortion model.

References

  1. Laher, Russ R.; Gorjian, Varoujan; Rebull, Luisa M.; Masci, Frank J.; Fowler, John W.; Helou, George; Kulkarni, Shrinivas R.; Law, Nicholas M. (July 2012). "Aperture Photometry Tool" (PDF). Publications of the Astronomical Society of the Pacific. 124 (917): 737–763. Bibcode:2012PASP..124..737L. doi:10.1086/666883. S2CID   21572643.
  2. Laher, Russ R.; Rebull, Luisa M.; Gorjian, Varoujan; et al. (July 2012). "Aperture Photometry Tool Versus SExtractor for Noncrowded Fields" (PDF). Publications of the Astronomical Society of the Pacific. 124 (917): 764–781. Bibcode:2012PASP..124..764L. doi:10.1086/666507. S2CID   44534744.
  3. Bertin, E.; Arnouts, S. (June 1996). "SExtractor: Software for Source Extraction". Astronomy and Astrophysics Supplement Series. 117 (2): 393–404. Bibcode:1996A&AS..117..393B. doi: 10.1051/aas:1996164 .

Official website