Compare real SPHEREx observations across time and explore the sky in 102 infrared bands.
SPHEREx first all-sky panorama · NASA/JPL-Caltech
Built for Planet X and SPHEREx, a 2026 NASA Space Apps Challenge. Read the development journey.
| View | What you can do |
|---|---|
/atlas |
Choose a target or enter sky coordinates. Start with the Aladin Lite DSS2 atlas and add Gaia DR3 or AllWISE overlays. |
| Observation comparison | Browse DR1 and QR3 visits, blink between aligned images, build a timeline, or subtract, sum and stack compatible exposures. Inspect FITS quality flags and provenance. |
/spectral |
Open the DR1 spectrum and band image at a sky position. Select among 102 channels or combine the 17 channels from a detector. Toggle individual pixels to inspect the cutout. |
/research |
Open the five challenge targets and reproduce the benchmark results. |
/embed |
Use the atlas coordinate panel to copy a share link or an iframe with your field and selected observations. |
Install Python 3.11 and Node.js 24, then clone the repository.
git clone https://github.com/Pentexa/SpectraX.git
cd SpectraXStart the API from the repository root.
PowerShell
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -e '.[test]'
.\.venv\Scripts\planet-x-api.exemacOS / Linux
python3.11 -m venv .venv
.venv/bin/python -m pip install -e '.[test]'
.venv/bin/planet-x-apiIn another terminal at the repository root, start the web app.
npm ci --prefix frontend
npm run dev --prefix frontendOpen the web app or the interactive API docs. Next.js proxies browser requests from /science/api/* to the FastAPI service at http://127.0.0.1:8765. For a different backend URL, copy the frontend environment example to frontend/.env.local and set SPECTRAX_API_URL before starting or building Next.js. See backend environment settings.
The web app requests official archive data first. For offline tests and backup coverage of the example fields, activate the virtual environment and run planet-x-data --include-benchmarks --include-cubes from the repository root. Downloads are checked against the manifest. The example cube is about 321 MB.
- NASA/IPAC IRSA provides the SPHEREx DR1 and QR3 calibrated FITS images and the DR1 All-Sky Cube. Comparisons use FITS WCS and masks. Spectra show sky-pixel surface brightness in the multi-epoch mosaic. Full data inventory and dataset DOIs
- Gaia DR3 and AllWISE provide catalog overlays through CDS VizieR. SIMBAD provides the target astrometry references. AAVSO observations supply optical reference light curves for RW Aurigae and R Draconis.
- DSS2 provides the Aladin Lite atlas background via the MAST and NASA/IPAC IRSA mirrors. The app shows archive or local delivery when it has that information.
frontend/ Next.js web application and media
apps/api/ FastAPI routes
pipeline/ Archive downloads, FITS processing and measurements
data/manifests/ Versioned archive products and checksums
tests/ Backend and archive integration tests
deploy/ Backend container and gateway configuration
docs/ API reference, data inventory and benchmark results
With the virtual environment activated, run checks from the repository root.
python -m pytest -q -ra
npm run lint --prefix frontend
npm run build --prefix frontendGitHub Actions runs the frontend checks and backend tests. On main, the backend workflow also verifies real FITS products and publishes the API container to GitHub Container Registry. See the API reference for endpoints, real-data smoke tests, and container setup.
Project team: Ahmet Aras Akyasan, Mustafa Emir Yayla, Korhan Erol, and Nisanur Cakir.
AI assistance: GPT SOL 6.1 supported coding. GLM 5.3 supported code review.