SKYVIEW(1)

πŸ¦‹ SKYVIEW(1) πŸ¦‹

okay so bestie, this is the General Commands Manual page for SkyView, and it's a whole ✨moment✨. buckle up, we're gonna get you generating images from remote databases like the main character you are πŸ’…


🌈 NAME 🌈

SkyView β€” Image generation from a range of remote databases. periodt.


🌸 SYNOPSIS 🌸

skyview Survey=arg [key=arg ...]

πŸ’– DESCRIPTION πŸ’–

so basically, SkyView gives you a whole local SkyView system, like, on your own machine. your machine. your rules. iconic.

you can generate FITS, GIF, JPEG, ... images from major surveys in literally any geometry you want, resample and mosaic your own data, overlay grids and catalog positions, and β€” get this β€” create your own surveys. yes queen, build your own.


✨ OPTIONS ✨

heads up before we go any further: keys are NOT case sensitive, but values may be. so like, the key part is chill, the value part might not be. and when a value wants more than one thing, you separate them with a comma. easy.

valid keys include:

  • Survey β€” a survey you want an image of (think WENSS, DSS). this one is Required, with no default, so don't come crying to me when it yells at you. want multiple surveys? comma-separate them. survey names are not case sensitive. oh and the user survey references data given in the UserFile argument πŸ‘€
  • Settings β€” a list of one or more files to read settings from. lowkey important: file settings get processed after argument settings.

πŸŽ€ Keys that define the geometry of the output image. πŸŽ€

  • Position β€” the longitude and latitude of the center of the image. you can give it as coordinates or as a target name. [No default]
  • Lon β€” the decimal longitude of the center of the image. [No default]
  • Lat β€” the decimal latitude of the center of the image. [No default]
fr fr: either Position or Lon and Lat must be specified. you don't get to just… not say where. the sky is big bestie.
  • Coordinates β€” a string giving the coordinate system and epoch (if it's needed), e.g. J, J2000, B1950, ICRS, Gal, H2010.438. [J]
  • Equinox β€” epoch of equinox of coordinates. [2000]
  • Projection β€” the three letter FITS WCS specification of the projection. [Tan]
  • Scale β€” the pixels scale in degrees (may be one or two values). [survey dependent]
  • Size β€” the size of the entire image in degrees. [scale*pixels]
  • Pixels β€” the number of pixels in the image (may be one or two values). [300]
  • Rotation β€” a rotation angle in the projection plane. [0]
ngl, generally you specify either scale or size but not both. pick a lane πŸ’…

πŸ¦‹ Keys that control optional graphical outputs πŸ¦‹

  • Quicklook β€” the format you want for quicklook output. JPEG, GIF, BMP and TIFF are supported. and if you use another graphic keyword without specifying the format, it defaults to JPEG. generous of it honestly.
  • Scaling β€” how the output pixel intensities get scaled. Linear, Log, Sqrt, HistEq are supported. [Linear]
  • Min β€” set all smaller pixel values to this value before scaling.
  • Max β€” set all larger pixel values to this value before scaling.
  • RGB β€” create a three color overlay 🎨
  • RGBSmooth β€” box smoothing for planes of RGBImages
  • Invert β€” invert the color table response (or gray scale if no color lookup table is defined).
  • LUT β€” load a color lookup table. see the users guide for lists of internal color tables and files supplied in the JAR. user generated color tables may also be used.
  • Grid β€” plot a grid of the image or specified coordinate system as an image overlay.
  • GridLabels β€” label the grid lines with the coordinate entries.
  • PlotScale β€” scaling for plot symbols.
  • PlotFontSize β€” size of plot text in points.
  • PlotColor β€” color of plot graphics.

πŸ”₯ Catalog query keys πŸ”₯

  • Catalog β€” the names of the catalogs to be queried, or URLs that specify VOTable outputs.
  • CatalogFile β€” the name of a file in which to print the IDs, positions, and pixel locations of the catalog entries found.
  • CatalogRadius β€” a maximum radius from the center of the image for which catalog entries are desired.
  • CatalogQualifier β€” a qualification on a column of the returned table (e.g. vmag<10).
  • CatalogIDs β€” when plotting catalog positions, print the numeric ID of the catalog entry.

🧚 Keys that define the sampling used 🧚

  • Sampler β€” the sampling algorithm to be used. NN, LI, Lanczos[n], Spline[n], Clip. [NN]
  • Ebins β€” specification of sampling in energy dimension: e0,de,ne. [survey dependent for 3-d surveys]
    • e0 is the starting offset of the first output bin.
    • de is the width of the output bins (relative to the input).
    • n is th number of output bins.

πŸ’œ Keys that set characteristics of the output FITS file πŸ’œ

  • Output β€” the output file stem. [output]
  • Compress β€” if specified, the output is gzip compressed.
  • Float β€” if specified, the output is 4 byte rather than 8 byte real.
  • NoFITS β€” a FITS file should not be produced.

🌸 Smoothing 🌸

  • Smooth β€” a box size (or sizes for non-square box) for a box car smoothing.

🌈 Contours 🌈

  • Contour β€” create a contour map overlay.
  • ContourSmooth β€” smoothing to be applied to survey before contouring.

πŸ“ Keys that set where to look for survey and store survey data. πŸ“

  • XMLRoot β€” a directory of XML files that contain survey descriptions.
  • SurveyManifest β€” overrides the name of the resource used to look for the survey manifest (normally included in JAR).
  • SurveyXML β€” a file or files giving XML descriptions of surveys.
  • UserFile β€” a file (or list of files) that defines the User survey. these are the actual survey images, not survey metadata. important distinction, don't mix them up.
  • Cache β€” a directory (or comma delimited set of directories) where cached files are to be found. the first cache directory is where survey files used in this request will be saved.
  • PurgeCache β€” delete any survey files downloaded in this request.

⭐ Keys that define the classes used for processing the request. ⭐

  • Deedger β€” class that eliminates transitions at input image boundaries.
  • SurveyFinder β€” class that loads and finds surveys given survey names/IDs.
  • ImageFinder β€” class that finds images in a survey to use in a mosaic.
  • PreProcessor β€” class[es] to process input images before resampling.
  • Mosaicker β€” class that actually mosaics survey data to create output image.
  • PostProcessor β€” class[es] that process the output image after mosaicking.

🫢 Keys that change the behavior of the process. 🫢

  • ImageJ β€” leave an ImageJ session running with the generated images when finished.

πŸŽ€ Available surveys (including all aliases) πŸŽ€

Okay so this is the part where the page just dumps the entire guest list on you πŸ’… and honestly? iconic. Every survey name plus every single alias that maps to it β€” spaces, dashes, underscores, colons, parentheses, all of it. You cannot freestyle this, bestie. The aliases are not guessable, so treat this as your lookup table and copy-paste like your life depends on it 🫢

Heads up: I'm keeping every name character-for-character exactly as written, including the double spaces in a couple of them (iras 100, iris 100 vibes). One wrong character and it's just not the same name, no cap πŸ’€

Let's go, group by group 🌸

The low-frequency / 2MASS / AKARI girlies β€” look at all those spellings of the same thing, we love a flexible queen ✨

0035mhz, 0408mhz, 1420mhz, 1420mhz (bonn), 2mass-h
2mass-j, 2mass-k, 2massh, 2massj, 2massk, 35mhz, 408mhz
4850mhz, 4mass, akari n160, akari n60, akari wide-l
akari wide-s, akari-n160, akari-n60, akari-wide-l
akari-wide-s, akari_n160, akari_n60, akari_wide-l

BAT nation πŸ”₯ β€” flux versions, snr versions, and then dash-versions of both, because why have one naming convention when you can have three 😭

bat flux 1, bat flux 100-150, bat flux 14-20
bat flux 150-195, bat flux 2, bat flux 20-24, bat flux 24-35
bat flux 3, bat flux 35-50, bat flux 4, bat flux 5
bat flux 50-75, bat flux 6, bat flux 7, bat flux 75-100
bat flux 8, bat snr 1, bat snr 100-150, bat snr 14-195
bat snr 14-20, bat snr 150-195, bat snr 2, bat snr 20-24
bat snr 24-35, bat snr 3, bat snr 35-50, bat snr 4
bat snr 5, bat snr 50-75, bat snr 6, bat snr 7, bat snr 75-100
bat snr 8, bat snr sum, bat-flux-1, bat-flux-2, bat-flux-3
bat-flux-4, bat-flux-5, bat-flux-6, bat-flux-7, bat-flux-8
bat-snr-1, bat-snr-2, bat-snr-3, bat-snr-4, bat-snr-5
bat-snr-6, bat-snr-7, bat-snr-8, bat-snr-sum, cdfs less

DSS / EGRET / EUVE / Fermi / GALEX era πŸ¦‹ β€” we got colons, we got parentheses, we got angle brackets, we got full phrases as names. The range is unmatched πŸ’œ

cdfs: less, cgro comptel, co, co2d, cobe dirbe/aam
cobe dirbe/zsma, cobeaam, cobezsma, comptel, digitized sky survey
dss, dss1 blue, dss1 red, dss1b, dss1r, dss2 blue
dss2 ir, dss2 red, dss2b, dss2ir, dss2r, dssold, ebhis
ebhis(nhi), egret (3d), egret <100 mev, egret >100 mev
egret(3d), egret1000, egret30, egret3d, egrethard
egretsoft, euve 171 a, euve 405 a, euve 555 a, euve 83 a
euve171, euve405, euve555, euve83, fermi 1, fermi 2
fermi 3, fermi 4, fermi 5, fermi band 1, fermi band 2
fermi band 3, fermi band 4, fermi band 5, fermi1, fermi2
fermi3, fermi4, fermi5, first, galex far uv, galex near uv
galexfar, galexnear, gb6, gb6 (4850mhz), gb6/pmn, geetee

GOODS, the main character πŸ‘‘ β€” genuinely so many aliases for these. Spaced version, colon version, underscore version, no-separator version. She contains multitudes 🌈

gns, goods acis fb, goods acis hb, goods acis sb, goods acs b
goods acs i, goods acs v, goods acs z, goods herschel 100
goods herschel 160, goods herschel 250, goods herschel 350
goods herschel 500, goods irac 1, goods irac 2, goods irac 3
goods irac 3.6, goods irac 4, goods irac 4.5, goods irac 5.8
goods irac 8.0, goods isaac h, goods isaac j, goods isaac ks
goods mips, goods n vla, goods vimos r, goods vimos u
goods: chandra acis fb, goods: chandra acis hb, goods: chandra acis sb
goods: herschel 100, goods: herschel 160, goods: herschel 250
goods: herschel 350, goods: herschel 500, goods: hst acs b
goods: hst acs i, goods: hst acs v, goods: hst acs z
goods: hst nicmos, goods: spitzer irac 3.6, goods: spitzer irac 4.5
goods: spitzer irac 5.8, goods: spitzer irac 8.0, goods: spitzer mips
goods: spitzer mips 24, goods: vla north, goods: vlt isaac h
goods: vlt isaac j, goods: vlt isaac ks, goods: vlt vimos r
goods: vlt vimos u, goods_acs_b, goods_acs_i, goods_acs_v
goods_acs_z, goodsacisfb, goodsacishb, goodsacissb
goodsherschel1, goodsherschel2, goodsherschel3, goodsherschel4
goodsherschel5, goodsirac 1, goodsirac 2, goodsirac 3
goodsirac 4, goodsmips, goodsnicmos, goodsnvla

Granat / Gtee / H-alpha / Hawaii / HEAO / HI 🌸 β€” the h-alpha family alone has four spellings and I respect the commitment πŸ’–

granat/sigma, granat/sigma flux, granat/sigma sig, granat_sigma_flux
granat_sigma_sig, gtee, gtee 35mhz, h-alpha, h-alpha comp
h-alpha composite, halpha, halpha/comp, hawaii hdf b
hawaii hdf i, hawaii hdf r, hawaii hdf u, hawaii hdf v0201
hawaii hdf v0401, hawaii hdf z, hawaii: hdf b, hawaii: hdf i
hawaii: hdf r, hawaii: hdf u, hawaii: hdf v0201, hawaii: hdf v0401
hawaii: hdf z, heao 1 a-2, heao1a, hi map, hi4pi, hi4pi(nhi)

INTEGRAL / IRAS / IRIS / Mellinger ⭐ β€” watch out for those iras 100 and iris 100 double spaces, they are NOT a typo, they are the whole personality πŸ™ˆ

hri, hriint, hudf: vlt isaac ks, hudfisaac, int gal 17-35 exp
int gal 17-35 flux, int gal 17-35 sig, int gal 17-60 exp
int gal 17-60 flux, int gal 17-60 sig, int gal 35-80 exp
int gal 35-80 flux, int gal 35-80 sig, integral/spi gc
integralspi_gc, intgal1735e, intgal1735f, intgal1735s
intgal1760e, intgal1760f, intgal1760s, intgal3580e
intgal3580f, intgal3580s, iras  100, iras  12, iras  25
iras  60, iras 100, iras 100 micron, iras 12, iras 12 micron
iras 25, iras 25 micron, iras 60, iras 60 micron, iras100
iras12, iras25, iras60, iris  100, iris  12, iris  25
iris  60, iris 100, iris 100 micron, iris 12, iris 12 micron
iris 25, iris 25 micron, iris 60, iris 60 micron, iris100
iris12, iris25, iris60, mell-b, mell-g, mell-r, mellinger blue

Mellinger / NVSS / Planck / PMN / PSPC 🧚 β€” the Planck family comes in space-separated, dash-separated AND glued-together flavors. Ate. πŸ’…

mellinger green, mellinger red, mellinger-b, mellinger-g
mellinger-r, n-vss, neat, neat/skymorph, nh, nvss
planck 030, planck 044, planck 070, planck 100, planck 143
planck 217, planck 353, planck 545, planck 857, planck-030
planck-044, planck-070, planck-100, planck-143, planck-217
planck-353, planck-545, planck-857, planck030, planck044
planck070, planck100, planck143, planck217, planck353
planck545, planck857, pmn, pspc 0.6 deg-cnt, pspc 0.6 deg-counts
pspc 0.6 deg-exp, pspc 0.6 deg-expos, pspc 0.6 deg-int
pspc 0.6 deg-inten, pspc 1.0 deg-cnt, pspc 1.0 deg-counts
pspc 1.0 deg-exp, pspc 1.0 deg-expos, pspc 1.0 deg-int
pspc 1.0 deg-inten, pspc 2.0 deg-cnt, pspc 2.0 deg-counts
pspc 2.0 deg-exp, pspc 2.0 deg-expos, pspc 2.0 deg-int
pspc 2.0 deg-inten, pspc0.6cnt, pspc0.6exp, pspc0.6int
pspc1cnt, pspc1exp, pspc1int, pspc2cnt, pspc2exp, pspc2int

RASS / ROSAT / RXTE πŸ’€ β€” rass, rassback, rassbck, rasscnt, rassint, and every abbreviation of every abbreviation. This is a lot, and yet every one of them is a real name you might need. Periodt.

rass, rass background 1, rass background 2, rass background 3
rass background 4, rass background 5, rass background 6
rass background 7, rass broad, rass hard, rass soft
rass-cnt broad, rass-cnt hard, rass-cnt soft, rass-int broad
rass-int hard, rass-int soft, rass3bb, rass3hb, rass3sb
rassback1, rassback2, rassback3, rassback4, rassback5
rassback6, rassback7, rassbb, rassbbc, rassbbi, rassbck1
rassbck2, rassbck3, rassbck4, rassbck5, rassbck6, rassbck7
rasscnt bb, rasscnt hb, rasscnt sb, rasshb, rasshbc
rasshbi, rassint bb, rassint hb, rassint sb, rasssb
rasssbc, rasssbi, rosat wfc f1, rosat wfc f2, rxte allsky 3-20kev

The grand finale: RXTE β†’ SDSS β†’ SFD β†’ SHASSA β†’ STRIPE 82 β†’ SUMSS β†’ TGSS β†’ UKIDSS β†’ VLA β†’ VLSS β†’ WENSS β†’ WISE β†’ WMAP ✨🌈 β€” closing out the list strong, with vla first (1.4 ghz) serving parentheses realness and WMAP going out on a run of glued-together aliases. No notes. 😭

rxte allsky 3-20kev flux, rxte allsky 3-20kev sig
rxte allsky 3-8kev, rxte allsky 3-8kev flux, rxte allsky 3-8kev sig
rxte allsky 8-20kev, rxte allsky 8-20kev flux, rxte allsky 8-20kev sig
rxte3_20k_flux, rxte3_20k_sig, rxte3_8k_flux, rxte3_8k_sig
rxte8_20k_flux, rxte8_20k_sig, sdss g, sdss i, sdss r
sdss u, sdss z, sdssdr7 g, sdssdr7 i, sdssdr7 r, sdssdr7 u
sdssdr7 z, sdssdr7g, sdssdr7i, sdssdr7r, sdssdr7u
sdssdr7z, sdssg, sdssi, sdssr, sdssu, sdssz, sfd 100 micron
sfd 100m, sfd dust, sfd dust map, sfd100m, sfddust
shassa c, shassa cc, shassa h, shassa sm, shassa-c
shassa-cc, shassa-h, shassa-sm, shassa_c, shassa_cc
shassa_h, shassa_sm, stripe 82 vla, stripe82vla, sumss
sumss 843 mhz, tgss, tgss adr1, tgss_adr1, ukidss h
ukidss j, ukidss k, ukidss y, ukidss-h, ukidss-j, ukidss-k
ukidss-y, ukidssh, ukidssj, ukidssk, ukidssy, vla first (1.4 ghz)
vlss, vlssr, w-nss, wenss, wfcf1, wfcf2, wise 12, wise 22
wise 3.4, wise 4.6, wise w1, wise w2, wise w3, wise w4
wise12, wise22, wise3.4, wise4.6, wisew1, wisew2, wisew3
wisew4, wmap, wmap ilc, wmap k, wmap ka, wmap q, wmap v
wmap w, wmap-k, wmap-ka, wmap-q, wmap-v, wmap-w, wmapilc
wmapk, wmapka, wmapq, wmapv, wmapw

Bestie, that's the whole list. If you need one of these, scroll back up and copy it β€” do not try to recall it from memory, I am begging πŸ™

And that's a wrap on SKYVIEW(1) πŸ’– this page is dated 17 Dec 2016 and it's the SKYVIEW(1) man page, so if you're citing it or checking the version, that's the tea β˜• go be great, you've got this 🌟

πŸ“¦ where this page comes from