sat.1

.\" Automatically generated by Pandoc 2.2.1
.\"
.TH "sat" "1" "" "" "General Commands Manual"
.hy
.SH NAME
.PP
sat \- Retrieves near\-real\-time NOAA GOES weather satellite imagery.
.SH SYNOPSIS
.PP
\f[C]sat\ SITE\ IMAGERY_PRODUCT\ [\-i]\ [\-u]\f[]
.SH DESCRIPTION
.PP
sat is a tool that searches for imagery of a slice of the Western
hemisphere as viewed by the GOES\-East and GOES\-West satellites, then
retrieves one of 5 different imagery products: black & white infrared,
color infrared, visible light, water vapor, or a composite of water
vapor and black & white infrared.
.SH OPTIONS
.TP
.B \f[C]SITE\f[]
GOES satellites really image an entire hemisphere at once, but weather
information customers are usually interested in smaller regions.
The full\-disk GOES image is divided into slices centered on certain
geographical regions or features.
SITE is the geographical region or feature that the view is centered on.
May be one of the following:
.RS
.RE
.IP
.nf
\f[C]
abq\ Albuquerque,\ NM
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
ak\ \ Alaska
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
alb\ Albany,\ NY
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
aus\ Austin,\ TX
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
bwi\ Baltimore,\ MD
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
carib\ \ \ Caribbean
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
clt\ Charlotte,\ NC
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
cod\ Yellowstone
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
den\ Denver,\ CO
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
dtw\ Detroit,\ MI
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
evv\ Evansville,\ ID
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
gulf\ \ \ \ Gulf\ of\ Mexico
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
hi\ \ Hawaii
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
ict\ Wichita,\ KS
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
las\ Las\ Vegas,\ NV
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
lit\ Little\ Rock,\ AR
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
lws\ Leniston,\ ID
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
mgm\ Montgomery,\ AL
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
msp\ Minneapolis,\ MN
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
pir\ Pierre,\ SD
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
tpa\ Tampa,\ FL
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
wmc\ Winnemacca,\ NV
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
us\ \ Contiguous\ United\ States
\f[]
.fi
.RS
.RE
.TP
.B \f[C]IMAGERY_PRODUCT\f[]
GOES satellites have instruments that collect across several spectral
bands in both visible light and infrared.
IMAGERY_PRODUCT specifies which spectral band you want to see imagery
from.
May be one of the following:
.RS
.RE
.IP
.nf
\f[C]
irbw\ \ \ \ Infrared\ (black\ &\ white)
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
ircol\ \ \ Infrared\ (color)
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
irnws\ \ \ Composite\ of\ infrared\ and\ water\ vapor
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
vis\ Visible\ light\ (site\ must\ be\ in\ daylight)
\f[]
.fi
.RS
.RE
.IP
.nf
\f[C]
wv\ \ Water\ vapor
\f[]
.fi
.RS
.RE
.TP
.B \f[C]\-i,\-\-interactive\f[]
Requires \f[C]dmenu(1).\f[] Allows interactive fuzzy\-search input
rather than manually typing sites and imagery codes.
.RS
.RE
.TP
.B \f[C]\-u,\-\-url\f[]
Just print the URL of the image to stdout rather than opening it with
mpv.
.RS
.RE
.SH BUGS
.PP
Report any bugs to ray\@raypatrick.xyz.
.SH AUTHOR
.PP
Written 2021 by Ray Patrick.
.SH SEE ALSO
.PP
\f[C]dmenu(1)\f[]