3. Data requests
The Data Requests step asks: what data should we collect?
An observation can have one or more data requests, each describing one kind of acquisition. You add requests, pick the type of each, and tune that type’s settings. Each request row has a Duplicate button (adds a copy right below it, the usual way to make a second request that differs in one detail) and a Remove button.
You need at least one request before you can publish the observation.
Adding a request
Section titled “Adding a request”Click Add request to pick a type. There are three:
| Type | What it does |
|---|---|
| Optical imaging | Capture science frames through an optical imager. |
| Radio tracking | Point-and-integrate at the target with a radio dish. |
| Radio mapping | Raster- or daisy-scan a region with a radio dish. |
(Calibration frames — bias, dark, and flat — aren’t added here. The telescope’s scheduler produces the calibrations your data needs automatically.)
You can add several requests to one observation, and they don’t all have to be the same type. Requests keep the order you added them in; the editor has no control for reordering them.
Two places to set things
Section titled “Two places to set things”Each request type has settings in two places:
- On the request row — the per-request basics, set inline on each request.
- In the configuration dialog — the type’s constraints and parameters, opened with Configure in the Per-type configuration card below the requests (one entry per request type present, with a summary of its current settings). These apply to all requests of that type on the observation, so you set them once.
The split matters: you might add two optical-imaging requests with different filters and exposures (row settings), but they share one set of field-of-view, tiling, and sky-condition constraints (dialog settings). A new configuration starts from defaults (for optical imaging: minimum elevation 30°, Sun at least 18° below the horizon, sidereal tracking, one tile, no dithering, and a magnitude-19 point-source brightness model), so you only need to open the dialog to change something.
Optical imaging
Section titled “Optical imaging”On the request row
Section titled “On the request row”-
Kind — Images (each sample is one image, scheduled on its own) or Series (each sample is one contiguous run of images on one camera for a set Duration, in s, min or h; the camera fits as many images as its cadence allows).
-
Filters — one filter, or a named filter group (a group means any one of its member filters will do). A new request starts on the High Throughput group. To image through several filters, add one request per filter; Duplicate makes this quick.
-
Exposure — how each exposure is sized. Pick one of two:
- Fixed — an explicit exposure time in seconds, used as-is on every camera.
- Target SNR — aim for a target signal-to-noise; each camera sizes its exposure from the brightness model (configuration dialog → Brightness). The row names the brightness model it will use, or warns when there is none. New requests start in this mode at SNR 25.
These are alternatives, not layers. To stop a bright in-field source from blooming, set a Saturation model in the configuration dialog (below); that caps each frame’s exposure when the exposure is sized by signal-to-noise; a fixed exposure time is used as given. The API also accepts a third mode, a target fraction of full-well capacity (
targetFullWellFraction), which the editor doesn’t offer; see Exposure sizing. -
Samples — how many images (or series) to take per epoch.
A second Camera line holds what the camera may do to get there:
- Optimize for — Resolution (finest sampling) or Fastest readout (shorter dead time, higher cadence), used when the scheduler picks among the camera readout modes you accept.
- Subframe — let the camera window its readout to your field-of-view constraints, cutting readout time. It windows to the Max FOV, or down to the Min FOV when optimizing for fastest readout; without a Max FOV (or a Min FOV with fastest readout) it has no effect.
- Binning — allow a coarser binning mode where the camera offers one (shorter readout, higher SNR, coarser resolution), bounded by the pixel-scale and sampling constraints.
- Fast readout — allow a faster, noisier readout mode. Off keeps a low-noise mode.
When an instrument is picked in the instrument bar, a preview line under the row shows what that instrument would make of the request (filter, number of images, exposure and cadence), in red with the reason when it can’t run it.
In the configuration dialog
Section titled “In the configuration dialog”The optical-imaging dialog groups its settings into three tabs.
Observing Constraints — when the target may be observed. Each can be switched on or off:
- Min / Max Elevation — the target’s altitude above the horizon.
- Min / Max Sun Elevation — how high the Sun may be (for example, −18° for astronomical darkness).
- Max Moon Phase and Min Moon Separation.
Imaging Constraints — framing, tiling, pointing, and dithering:
- Field of View — Min FOV X/Y (arcmin, the field you need), Max FOV X/Y (arcmin, the ceiling a subframe may window to), Position Angle, optional Min/Max Pixel Scale (arcsec/px), and Min Sampling (pixels per FWHM of the site’s seeing). If the area you want is larger than one frame, the minimum FOV drives tiling.
- Max Tiles and Tile Overlap (a fraction, 0–1) — how many frames may be combined into a mosaic to cover the field.
- Pointing & Tracking — Tracking Mode Sidereal (track the stars) or Target (follow a moving solar-system object), a Recentering Threshold (%), and a Temporal Offset (s). The dialog also mirrors the target’s pointing offset X/Y, which is set on the Target step.
- Dithering — shift the pointing slightly between exposures to beat down hot pixels and artifacts; choose a strategy (None, Grid, Snake, Spiral, Cross, Jitter), the number of steps, the step size (°), and the pattern’s position angle.
Brightness — exposure-sizing models:
- Brightness Model — what the target looks like, used to size exposures in Target SNR mode. Choose Source (a magnitude, or a surface brightness for an extended source, in a reference filter, with optional A_V / R_V extinction), Sky (the local night-sky brightness, no parameters), or Not specified. A Source model can also carry:
- a Spectral shape — none (same magnitude in every filter), a power law, or a black body;
- a Time evolution from an event time — none (constant), power-law decay, exponential decay, or a Light-curve table of magnitude offsets by days from the event, interpolated linearly and held at the first and last values outside the table. You can add a separate table for another filter; a filter with its own table uses it instead of the reference curve and the spectral shape.
- Saturation Model — the brightest source you expect in the frame, used to cap exposure so it doesn’t bloom.
Radio tracking
Section titled “Radio tracking”A point-and-integrate observation: the dish stays on the target (or alternates on- and off-source) and integrates.
On the request row: Samples, the observation Duration (s), and a button that opens the request’s data dialog: the spectroscopy windows to record (each a center frequency and bandwidth in MHz, with presets), the Polarization requirement (Any, Linear, Circular), a Minimum Spectral Resolution, a Maximum Integration Time, the Data Record Mode (Spectrometer, Pulsar Search, Pulsar Fold), and whether continuum output is required.
Configuration dialog tabs:
- Observing Constraints — minimum target elevation, maximum Sun elevation, and minimum separation from the Sun.
- Tracking — the strategy (On, On / Off, or Off / On for background subtraction) and the offset to the off-source position, in degrees or beamwidths.
Radio mapping
Section titled “Radio mapping”A sweep that samples many pointings to build a map of a region.
On the request row: Samples and the data dialog: spectroscopy windows, Polarization, and Minimum Spectral Resolution.
Configuration dialog tabs:
- Observing Constraints — same elevation and Sun constraints as radio tracking.
- Mapping — the sweep pattern (Raster grid or Daisy), its size (raster size X/Y, or daisy diameter), the density between and along sweeps, the sweep direction, and whether depth is set by a per-point Integration Time or a continuous Slew Speed. Sizes can be given in degrees or beamwidths, in the coordinate frame you choose (equatorial, ecliptic, galactic, horizontal, or topocentric).
How many requests is enough?
Section titled “How many requests is enough?”Common patterns:
- One imaging request per filter — most optical workflows: B, V, R and I (or g, r, i) as four requests at the desired SNR, made by duplicating the first.
- Images plus a series — a few single images alongside a time series, on the same target without splitting into separate observations.
- One radio tracking + one radio mapping — an on/off integration for continuum context, plus a sweep for spatial structure.