KHONSUFIND WHAT TIME REVEALS

Your field guide
to Khonsu.

Start with a patch of sky, move between real observations, and keep a record of what catches your eye. You do not need an astronomy background.

Choose Guided mode in the console for a seven-step tour. You can minimize it while trying a control, move back and forward, exit with Escape, and replay it whenever you want.

A five-minute first look

  1. Choose Explore the sky on the homepage. The original Khonsu introduction plays for about three seconds. Skip it at any time. It runs only on entry; searches and frame changes use ordinary status feedback.
  2. The saved WISE 0855 field opens with three authentic observations. Check the displayed UTC date. The field name does not mean the brown dwarf has been detected in these images.
  3. Choose Next, then Previous. Drag the amber time handle, or press Play. Look for changes while remembering that noise and different blur can also change appearances.
  4. Open Display and compare Clean View with Show original. Then open Notes, type what you noticed and choose Save observation note.
  5. Wait for the notebook save message. Export notebook to keep a portable copy. Choose Share to copy the field coordinates; private notes are not included.

Find the controls

The image occupies the central workspace. The tool strip selects Rewind, Pan, Mark and Inspect. Time and A/B controls stay at the bottom. The inspector contains six sections:

SectionUse it for
FieldCoordinates, field of view, named targets, live searches and saved examples.
DisplayClean View, original pixels, refinement and advanced contrast settings.
LayersQuality, candidate marks, Gaia sources and WISE reference context.
CompareChoose observations A and B and inspect comparison options.
NotesWrite observation notes, save marked candidates, edit and export your notebook.
InfoActual dates, wavelengths, source data, processing and limitations.

On a smaller screen, choose Controls to open the inspector. Its contents scroll internally. Close it to work on the image. Fit shows the entire field; Fill uses more of the workspace by cropping the edges. Neither stretches the sky.

Explore time

The dots represent actual observation dates. Unequal gaps represent unequal intervals; dates are not a continuous video. Dragging follows your pointer immediately, then the handle settles onto the selected date. The displayed frame always comes from a real observation.

Play steps through the available images at the chosen rate. Pause before making a mark. A single usable observation can still be inspected, but it cannot demonstrate change over time. Keyboard selection is immediate, without spring motion.

Read the images honestly

SPHEREx measures infrared light. Its native angular sampling limits the detail in each field. A larger display or a powerful GPU can make viewing smoother, but cannot supply finer measurements that the telescope did not record.

Clean View may estimate eligible missing areas for a more continuous appearance. Show estimated areas reveals where those display guesses were used; Show original restores the measured data and its gaps. Refinement changes presentation, not the scientific record.

Missing pixels, contamination, saturation, wavelength differences and alignment residuals can mimic change. A candidate mark always retains original validity, even when its location looks filled in Clean View. A filled region is not evidence for a source.

Keep a notebook

  1. Open Notes and type in Observation note. Save observation note works without a marked position. With a sequence loaded, it captures that sequence and the displayed frame. Otherwise it becomes a workspace note.
  2. For a specific point, choose Mark a location, select the image, then save a candidate note. The mark stores the original grid position, any supported ICRS conversion, time and quality. Choose Write a field note to return to a general note.
  3. Use Edit, Export or Delete beside a saved observation note. Candidate notes have their own edit/export controls. Deletion updates the browser and the database when connected.
  4. Export notebook includes observation notes plus candidate evidence. Export all saved candidates creates the existing candidate evidence format. Both exclude your private notebook access key.

Observation notes allow up to 2,000 characters; candidate notes allow 500. Each category is limited to 200 records. Large sequence snapshots can reach the storage limit earlier. Export and remove older entries if the app reports capacity or quota limits.

Layers and comparison

Candidate marks and labels refer to your own saved records. Quality overlays describe validity and contamination. Hiding an overlay does not restore missing measurements.

Gaia markers add known-source context on the shared sky grid. WISE opens a separate infrared reference view. These may load from independent services. A failure in either should leave SPHEREx playback available.

In Compare, choose A and B, then blink or hold for B. Check their actual dates and wavelength context. Coadded or difference views, when available, are derived products: read their labels and quality before interpreting apparent motion or brightness.

Keyboard and accessibility

WhereAction
AnywhereTab moves between controls; Enter or Space activates a focused button.
Focused time sliderArrow keys select adjacent observations; Home and End select the first and last.
Focused imageArrows operate the selected tool. Space plays or pauses; + and - zoom; 0 fits the field.
Mark tool on the imageMove the cursor with arrows, then Enter to select a position.
Intro, tour or dialogEscape dismisses it. Exit returns focus to the launching control where available.

Reduced-motion preferences skip the entry sweep and spring movement and show the landing story vertically. Simple View on the homepage also disables the pinned story. At 200% zoom, internal or page scrolling keeps controls reachable.

Testing checklist

  1. Open the saved field and confirm the image, date and Info metadata agree. Step through all three observations.
  2. Try Fit, Fill, Pan and zoom. Make a candidate mark and confirm it stays at the same sky position while the view changes.
  3. Switch Clean View and Show original. Inspect an estimated or masked area and verify its original validity is still reported.
  4. Write an observation note without marking. Edit it, reload, and confirm the saved text remains. Export and inspect the JSON file.
  5. Save a candidate note and verify its evidence includes dates, coordinates or qualified pixel positions, quality and source references.
  6. Open Guided mode, advance all steps and exit with Escape. Test the same flow in Chrome or Firefox and at a narrow viewport.
  7. Search a named field and watch the real status stages. Cancel once, then retry. A missing-coverage or archive-failure message is an honest result, not a detection.
  8. For Docker persistence, restart the API after saving. Reload the same browser and confirm the notebook returns. Do not remove the notebook volume.

Troubleshooting

The image is still coarse or contains gaps

Check Info for native dimensions and quality. Clean View can soften the presentation of eligible gaps; it cannot recover unknown measurements. Try a larger field to see more sky, not to create finer telescope resolution.

The archive search is slow or failed

Use Cancel, edit the field or retry. Test the saved real example to separate archive availability from viewer behavior. Do not leave a previous image labelled as a new result.

My notebook says offline or conflict

Your current edits remain on this page. Check the browser-save message and export a copy. Retry notebook save after the API is available. For a conflict, export first, then choose this page's copy or explicitly load the database copy. The app does not silently pick a winner.

I cannot see controls on a small screen

Open Controls, select the required tab, then close the pane to use the image. Minimize guided instructions if they cover the part you want to inspect.

The intro does not replay

It runs only for the first Explore entry of the current page visit, and is skipped with reduced motion. Later searches use ordinary progress information. Refresh the homepage to see the intro again.

Storage and privacy

The browser keeps a local notebook and a randomly generated private access key. When the API has notebook storage configured, a SQLite database stores a backup under a hash of that key. No login is required. A new browser has a different notebook; there is no automatic cross-device account sync.

Clearing site data removes the key needed to reach that database copy. Export before clearing data, changing browser or switching between localhost and 127.0.0.1. Private browsing may discard data when the window closes. If storage is blocked, notes work for the visit and export remains available.

Local Docker uses the notebook-data volume. Restarting or recreating containers retains it. docker compose down -v removes it. Public notebook durability requires a persistent server disk; the existing Cloudflare container configuration leaves database storage disabled until that is provided. No public database service has been provisioned.

Existing candidate records are preserved during migration. Unreadable backups are kept for download and are replaced only when you choose that action. Notebook content is human-authored; storing it does not validate a scientific claim.

Sources and limits

Khonsu is a NASA Space Apps project by ByteBoyz. Data and provenance are exposed in Info and exported evidence. Planet artwork and the Khonsu character are original illustrations, separate from telescope pixels.

Five-target coverage report · Scientific interpretation · Developer testing guide · SPHEREx mission

A candidate is an observation worth investigating. This tool does not establish a Planet X discovery or guarantee visible motion in any target field.