Preparing catalogue...

Server processing.

Object filters

Build ALL / ANY groups. NOT excludes matches. Distance anchors stay fixed when you select another star. Sidebar toggles and the quick distance filter remain additional restrictions. Planet conditions use the active dataset, independently of colour mode.

Save / load filter text

Copy the applied filter as text, keep it anywhere, and paste it back after a refresh.

Stellar motion

Measurements download only when enabled.

Years from J2000 (2000.0) Epoch 2000.0

Hollow grey markers lack radial velocity or proper motion; they stay at catalogue positions unless partial estimates are enabled. Grey does not mean stationary. Solid stars have complete velocities. Sol remains the fixed origin. Nebulae, galaxies and compact-object overlays do not move.

Straight-line extrapolation, not a gravitational simulation or an ephemeris. Binary motion and measurement errors limit accuracy. Uncertainty grows away from the reference epoch; select a star for its measurement source and approximate velocity-error budget.

Subspace disturbance

Primitive shapes

Annotation shapes, independent of object filters. Drag the title to move this window. Coordinates and dimensions are Galactic, in parsecs from Sol, even in Equatorial view.

Full dimensions (pc, before rotation)
A sphere uses diameters; unequal sizes make an ellipsoid. A plane ignores Z height.
Centre (Galactic pc)
Copies the object's centre; selecting another object will not move the shape.
Rotation (degrees about Galactic axes)

Share this view

Left-drag rotate · Right-drag / Shift+drag pan · Scroll zoom
Click star for details · Double-click star to centre on it from 3 pc away
Drag to rotate · Pinch to zoom · Two fingers to pan
Tap an object for details, then Centre on object

About StarExplorer & methods

About StarExplorer

Explore the real stellar neighbourhood, investigate plausible planetary populations, and build fictional worlds on an astronomical foundation.

What is this tool?

StarExplorer is an interactive three-dimensional map built with a Python Flask server and a three.js/WebGL browser renderer. It combines a catalogue of roughly 107,000 stars with neutron stars, black holes, nebulae, and a distant backdrop of galaxies and galaxy clusters. Positions are expressed in parsecs, with Sol at the origin; one parsec is about 3.26 light-years.

  • Rotate, pan, zoom, search by name or catalogue ID, select objects, and centre the view on stars or Galactic objects. Touch controls and responsive panels support phones and tablets.
  • Switch between Galactic and equatorial J2000 coordinates, use axis-aligned views, and inspect distances, spectral classes, catalogue identifiers and source notes.
  • Filter by distance, object type, spectral class, sovereignty or planetary category. Combine nested ALL, ANY and NOT rules and save or share filter text.
  • Inspect planetary systems, orbit diagrams, stellar properties, habitable zones, planet descriptions and moons. The backend selects a complete SQLite dataset.
  • Colour stars by their spectral colours, planetary categories or fictional sovereignties. Add an optional seeded volumetric subspace-disturbance layer.

The map is a spatial exploration and world-building tool, not a telescope image or a precision astronomical measurement service. The separate User guide in Help explains the controls step by step.

How astronomical databases were used

The catalogue supplies the observational foundation. Import tools convert source records into local JSON datasets, which the server validates and serves to the browser. The app does not query an astronomical archive every time you move the camera.

Stars: HYG Database v4.0
Most stars come from David Nash's HYG compilation; the initial ten entries were entered by hand. The import uses usable distances and spectral classes, preserves existing entries, and suppresses close companions within 0.05 pc of an included star to avoid overlapping map points. Colours are derived from B−V colour indices. Names and catalogue identifiers make the map searchable.
Confirmed planets: NASA Exoplanet Archive
The pscomppars table is downloaded and host stars are cross-matched to the map using catalogue identifiers and, where needed, sky position and distance. Positional matching allows a small angular separation and a distance tolerance; it is not just a name lookup. Sol has a separate Solar System dataset. Available archive stellar parameters take precedence over estimates derived from the map's spectral data.
Nebulae and molecular clouds
Curated literature entries are combined with planetary-nebula distances and morphology from González-Santamaría et al. (2021), using Gaia EDR3 parallaxes, and local molecular-cloud sightlines from Zucker et al. (2020). Position, physical size and morphology guide the rendering; the cloud textures themselves are procedural illustrations.
Compact objects and galaxies
Curated neutron-star, black-hole and extragalactic catalogues use published positions, distances and other properties, with notes about individual objects. Neutron-star positions use SIMBAD/ATNF information or coordinates encoded in J2000 object names. These lists supplement the star catalogue; they are not complete surveys of every object.

How statistical techniques fill the gaps

Most catalogue stars do not have a measured planetary system. Rather than treating every unmeasured star as planet-free, the generator makes a synthetic population using occurrence-rate models informed by exoplanet research. This is Monte Carlo sampling: distributions describe a population, and seeded random draws produce one plausible realisation. It is not a detection or a prediction of the actual planets around a particular star.

  1. Estimate stellar properties. Spectral type, luminosity class and absolute magnitude inform temperature, luminosity, mass and radius estimates, using a stellar sequence based on Pecaut & Mamajek. These estimates are inputs to the planet model, not new measurements.
  2. Choose which populations occur. Probabilistic host selection depends on stellar group and evolutionary state; giant-planet occurrence also depends on stellar mass and sampled metallicity. Metallicity is drawn from a Gaussian distribution when simulated, rather than assumed to have been measured for each star.
  3. Draw planet counts and properties. Populations use host probabilities and one-plus-Poisson multiplicities, not a fixed number of planets for every star. Piecewise power-law distributions supply periods, sizes or masses. Log-normal scatter gives related but non-identical planet sizes within a system and variation in inferred masses. Empirical relations connect mass and radius.
  4. Model eccentricities and reject implausible arrangements. Rayleigh, Gaussian and beta distributions are used for different planet populations. Very short-period orbits are circularised in the model. Crossing or overly close orbits are removed using a mutual-Hill-radius spacing rule. This is a plausibility screen, not a long-term gravitational simulation or proof of stability.
  5. Calculate derived properties. Orbital periods, insolation, equilibrium temperatures, habitable-zone membership and approximate tidal-locking behaviour follow physical formulae and published prescriptions. Moon populations use host-mass and Hill-sphere constraints plus statistical sampling; simulated exomoons are not observations.

Small-planet occurrence draws on SAG13 and Dressing & Charbonneau; giant planets on Johnson, Fulton and Cumming; cold Neptunes on Suzuki. The radius valley and within-system size similarity are inspired by Fulton and Weiss. Eccentricity and mass–radius models draw on Kipping, Van Eylen, and Chen & Kipping. These are simplified, research-informed prescriptions, not full reproductions of every cited study or a fitted posterior for each star.

Randomness is deterministic per seed and star name for a fixed generator and input version. Re-running that same setup recreates its generated population. Changing the seed explores a different realisation; changing the input data or generator can also change the result.

Complete, queryable SQLite datasets

Each dataset is a standalone SQLite database containing the star catalogue, stellar system properties, and normalized planet, moon and host rows. Star coordinates and physical body properties are stored in columns, with indexes for spatial searches. This makes database queries—such as distances between stars—possible without parsing nested JSON.

To make an alternate dataset, clone a database file and select it in the backend configuration. The browser has no dataset selector. The app opens the active file read-only, returns compact planet summaries and requests detailed systems as needed. Direct SQL edits are supported; refresh stored flags after planetary changes. Dataset files are excluded from Git and should be backed up separately.

Reading the map responsibly

  • Observed, simulated and manual are different. A confirmed planet may still have estimated parameters and simulated moons. A generated planet is a model outcome. A manually edited system is authored content. Check provenance and source notes.
  • Potentially habitable does not mean inhabited. The flag uses simplified size/mass, stellar and habitable-zone criteria. Equilibrium temperature is not surface temperature; atmospheres, climate, water and biology are not established by this model.
  • The star sample is incomplete and biased. HYG is magnitude-limited: distant faint stars, especially red dwarfs, are missing. Parallax uncertainties increase with distance. Counts and percentages on this map should not be read as unbiased Galactic population estimates.
  • Rendering is illustrative. Point sizes and compact-object glyphs aid visibility, not physical scale. Nebula detail and orientation are not reconstructed images. Distant galaxy positions and curated literature values have uncertainties.
  • Subspace disturbance and sovereignties are fictional. The disturbance is a seeded mathematical field, not measured interstellar gas or a discovered physical phenomenon. Its glow accumulates along the line of sight; its local percentage is a dimensionless model strength, not a calibrated scientific measurement.

Sources, attribution and further reading

  • HYG Database, David Nash: stellar catalogue, licensed under CC BY-SA 4.0. StarExplorer filters and transforms the catalogue for its map.
  • NASA Exoplanet Archive: confirmed-planet and host-star inputs.
  • SIMBAD and ATNF Pulsar Catalogue: compact-object identification and positional references.
  • González-Santamaría et al. (2021), A&A 656, A51: planetary nebulae.
  • Zucker et al. (2020), A&A 633, A51: molecular-cloud distances.
  • Pecaut & Mamajek (2013; updated dwarf sequence): stellar properties. Kopparapu et al. (2013, 2014): habitable-zone prescriptions.
  • Kopparapu et al. (2018, SAG13); Dressing & Charbonneau (2015); Johnson et al. (2010); Cumming et al. (2008); Fulton et al. (2017, 2021); Suzuki et al. (2016); Weiss et al. (2018): planet-population prescriptions.
  • Kipping (2013); Van Eylen et al. (2019); Chen & Kipping (2017): eccentricity and mass–radius relations. Canup & Ward (2006), Domingos et al. (2006), and Barnes & O'Brien (2002): moon-model constraints.

Published research informs the implementation; inclusion here does not imply endorsement. The active dataset determines which observations and generated worlds this instance serves.

User guide

Welcome to StarExplorer

A 3D map of more than 100,000 real stars around the Sun, plus neutron stars, black holes, nebulae, galaxies and planetary systems. Distances are in parsecs (1 pc ≈ 3.26 light-years).

✦ Getting started

The view opens centred on Sol. Every point is a real object placed at its measured distance.

1 · Look aroundDrag to rotate and scroll to zoom out until the local neighbourhood comes into view.
2 · Pick a starClick any star to read its details; double-click to fly to it.
3 · Narrow it downUse the sidebar toggles or View → Filters… to show only what matters.

Commands live in the View menu at the top: Star list, Filters…, Reset view, Show all and Clear saved data… This guide is always under Help, or press ?.

Tip: this guide can stay open while you explore. Drag its header to move it, drag the bottom-right corner to resize it, and double-click the header to put it back in the middle.

↻ Moving around

Left-dragRotate around the current centre star
Right-drag, Shift + drag or arrow keysPan the view
ScrollZoom in and out
Double-click a starMake it the centre of rotation and fly to about 3 pc from it

Tip: View → Reset view returns to Sol; Show all fits stars locally or all galaxies at extragalactic scales. The panel at the bottom right shows the current centre, scale and camera position.

◉ Selecting objects

Click a star, nebula, compact object or galaxy to open its details panel: spectral class, colour, magnitude, coordinates, sovereignty and distances from Sol and from the rotation centre.

While something is selected, the help panel at the bottom right shows its distance to the star you are rotating around, which makes it easy to measure between two stars: double-click the first, then click the second.

Press Esc or the × button to clear the selection.

☰ Display controls

Frame
Galactic (X towards the Galactic Centre, Z to the North Galactic Pole) or Equatorial J2000.
Colour by
True star colour, sovereignty (click a name in the legend to frame it; use its checkbox to hide it) or planets.
Object toggles
Show or hide stars ●, neutron stars ✦, black holes ◯, nebulae ❋ and galaxies ⬭. The chips below them filter by spectral class (O B A F G K M) and nebula type.
Grid & labels
Toggle the reference grid with drop lines, and the name labels.
Milky Way
A translucent spiral disk and central bulge centred on Sagittarius A*, about 8,178 pc from Sol, with mottled arms, dust lanes and pink star-forming clouds. Zoom out to see the local stars in galactic context. It fades in between viewing distances of 500 and 6,000 pc. Arm paths and widths follow Reid et al. (2019), including the Local (Orion) Arm around Sol, between Sagittarius and Perseus. Main arms continue beyond the measured ranges as illustrative trailing spirals; the Local Arm remains a short segment near Sol. Star positions are unchanged. Cloud detail, the bar and disk thickness remain illustrative; this uncertain model does not assign individual stars to arms. The checkbox is saved with your view.
Show within
Quickly limit the map to objects within a number of parsecs of the selected star (or the centre when nothing is selected).
View from a star
Select a star and choose View from to place the camera at its catalogue position. Drag to look around and use the wheel to zoom. Set a limiting magnitude or choose a rough dark-sky, binocular or telescope preset. This is an approximate star-only view: the catalogue is incomplete, magnitudes may be estimated, and equipment limits do not model real optics.
Star catalogue and load radius
Open Catalogue in the top menu, choose HYG, GAIA, or Both, and a radius from Sol (1, 2, or 5 kpc), then reload. These selections are saved. GAIA includes HYG stars matched to Gaia and a quality-filtered sample of Gaia additions. Matched stars retain their HYG positions and planetary systems; additions have no planetary-system data. Some Gaia additions have broad spectral classes estimated from their Gaia temperatures, marked (est.); temperature alone cannot determine luminosity class. Both displays each matched star once. Other object overlays are independent of this selection.
Subspace disturbance
Open View → Subspace disturbance... for an optional fictional volumetric field within 1,200 pc of Sol. Change Seed or use Regenerate for a different field; the same seed and generation version reproduce it. Glow changes appearance only. Cloud brightness accumulates along the line of sight; Local disturbance gives strength at the camera or selected object. Settings are saved in this browser.
Primitive shapes
Open View → Primitive shapes... to add labelled spheres, boxes, cylinders, cones, rings or planes. Set full dimensions, colour, transparency and rotation. Enter Galactic coordinates in parsecs, or copy the centre of a named or selected object. Choose a saved shape to edit or delete it. Drag the title to move the window; Close or Escape leaves shapes on the map. Shapes are saved in this browser, stay aligned across frame changes, and are independent of catalogue filters. The Labels toggle also controls shape labels.

⌕ Star list

Open View → Star list for a floating panel listing the stars nearest the centre. Type in the search box to find a star by name; click a result to select it, double-click to fly to it.

Drag the panel by its title to move it. Esc clears the search first, then closes the panel.

⚙ Advanced filters

View → Filters… opens a draggable panel that stays on screen while you work. Build rules, then press Apply.

  • ALL groups need every rule to match; ANY groups need at least one. Groups can be nested.
  • NOT turns a rule or group into an exclusion.
  • Rules include distance from any chosen star, object kind, spectral class, sovereignty, planet category and confirmed planets.
Example Two separate bubbles: ANY of within 10 pc of Sol · within 10 pc of Deneb

Under Save / load filter text, Copy filter text gives you a short string you can keep and paste back later with Load & apply. The status at the top of the screen shows when advanced filters are active.

☾ Planets & datasets

The backend selects the active complete dataset. To switch datasets, change the server database setting, restart the backend and reload this page. With Colour by → Planets, stars are coloured by their planet category and Confirmed planets only hides invented systems.

Select a star with planets and press View system to see its orbits, habitable zone and planet table.

Share view creates a link to the current camera, selected object and filters. It also supports star viewpoints and system-explorer planet/moon views. Copy a public site link when sharing with other people, not a localhost address.

Explore system opens a 3D view of its star, planets and individually modelled moons. Click to select, double-click to centre, or use Centre on selected body. Bodies are enlarged by default; choose True physical scale for their stored radii. Orbits use dataset distances but illustrative phases, not a live ephemeris. Return to star map restores the map view.

➕ Axes & views

The widget at the bottom left turns with the camera so you always know which way the Galactic Centre and the pole lie. Its XY XZ YZ buttons snap the camera to look straight at that plane.

✦ View from a star

View → Stellar motion... optionally enables measured stellar movement. It downloads velocities only when enabled. Adjust years from J2000 within +/-10,000; solid stars have complete velocities, hollow grey markers are incomplete. Missing radial motion is never invented unless you explicitly enable tangential-only estimates. Select a star for provenance and available errors. The model is straight-line extrapolation, not an exact ephemeris; uncertainty grows with time. Disable it to restore catalogue positions.

Select a star to open its details panel, then use View from there to place the camera at its catalogue position. The panel also lets you search for a different visible observer star. While viewing from a star, search for another visible star under Point camera at to aim toward it. Drag to look around and scroll to zoom. Use the limiting-magnitude slider or choose a rough viewing preset. The selected star itself is omitted because the viewpoint is at its location. Choose Exit to return to your previous map view.

This is illustrative, not an observation-grade sky simulator. It filters catalogue stars using their absolute magnitudes and estimated distances, but the catalogue is incomplete and biased, some magnitudes are approximate, and binocular/telescope presets do not account for optics, sky glow or adaptation.

💾 Saved settings

Your shapes, view, toggles, filters and open panels are saved automatically in this browser and restored next time. Nothing is sent to the server. Use View → Clear saved data… to start again from the defaults.

⌨ Keyboard shortcuts

?Open this guide
← ↑ → ↓Pan the view
EscClose the open menu, panel or dialog; otherwise clear the selection
TabMove between controls