# Install wcstools with Homebrew, apt, dnf, MacPorts Tools for using World Coordinate Systems (WCS) in astronomical images. Version 3.9.7 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:wcstools ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install wcstools ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install wcstools ``` Evidence: MacPorts ports tree: science/wcstools/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - Debian apt (92%): ```sh sudo apt install iraf-wcstools ``` Evidence: Debian stable package indexes: iraf-wcstools from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz - dnf (92%): ```sh sudo dnf install wcstools ``` Evidence: Fedora Rawhide package metadata: wcstools from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst ## Package facts - **Package key:** brew:wcstools - **Package manager:** Homebrew - **Package manager page:** - **Version:** 3.9.7 - **Source summary:** Tools for using World Coordinate Systems (WCS) in astronomical images - **Homepage:** - **Upstream docs:** - **License:** GPL-2.0-or-later - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - addpix (cli) - bincat (cli) - char2sp (cli) - conpix (cli) - cphead (cli) - crlf (cli) - delhead (cli) - delwcs (cli) - edhead (cli) - filename (cli) - fileroot (cli) - filext (cli) - fixpix (cli) - getcol (cli) - getdate (cli) - getfits (cli) - gethead (cli) - getpix (cli) - gettab (cli) - htmlsp (cli) - i2f (cli) - imcat (cli) - imextract (cli) - imfill (cli) - imhead (cli) - immatch (cli) - imresize (cli) - imrot (cli) - imsize (cli) - imsmooth (cli) - imstack (cli) - imstar (cli) - imwcs (cli) - isfile (cli) - isfits (cli) - isnum (cli) - isrange (cli) - keyhead (cli) - newfits (cli) - remap (cli) - scat (cli) - sethead (cli) - setpix (cli) - simpos (cli) - sky2xy (cli) - skycoor (cli) - sp2char (cli) - subpix (cli) - sumpix (cli) - wcshead (cli) - wcstools (cli) - xy2sky (cli) - addpix (alias) - bincat (alias) - char2sp (alias) - conpix (alias) - cphead (alias) - crlf (alias) - delhead (alias) - delwcs (alias) - edhead (alias) - filename (alias) - fileroot (alias) - filext (alias) - fixpix (alias) - getcol (alias) - getdate (alias) - getfits (alias) - gethead (alias) - getpix (alias) - gettab (alias) - htmlsp (alias) - i2f (alias) - imcat (alias) - imextract (alias) - imfill (alias) - imhead (alias) - immatch (alias) - imresize (alias) - imrot (alias) - imsize (alias) - imsmooth (alias) - imstack (alias) - imstar (alias) - imwcs (alias) - isfile (alias) - isfits (alias) - isnum (alias) - isrange (alias) - keyhead (alias) - newfits (alias) - remap (alias) - scat (alias) - sethead (alias) - setpix (alias) - simpos (alias) - sky2xy (alias) - skycoor (alias) - sp2char (alias) - subpix (alias) - sumpix (alias) - wcshead (alias) - wcstools (alias) - xy2sky (alias) ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 3.9.7 - Local data: ok - Upstream repository: http://tdc-www.harvard.edu/wcstools/ - info: No package-manager update timestamp was available. - info: Release/tag comparison is only available for GitHub repositories. ## 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 - - - - - - ## Security Notes broad file, network, media, or database tool signal. - **Geiger risk:** blue / medium - broad file, network, media, or database tool signal ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** wcstools - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - Debian apt - iraf-wcstools - 3.9.7-1.1: normalized package name match | Debian stable package indexes: iraf-wcstools from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Handle the WCS of a FITS image (IRAF package) | http://tdc-www.harvard.edu/software/wcstools/ - Debian apt - libwcstools-dev - 3.9.7-1.1+b1: normalized package name match | Debian stable package indexes: libwcstools-dev from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Handle the WCS of a FITS image (development files) | http://tdc-www.harvard.edu/software/wcstools/ - Debian apt - libwcstools1t64 - 3.9.7-1.1+b1: normalized package name match | Debian stable package indexes: libwcstools1t64 from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Handle the WCS of a FITS image (shared library) | http://tdc-www.harvard.edu/software/wcstools/ - Debian apt - wcstools - 3.9.7-1.1+b1: normalized package name match | Debian stable package indexes: wcstools from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Handle the WCS of a FITS image | http://tdc-www.harvard.edu/software/wcstools/ - Ubuntu apt - iraf-wcstools - 3.9.7-1.1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: iraf-wcstools from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Handle the WCS of a FITS image (IRAF package) | http://tdc-www.harvard.edu/software/wcstools/ - Ubuntu apt - libwcstools-dev - 3.9.7-1.1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libwcstools-dev from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Handle the WCS of a FITS image (development files) | http://tdc-www.harvard.edu/software/wcstools/ - Ubuntu apt - libwcstools1t64 - 3.9.7-1.1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: libwcstools1t64 from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Handle the WCS of a FITS image (shared library) | http://tdc-www.harvard.edu/software/wcstools/ - Ubuntu apt - wcstools - 3.9.7-1.1build1: normalized package name match | Ubuntu 24.04 LTS package indexes: wcstools from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Handle the WCS of a FITS image | http://tdc-www.harvard.edu/software/wcstools/ - dnf - wcstools - 3.9.7-13.fc44: normalized package name match | Fedora Rawhide package metadata: wcstools from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Software utilities to display and manipulate the WCS of a FITS image | http://tdc-www.harvard.edu/wcstools - dnf - wcstools-devel - 3.9.7-13.fc44: normalized package name match | Fedora Rawhide package metadata: wcstools-devel from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Libraries, includes, etc. used to develop an application with wcstools | http://tdc-www.harvard.edu/wcstools - dnf - wcstools-libs - 3.9.7-13.fc44: normalized package name match | Fedora Rawhide package metadata: wcstools-libs from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Wcstools shared library | http://tdc-www.harvard.edu/wcstools - MacPorts - wcstools: normalized package name match | MacPorts ports tree: science/wcstools/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ## Related links - [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [Media and graphics packages](https://www.automicvault.com/pkg/media-graphics-tools/) - Matched media, image, audio, video, or graphics metadata. - [montage](https://www.automicvault.com/pkg/brew/montage/) - Shares av.db curated category or tags: astronomy, cli, fits, image-processing, science. - [wcslib](https://www.automicvault.com/pkg/brew/wcslib/) - Shares av.db curated category or tags: astronomy, cli, fits, science, wcs. - [ccfits](https://www.automicvault.com/pkg/brew/ccfits/) - Shares av.db curated category or tags: astronomy, cli, fits, science. - [cfitsio](https://www.automicvault.com/pkg/brew/cfitsio/) - Shares av.db curated category or tags: astronomy, cli, fits, science. - [gnuastro](https://www.automicvault.com/pkg/brew/gnuastro/) - Shares av.db curated category or tags: astronomy, cli, fits, science. - [siril](https://www.automicvault.com/pkg/brew/siril/) - Shares av.db curated category or tags: astronomy, cli, image-processing, science. - [calceph](https://www.automicvault.com/pkg/brew/calceph/) - Shares av.db curated category or tags: astronomy, cli, science. - [cdsclient](https://www.automicvault.com/pkg/brew/cdsclient/) - Shares av.db curated category or tags: astronomy, cli, science. ## Combined YAML source View the package source record on GitHub. [combined/wcstools.yml](https://github.com/automic-vault/db/blob/main/combined/wcstools.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph