README.md

Exoplanet Data Explorer

Spring/Angular App to explore NASA Exoplanet data
Explore the docs »

View Video Demo (YouTube) · Report a Bug · Request a Feature

Table of Contents

• About the Project
  • Built With
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Roadmap
• Contributing
• License
• Contact
• Acknowledgements

About The Project

Built With

• Java 8
• Spring Boot 2.3.0
• Angular 8.3.4
• PostgreSQL
• Maven

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

1. Download and prepare the data

   • Go to https://exoplanetarchive.ipac.caltech.edu/docs/data.html
   • Select the Planetary Systems Composite Data Table
   • Under the 'Download Table' option: select CSV Format and Download all Columns/all Rows
   • Open the file and remove column description information and rename the 'rowid' column to 'id'
   • Note: you'll have to update the schema.xml file with the path and filename

2. Setup the DB (if you choose something other than PostgreSQL, you will need to tweak the Schema SQL language)

Installation

1. Clone the repo.

   git clone https://github.com/lynch0001/exoplanet.git

2. Install NPM packages.

   npm install

3. Run the backend.

   mvn spring-boot:run

4. Run the frontend.

   ng serve

Usage

Functionality allows users to:

• View data associated with the 4201 exoplanets currently reported by NASA
• View full exoplanet list and select queries
• View details of each exoplanet and its star
• View imagery of exoplanet associated star
• View planet/star location in the sky (based on my location - Northern VA, USA)
• View charts depicting field comparisons for the full data set

Selected Views

Figure 1: List page

Figure 2: Detail page (system/planet data and stellar imagery (from Aladin Lite))

Figure 3: Detail page (stellar data and relative location in the night sky(from VirtualSky))

Figure 4: Detail page (planet/stellar size comparisons)

Figure 5: Example chart from the Charts page

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Tim Lynch

• LinkedIn timothy-j-lynch
• Medium @lynch0001
• Dev @lynch0001
• Stackoverflow tim-lynch
• Email Lynch0001@gmail.com

Project Link: https://github.com/lynch0001/exoplanet

Acknowledgements

• NASA Exoplanet Data Archive
• Aladin Lite from the Université de Strasbourg at https://aladin.u-strasbg.fr/AladinLite/
• VirtualSky from Las Cumbres Observatory at https://virtualsky.lco.global/
• John Thompson at https://springframework.guru/
• Koushik Kothagal at https://javabrains.io/
• Angular University at https://angular-university.io/
• Jason Watmore at https://jasonwatmore.com/