Skip to content

ferdesmello/exoplanets-in-the-galaxy-3d

Repository files navigation

Exoplanets in the Galaxy

Overview

Thousands of exoplanets have been discovered, most of them not so far from the Sun considering the galactic scale. This distribution is mostly because the methods used for detection can more easily detect exoplanets close to us or exoplanets with certain characteristics, not because all exoplanets are really distributed close to us. Curious about what area of our Galaxy we were able to map for exoplanets, I made this interactive visualization. You may see that, until now, we just mapped a very small region of our Galaxy.

There have been 6028 exoplanets discovered around 4500 stars. But only 4474 of those stars have had their distance to us determined, totaling 6002 exoplanets in the visualization.

Access the interactive visualization in your browser going here or clicking on the image below.

Also, the files are being update monthly with the newly discovered exoplanets in the exoplanet archive.

Date of the last (automatic) update: 2025-10-20

Update Exoplanet Data

Interactive visualization

What the code does

1. Scraping the data

Run exoplanet_data_from_API.py to retrieve data from https://exoplanetarchive.ipac.caltech.edu and build (or update) Exoplanets_coordinates.txt and exoplanets_coordinates_methods.txt with distance, position, and method of detection of every exoplanet (with estimated distance to us) discovered till now.

2. Simple face-on and edge-on flat maps

Run flat_galaxy_maps.py to retrieve data from exoplanets_coordinates.txt and Artist's_impression_of_the_Milky_Way_gna_small.jpg to make MW_fo_dots.jpg, 2D map of the distribution of exaplanets discovered in our Galaxy.

Representation of the positions of the exoplanets discovered in our Galaxy.

It also retrieves data from exoplanets_coordinates_l_b.txt and Milky_Way_edge_on.jpg to make MW_eo_dots.jpg, another 2D map of the distribution of exaplanets discovered in our Galaxy.

Representation of the positions of the exoplanets discovered in our Galaxy.

3. From TXT to JSON

Run TXT_to_JSON.py to retrieve data from exoplanets_coordinates.txt and exoplanets_coordinates_methods.txt and transform the data to JSON format in exoplanets_coordinates.json and exoplanets_coordinates_methods.json. This is used in the interactive visualization.

4. Semi-transparent PNGs

The images MW_transparent.png and MW_transparent_small.png may already be present. If not, you need to run Exoplanets_in_the_Galaxy_3D.nb (Mathematica notebook) to create them and have a 3D visualization of the exoplanets.

5. Local visualization

Now, to access the interactive visualization locally in your browser, you need to run index.html locally.

In your computer, open a terminal window and go to the project folder:

cd C:\Git\exoplanets-in-the-galaxy-3d

Create a server:

python -m http.server 8000

In your browser, go to:

http://127.0.0.1:8000/

Later, close the server in the terminal pressing "Ctrl+C" in it.

The Images of our Galaxy

The Illustration of our Galaxy comes from here. The annotated version can be found here. The edge on picture of our Galaxy comes from here. The extruded galaxy is built from a low-resolution black-and-white (also in the folder Images) version of the illustration, where the height of the mesh is set in function of how bright a pixel is in the image.

For exoplanet archive information in retrieving data, see:

Some documentation

https://exoplanetarchive.ipac.caltech.edu/applications/DocSet/index.html?doctree=/docs/docmenu.xml&startdoc=item_1_01

How to use TAP and retrieve data

https://exoplanetarchive.ipac.caltech.edu/docs/TAP/usingTAP.html

And how to choose your table and data on TAP

https://exoplanetarchive.ipac.caltech.edu/docs/API_PS_columns.html

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages