Download

Download requests are of the form:

https://skynet.unc.edu/download/<dataformat>[?<arg>&<arg>=<value>&...]

data_format can be one of the following types:

Data Format
Description

png

PNG image

jpg

JPG image

fits

FITS image

header

Image header

Download an Optical Image

GET/download/<data_format>

Downloads a byte string representation of the request data format optical image.

Headers

Name
Value

Authentication-Token

<token>

Body

Name
Type
Description

image | images

string

Requested optical image ID(s). An image ID consists of a single-character image type identifier, followed by an image ID number.

'r': Raw Exposure

'm': Master Calibration Image

'w': Afterglow Workspace Image

't': Afterglow Temp Image

's': Afterglow Sample Image

obs | observations

string

Requested optical observation ID(s)

layer

int | string

For multi-HDU observations (e.g. polarimetry, spectral, or radio), return specific layer (0-based)

wcs

int

Only images with world coordinate system in their headers will be returned

filter

string

Only images taken with the specified optical filter will be returned

explen

string | float

Only images taken with the specified exposure length (seconds) will be returned

reduce

int

Bias, dark, and flat correct the requested image(s)

reducequiet

int

Same as "reduce" except that in the event of a failure during reduction the unreduced image is returned

delta

float | string

Maximum separation (in days) allowed between master calibration images and the source image during reduction

mbias

int | string

Override the auto-selection of master bias to be used in calibration by specifying its ID. Presence of this variable will automatically add the option "reduce". If set to 0, this type of calibration will not be applied.

mdark

int | string

Override the auto-selection of master dark to be used in calibration by specifying its ID. Presence of this variable will automatically add the option "reduce". If set to 0, this type of calibration will not be applied.

mflat

int | string

Override the auto-selection of master flat to be used in calibration by specifying its ID. Presence of this variable will automatically add the option "reduce". If set to 0, this type of calibration will not be applied.

remove_cosmics

int

Remove cosmic rays from the images

find_cosmics

int

Return images containing only cosmic rays present in the original images

bin

float

Uniform software binning factor

hbin

float

Horizontal software binning factor

vbin

float

Vertical software binning factor

scale

float

Scale images by the given factor

width

float

Scale images to the given width

height

float

Scale images to the given height

norm_orient

int

Normalize image orientation based on the WCS, flipping it vertically and/or horizontally and swapping the axes to make sure that it is as close as possible to North up, East left.

horiz_flip

int

Flip images horizontally

vert_flip

int

Flip images vertically

swap

int

Swap image axes

force_int

int

FITS only

Convert FITS images returned to unsigned 16 bit.

min

float

Specifies the lower percentile of the histogram used to set the black point of the image; mutually exclusive with min_adu and max_adu.

max

float

Specifies the upper percentile of the histogram used to set the white point of the image; mutually exclusive with min_adu and max_adu.

min_adu

float

Specifies the ADU corresponding to the black point of the image; mutually exclusive with min and max.

max_adu

flaot

Specifies the ADU corresponding to the white point of the image; mutually exclusive with min and max.

cmap

Produce a false-color image; should be one of the colormap names supported by matplotlib; default: "gray" (produce a grayscale image)

quality

JPG only

Quality of JPEG compression

Download a Radio Image

GET/download/<data_format>

Downloads a byte string representation of the requested data format radio image.

Headers

Name
Value

Authentication-Token

<token>

Body

Name
Type
Description

image | images

string

Requested optical image ID(s). An image ID consists of a single-character image type identifier, followed by an image ID number.

'r': Raw Exposure

'm': Master Calibration Image

'w': Afterglow Workspace Image

't': Afterglow Temp Image

's': Afterglow Sample Image

radio_obs

string

Radio observation ID(s)

layer

int | string

For multi-HDU observations (e.g. polarimetry, spectral, or radio), return specific layer (0-based)

processed

int

Return specific radio cartographer channel(s). Radio observations only.

channel

string

If "processed" is set, return the given radio cartographer channel (left, right, or composite). Radio observations only.

Example URLs

Last updated