Using the website

Search, read a light curve, fold it, and share exactly what you see. Every view is a URL.

API 3.1 · stars release 55c97bc0c218a6c5 · SS release ef7caf53a399bc1f

The search box is on every page. Choose Stars or Solar System on the home page, or leave the scope on automatic and let the box decide. It recognises these forms:

FormExamplesResult
Coordinates, decimal or sexagesimal133.7036 20.1085, 08:54:48.9 +20:06:30.6, 08h54m48.9s +20d06m30.6sCone search, 60″ by default
Coordinates with a radius… r=30", … 1', … 0.01d, or a third number in arcsecCone search with that radius
AV3 nameAV3_085448.87+200630.6That star
V3 idsp3:11010359, V3 11010359That star
Gaia idGaia DR3 660820614442429056, Gaia DR2 …, DR3 …, GDR2 …, or a bare 15–19 digit idThe matched V3 star (DR3 first, then DR2 when no release is named). A Gaia source without a V3 star is looked up with Sesame and searched by position
Bare integer20A star id in Stars, an asteroid number in Solar System; both are offered in automatic scope
Asteroids and comets(20) Massalia, Massalia, 2004 MN4, 2P, 2P/Encke, C/2020 F3, 29P, packed designationsThe object page, or a list when the name is ambiguous
Any other nameOJ 287, SS Cyg, U GemLooked up with Sesame

Solar-system names complete as you type. The first suggestions come from a list of popular names that the page loads when the box first gets focus; the server's matches follow a moment later. Star names are looked up only when you press Enter.

Star names and Sesame#

Your browser sends a star name directly to the CDS Sesame name resolver. It asks three mirrors (CfA, IDIA and CDS) at once and uses the first answer. The Sky Patrol server never sees the name. Then the page:

  1. moves the Sesame position to the catalog epoch 2015.5 with the object's proper motion;
  2. runs a 10″ cone search;
  3. opens the star page if exactly one V3 star lies within 3″, and otherwise shows the 60″ results with the Sesame position marked.

Error messages say what went wrong, for example No V3 stars within 60″ (nearest 74″, g = 17.1) or Name resolver unreachable; enter coordinates.

Cone results#

The results table lists each star's name and id, separation, coordinates, reference g magnitude, number of epochs in g and V, and number of fields. Click a column header to sort. The footer shows the query time, the serve_id and a CSV export. On wide screens a sky image with the result circles sits beside the table; on phones, tap Show on sky.

Star page#

The header gives the star's name, V3 id, coordinates (ICRS, epoch 2015.5), proper motion and reference g magnitude, with links to SIMBAD and VizieR at those coordinates and chips with the star's Gaia DR3 and DR2 ids (each links to the Gaia row in VizieR; hover for the separation and match quality). The Provenance & citation tab repeats the Gaia ids with a copy button, the separations and the Gaia G magnitude. The stat cards show the number of epochs per band, the time baseline, the median and RMS per band, and how many flagged points are hidden.

The light-curve panel has three views:

Time
Magnitude or flux against BJD − 2450000, with calendar years along the top.
Phase
The curve folded on a period you choose, shown over two cycles. You can type the period, nudge it, double or halve it, and set t0 to the time of maximum.
Periodogram
A fast Lomb-Scargle periodogram that runs in the background and can be cancelled. Click one of the five highest peaks to fold on it. The 1 cycle/day and 1 cycle/year aliases are marked.

The toolbar has band chips with point counts, a limits toggle, the Flags menu, an aperture menu (only apertures measured for this star), a magnitude/flux toggle and the download menu.

Reading the plot#

Flags menu#

The website starts with the Recommended view, which hides points with any of the bits in 0x17 (bad pixel, saturated, image not marked good, negative pixel). The menu shows how many points each bit hides and offers three presets:

PresetHides (hide=)Use it for
Recommended0x17A clean first look. This is the website default.
Strict0x1F7FEvery bit except NEAR_CHIP_CORNER. Each of the five decile bits marks about 10% of a long curve, so Strict hides many more points.
All0Everything, as the API returns it by default.

The website default (hide 0x17) is waiting for Ben's approval. The API default hides nothing.

The quality flags page explains every bit.

Downloads#

The download menu fetches the current selection from the API as CSV, ECSV, JSON or Parquet. It can also apply the flags you have hidden as exclude_quality, save the plot as a PNG, give you a Python snippet for the same request, or copy a link to the view. The Provenance & citation tab lists the release id, serve_id and the text to cite.

Tabs below the plot#

Measurements
Every row of the light curve. Selecting a row highlights its point and clicking a point scrolls to its row. Flag chips explain each bit.
Fields & cameras
The ASAS-SN fields and cameras that observed the star.
Provenance & citation
Release ids, decoder version and citation text.

Solar-system pages#

The Solar System landing page has the search box, featured objects and the objects you viewed recently. An object page shows its name, orbit class, orbital elements (a, e, i), H and G, other names, and links to JPL SBDB and the MPC.

The light-curve panel has three views:

Observed
Magnitude against JD − 2450000 (UTC).
Phase curve
The reduced magnitude m − 5 log10(rΔ) against phase angle α, with an H, G fit. For comets the page plots m − 5 log10Δ against r instead.
Residuals
Observed minus the H, G model against time.

Controls choose the bands, the product (reduced images as filled points, difference images as rings), the aperture (six radii from 0.75 to 3 pixels) and the light-time correction. Notes about the object, such as blend or comet warnings, appear above the plot. The solar-system data page explains these choices.

The orbit panel draws the Sun, the planets, Earth, the object's orbit and the line of sight for each night it was observed, seen from the top, tilted or edge-on. The timeline below works as a slider and can play the observations in order. Hovering over the light curve, the orbit or the sky panel highlights the same night in the other two.

The tabs below are Measurements, Observing geometry (r, Δ, α and solar elongation against time, with low-elongation periods shaded), Notes and Citation.

Sky panel#

The sky panel uses Aladin Lite with Pan-STARRS images north of Dec −29.5° and DSS2 elsewhere, in a 4′ field. It loads after the light curve, and on phones only when you tap it. A star page marks the target, the ASAS-SN apertures (8″ per pixel) and neighbouring V3 stars, which you can click. A solar-system page draws the object's track coloured by time. If the image servers fail, the panel says so and offers a retry; the overlays keep working.

URL parameters#

Every control updates the URL, so a link or a bookmark reopens the same view. Parameters you leave out take their defaults.

Star pages: /star/<star_id>#

ParameterValuesMeaning
bg,VBands shown
ap1, 1.5, 2, 3Aperture radius in pixels (default: the star's default aperture)
hidebit mask, e.g. 0x17Quality bits to hide
lim1 or 0Show upper limits
ymag, fluxy axis
xtime, phase, pgramView
P, t0, cycdays, BJD, cycles (default 2)Phase-fold period, epoch and number of cycles
zx0,x1,y0,y1Zoom
qtextThe name to display, for example the name you searched for

An AV3 name in the path, such as /star/AV3_085448.87+200630.6, is replaced by the id. Cone results live at /stars?ra=&dec=&r= (with q= when the search started from a name), so reloading the page does not repeat the name lookup.

Solar-system pages: /ss/<slug>#

ParameterValuesMeaning
bg,VBands shown
prodauto, red, convProduct: reduced or difference images
ap0.75 … 3Aperture radius in pixels
rowsall, detected, recommendedRows shown
hidebit maskQuality bits to hide
xtime, phase, residView
lt1Plot light-time-corrected emission times
tJDTime shown by the orbit panel
viewtop, tilted, edgeOrbit view
zx0,x1,y0,y1Zoom

Slugs are the number for numbered asteroids (20), the designation with underscores for comets and unnumbered objects (2P, C_2020_F3, 2019_AB1), or id-<object_id>.

Plot controls#

ActionMouse or touch
Zoom to a boxDrag; hold Alt to zoom in time only
ZoomMouse wheel or pinch
PanShift + drag
ResetDouble-click
Read a pointHover or tap to read its values

Keyboard shortcuts#

KeysWhereAction
/Any pageGo to the search box
↑ ↓ EnterSuggestions and resultsMove and open
[ ]Star page opened from resultsPrevious or next result
EscMenus and panelsClose
Arrow keysFocused plotMove the point cursor; the readout is announced to screen readers

The plot also has a text summary, and the Measurements table holds the same data for anyone who cannot use the plot.

Privacy#

The service records IP addresses, approximate geographic locations and requested sky coordinates in private operational logs. Accounts use secure session and CSRF cookies. Your browser also stores the colour theme, dismissed banners, recently viewed objects and the fastest image mirror. Account actions and data queries go to this service; star-name searches go to Sesame, and sky images come from the image servers. See About.