Merge branch 'main' of github.com:ljfp/NASASpaceAppsChallenge2025

Author: 9x14S

README.md

@@ -1,67 +1,35 @@
-# NASA Sky Data Prototype
+# NASA Sky Explorer Prototype
 
-Prototype utilities for building an ESASky-like explorer backed exclusively by public NASA archives. The initial focus is on downloading survey cutouts and generating quick-look imagery from NASA's **SkyView** service, which federates data from multiple missions (DSS, GALEX, WISE, 2MASS, Fermi, ROSAT, etc.).
+A barebones FastAPI project that serves the landing page for the NASA Sky Explorer Prototype
 
-## 🚀 Goals
+## Quickstart
 
-- Help you discover NASA-managed astronomical data that can power a visual explorer.
-- Provide a reproducible script that fetches science-ready survey tiles and converts them into PNG previews.
-- Document next steps for evolving the prototype into a richer web or desktop application.
+1. Create a virtual environment and install the dependencies:
 
-## 📡 Key NASA Data Sources
+   ```bash
+   python -m venv .venv
+   source .venv/bin/activate
+   pip install -r requirements.txt
+   ```
 
-| Archive | What you get | Programmatic access |
-| --- | --- | --- |
-| [NASA SkyView](https://skyview.gsfc.nasa.gov/current/cgi/titlepage.pl) | On-the-fly projection of surveys (optical, IR, UV, X-ray, gamma) | HTTP service + [`astroquery.skyview`](https://astroquery.readthedocs.io/en/latest/skyview/skyview.html) |
-| [Mikulski Archive for Space Telescopes (MAST)](https://archive.stsci.edu/) | HST, JWST, Kepler/K2, TESS, GALEX, etc. | [`astroquery.mast`](https://astroquery.readthedocs.io/en/latest/mast/mast.html) APIs |
-| [High Energy Astrophysics Science Archive Research Center (HEASARC)](https://heasarc.gsfc.nasa.gov/docs/archive.html) | Chandra, XMM-Newton, Swift, Fermi, ROSAT, etc. | [`astroquery.heasarc`](https://astroquery.readthedocs.io/en/latest/heasarc/heasarc.html), TAP |
-| [Planetary Data System (PDS)](https://pds.nasa.gov/) | Planetary mission data (images, spectra, telemetry) | [PDS Imaging Node APIs](https://pds-imaging.jpl.nasa.gov/help/), [PDS Search](https://pds.nasa.gov/services/search/) |
-| [NASA/IPAC Infrared Science Archive (IRSA)](https://irsa.ipac.caltech.edu/frontpage/) | WISE/NEOWISE, Spitzer, 2MASS, Planck, etc. | [`astroquery.irsa`](https://astroquery.readthedocs.io/en/latest/irsa/irsa.html), VO TAP |
-| [NASA Open Data Portal](https://data.nasa.gov/) | Curated datasets across NASA centers | REST API + CSV/JSON exports |
+2. Launch the development server:
 
-> Some APIs (e.g. MAST, NASA Open APIs) require a free API key or authentication token. The SkyView service used in this prototype is fully open and anonymous.
+   ```bash
+   uvicorn src.server:app --reload
+   ```
 
-## 🧭 Prototype walkthrough
+3. Open <http://127.0.0.1:8000/> in your browser to view the page titled **“Minimal FastAPI App.”**
 
-### 1. Create an isolated environment
+## Project structure
 
-```bash
-python -m venv .venv
-source .venv/bin/activate
-pip install -r requirements.txt
 ```
-
-### 2. Fetch a survey cutout and generate a PNG
-
-The CLI accepts either a resolvable object name or explicit coordinates. A DSS2 Red cutout of the Whirlpool Galaxy at 0.4° scale can be generated with:
-
-```bash
-python -m src.skyview_downloader --target "M51" --survey "DSS2 Red" --width 0.4 --pixels 800
-```
-
-To target custom celestial coordinates in decimal degrees:
-
-```bash
-python -m src.skyview_downloader --ra 201.3651 --dec -43.0191 --survey "WISE 3.4" --width 1.0 --pixels 1024
+NASASpaceAppsChallenge2025/
+├── requirements.txt      # FastAPI and Uvicorn dependencies
+├── src/
+│   ├── __init__.py
+│   └── server.py         # FastAPI application serving the HTML page
+└── web/
+    └── index.html        # Static HTML served at the root route
 ```
 
-Outputs are written to `outputs/`:
-
-- `<target>-<survey>.fits` — the raw FITS cutout.
-- `<target>-<survey>.png` — contrast-stretched preview (Astropy WCS axes, grayscale colormap).
-
-### 3. Spin up the interactive globe prototype
-
-Launch the FastAPI service, which proxies NASA's SkyView service and serves the front-end assets:
-
-```bash
-uvicorn src.server:app --reload
-```
-
-Then open <http://127.0.0.1:8000/app> in your browser. Rotate the sphere with your mouse or trackpad, use the zoom buttons to adjust the field of view, and switch between surveys (DSS, WISE, GALEX, Fermi). Every interaction requests a fresh cutout from NASA SkyView, so you're always looking at live archival imagery.
-
-> The backend stores PNG tiles in `outputs/` to avoid re-downloading frequently requested fields.
-
-### 4. Inspect available surveys
-
-NASA maintains the full survey catalogue at <https://skyview.gsfc.nasa.gov/current/cgi/survey.pl>. Any entry in the "Survey" column is compatible with the `--survey` option.
+Feel free to build on this foundation for richer APIs or interfaces.

requirements.txt

@@ -1,5 +1,2 @@
-astroquery==0.4.7
-astropy==6.0.1
 fastapi==0.112.1
-matplotlib==3.8.4
 uvicorn[standard]==0.30.1

src/server.py

@@ -1,49 +1,20 @@
-"""FastAPI service that proxies NASA SkyView tiles and serves the prototype UI."""
-from __future__ import annotations
+"""Minimal FastAPI application that serves a static HTML homepage for the NASA Sky Explorer Prototype."""
 
-import asyncio
-import logging
 from pathlib import Path
-from typing import Optional
 
-from fastapi import FastAPI, HTTPException, Query
-from fastapi.middleware.cors import CORSMiddleware
-from fastapi.responses import FileResponse, JSONResponse, Response
-from fastapi.staticfiles import StaticFiles
-
-from .skyview_downloader import fetch_survey_image
+from fastapi import FastAPI, HTTPException
+from fastapi.responses import HTMLResponse
 
 BASE_DIR = Path(__file__).resolve().parent.parent
 WEB_DIR = BASE_DIR / "web"
-OUTPUT_DIR = BASE_DIR / "outputs"
-FAVICON_PATH = WEB_DIR / "favicon.ico"
-
-logging.basicConfig(
-    level=logging.INFO,
-    format="%(asctime)s %(levelname)s [%(name)s] %(message)s",
-)
-
-logger = logging.getLogger(__name__)
-logger.setLevel(logging.INFO)
+INDEX_PATH = WEB_DIR / "index.html"
 
-app = FastAPI(title="NASA SkyView Prototype", version="0.1.0")
-app.add_middleware(
-    CORSMiddleware,
-    allow_origins=["*"],
-    allow_credentials=True,
-    allow_methods=["*"],
-    allow_headers=["*"],
-)
+app = FastAPI(title="NASA Sky Explorer Prototype")
 
-if WEB_DIR.exists():
-    app.mount("/app", StaticFiles(directory=WEB_DIR, html=True), name="app")
 
-
-@app.get("/favicon.ico", include_in_schema=False)
-async def favicon() -> Response:
-    if FAVICON_PATH.exists():
-        return FileResponse(FAVICON_PATH)
-    return Response(status_code=204)
+@app.get("/", response_class=HTMLResponse)
+def read_index() -> str:
+    """Return the contents of the bundled ``index.html`` file."""
 
 
 @app.get("/aladin")
@@ -117,11 +88,6 @@ async def get_tile(
 if __name__ == "__main__":
     import uvicorn
 
-    logging.basicConfig(
-        level=logging.INFO,
-        format="%(asctime)s %(levelname)s [%(name)s] %(message)s",
-    )
-
     uvicorn.run(
         "src.server:app",
         host="0.0.0.0",