macOS
Homebrewverified · 100%
brew install wcstoolsprovider-native install command
brew / rank 10702
Install wcstools with Homebrew
Tools for using World Coordinate Systems (WCS) in astronomical images. Version 3.9.7 via Homebrew; verified from local package data.
install
Additional install commands
overview
Package summary
Tools for using World Coordinate Systems (WCS) in astronomical images
Project links
Commands and aliases
- addpix
- bincat
- char2sp
- conpix
- cphead
- crlf
- delhead
- delwcs
- edhead
- filename
- fileroot
- filext
- fixpix
- getcol
- getdate
- getfits
- gethead
- getpix
- gettab
- htmlsp
- i2f
- imcat
- imextract
- imfill
- imhead
- immatch
- imresize
- imrot
- imsize
- imsmooth
- imstack
- imstar
history
Project history and usage
WCSTools is a long-running Smithsonian Astrophysical Observatory package of C command-line programs and subroutines for astronomical world coordinate systems. Its core job is to create, read, manipulate, and use WCS metadata in FITS and IRAF images so pixels can be related to positions on the sky.
The package sits in the practical astronomy niche where image headers, catalog matching, and shell pipelines meet. Tools such as imwcs, sky2xy, xy2sky, scat, gethead, sethead, and imcat make astrometry and FITS-header work scriptable without requiring users to embed a full astronomical data system in their workflow.
Project history
The published lineage begins in the mid-1990s. Douglas J. Mink's 1996 ADASS paper explains that after WCS support was added to SAOimage and then to SAOtng and SkyCat, astronomers still lacked WCS headers for much ground-based optical data. Mink adapted Elwood Downey's University of Iowa SETWCS approach into IMWCS and, as the software was generalized for more image types and reference catalogs, a wider suite of portable WCS utilities and subroutines emerged.
By the 1998 ADASS paper, WCSTools had become an image astrometry toolkit rather than a single fitting program. The package provided both modular subroutines and simple programs, read and wrote FITS and IRAF .imh images, supported many map projections used in FITS WCS work, and was explicitly designed to be easy to call from scripts.
The 2001 ADASS paper on WCSTools 3.0 described five years of use in image astrometry and noted that the package had grown alongside new reference catalogs such as GSC-ACT, 2MASS, and GSC II. The current upstream README identifies version 3.9.7, released April 26, 2022, as a mature continuation of the same SAO codebase maintained by Jessica Mink with contributions and algorithms from astronomy software specialists at institutions including CSIRO, NRAO, STScI, IPAC, NOAO, and others.
Adoption history
WCSTools became important partly because its subroutines were adopted by astronomical image browsers. The 1998 paper says SAOtng, its successor, and SkyCat used WCSTools subroutines, while the ASP abstract also lists SAOimage, SkyCat, and SAOtng as users of the library for displaying sky coordinates while browsing images.
Its adoption pattern is classic scientific Unix software: not a broad consumer tool, but a durable utility layer for observatories, archives, and astronomers who need repeatable FITS/IRAF header manipulation, catalog searches, and coordinate conversion inside scripts.
How it is used
Typical usage starts with existing FITS or IRAF images. imwcs can match image stars against reference catalogs and fit a WCS into the image header; xy2sky and sky2xy translate between pixel coordinates and sky coordinates; scat and imcat query source catalogs; gethead, sethead, edhead, and related tools inspect or edit FITS and IRAF metadata.
The toolkit is especially useful when older or ground-based images lack complete WCS headers. In that context, WCSTools can extract image stars, compare them to reference catalogs or Digitized Sky Survey fields, write WCS keywords, and then let downstream programs treat image positions as sky positions.
Why package nerds care
WCSTools is significant because it preserves a Unix-style astronomy workflow around FITS WCS: small executables, text-friendly output, and direct interoperability with shell scripts. For package maintainers, it is a good example of scientific software whose value comes from decades of domain compatibility rather than a modern repository or dependency graph.
It also documents the pre-Astropy, pre-service era of astronomical tooling, where command-line C utilities, IRAF compatibility, SAOimage-family viewers, and catalog CD-ROMs or web services were stitched together into practical astrometry pipelines.
Timeline
- 1996: Mink presents the IMWCS-focused WCSTools work at ADASS VI, describing the adaptation from SETWCS and the development of portable WCS utilities.
- 1998: Mink presents WCSTools as a broader image astrometry toolkit at ADASS VIII, emphasizing subroutines, command-line programs, scriptability, FITS/IRAF support, and image-browser integration.
- 2001-2002: The WCSTools 3.0 paper describes five years of image astrometry use and catalog-search expansion, including support for newer large catalogs.
- 2022-04-26: The upstream README lists WCSTools 3.9.7 and a detailed set of recent fixes and new utility behavior.
Related projects
- WCSTools is historically connected to SAOimage, SAOtng, SkyCat, FITS, IRAF, the Digitized Sky Survey, HST Guide Star Catalog, USNO catalogs, 2MASS, WCSLIB, Astropy WCS tooling, and other astrometry packages such as SExtractor, SCAMP, and Astrometry.net.
Sources
- http://tdc-www.harvard.edu/software/wcstools/publications/wcstools.adass96.html
- http://tdc-www.harvard.edu/software/wcstools/publications/wcstools.adass98.html
- http://tdc-www.harvard.edu/software/wcstools/wcstools.readme.html
- https://ui.adsabs.harvard.edu/abs/2011ascl.soft09015M/abstract
- https://www.aspbooks.org/a/volumes/article_details/?paper_id=17573
- https://www.atnf.csiro.au/computing/software/wcs/wcslib/software.html
security posture
Risk level: blue
broad file, network, media, or database tool signal.
Risk classifier
blue risk · medium confidence · tool
Why
- broad file, network, media, or database tool signal
Signals
- text:image
Install behavior
- No Homebrew bottle metadata was recorded.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
addpix | executable | indexed executable | Discovered from the local executable index. |
bincat | executable | indexed executable | Discovered from the local executable index. |
char2sp | executable | indexed executable | Discovered from the local executable index. |
conpix | executable | indexed executable | Discovered from the local executable index. |
cphead | executable | indexed executable | Discovered from the local executable index. |
crlf | executable | indexed executable | Discovered from the local executable index. |
delhead | executable | indexed executable | Discovered from the local executable index. |
delwcs | executable | indexed executable | Discovered from the local executable index. |
edhead | executable | indexed executable | Discovered from the local executable index. |
filename | executable | indexed executable | Discovered from the local executable index. |
fileroot | executable | indexed executable | Discovered from the local executable index. |
filext | executable | indexed executable | Discovered from the local executable index. |
fixpix | executable | indexed executable | Discovered from the local executable index. |
getcol | executable | indexed executable | Discovered from the local executable index. |
getdate | executable | indexed executable | Discovered from the local executable index. |
getfits | executable | indexed executable | Discovered from the local executable index. |
gethead | executable | indexed executable | Discovered from the local executable index. |
getpix | executable | indexed executable | Discovered from the local executable index. |
gettab | executable | indexed executable | Discovered from the local executable index. |
htmlsp | executable | indexed executable | Discovered from the local executable index. |
i2f | executable | indexed executable | Discovered from the local executable index. |
imcat | executable | indexed executable | Discovered from the local executable index. |
imextract | executable | indexed executable | Discovered from the local executable index. |
imfill | executable | indexed executable | Discovered from the local executable index. |
imhead | executable | indexed executable | Discovered from the local executable index. |
immatch | executable | indexed executable | Discovered from the local executable index. |
imresize | executable | indexed executable | Discovered from the local executable index. |
imrot | executable | indexed executable | Discovered from the local executable index. |
imsize | executable | indexed executable | Discovered from the local executable index. |
imsmooth | executable | indexed executable | Discovered from the local executable index. |
imstack | executable | indexed executable | Discovered from the local executable index. |
imstar | executable | indexed executable | Discovered from the local executable index. |
imwcs | executable | indexed executable | Discovered from the local executable index. |
isfile | executable | indexed executable | Discovered from the local executable index. |
isfits | executable | indexed executable | Discovered from the local executable index. |
isnum | executable | indexed executable | Discovered from the local executable index. |
isrange | executable | indexed executable | Discovered from the local executable index. |
keyhead | executable | indexed executable | Discovered from the local executable index. |
newfits | executable | indexed executable | Discovered from the local executable index. |
remap | executable | indexed executable | Discovered from the local executable index. |
scat | executable | indexed executable | Discovered from the local executable index. |
sethead | executable | indexed executable | Discovered from the local executable index. |
setpix | executable | indexed executable | Discovered from the local executable index. |
simpos | executable | indexed executable | Discovered from the local executable index. |
sky2xy | executable | indexed executable | Discovered from the local executable index. |
skycoor | executable | indexed executable | Discovered from the local executable index. |
sp2char | executable | indexed executable | Discovered from the local executable index. |
subpix | executable | indexed executable | Discovered from the local executable index. |
sumpix | executable | indexed executable | Discovered from the local executable index. |
wcshead | executable | indexed executable | Discovered from the local executable index. |
wcstools | executable | indexed executable | Discovered from the local executable index. |
xy2sky | executable | indexed executable | Discovered from the local executable index. |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-08-03
manager version3.9.7
manager updated
local dataunknown
upstreamnot available
latest detectednot detected
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:wcstools |
|---|---|
| Version | 3.9.7 |
| Package manager | Homebrew |
| Homepage | http://tdc-www.harvard.edu/wcstools/ |
| Bottle | not recorded |
| Service | none declared |
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- Nucleus package database
- curated package history
- pkgdb category and tag curation