Giter VIP home page Giter VIP logo

celestialocationsmaker's Introduction

Celestia locations maker (CLM)

A Python script that creates location files for Celestia in SSC format from Gazetteer of Planetary Nomenclature database.

How to use it?

You need Python 3.6 or higher (due to f-strings). Tested on Windows 10/11 and Linux. The script doesn't require installing additional libraries or an Internet connection because the database is preloaded.

Run clm.py in console, customize settings, choose output format (and target for single file mode). Done. In case of problems, the tool will notify you.

What do I need to know?

  • CLM is still may contain inaccuracies for some bodies. Help is welcome.
  • It is designed for the Celestia 1.7 and Celestia Origin, which support all existing types of locations. You can turn on legacy mode that constrains location types according to Celestia 1.6 after launch.
  • You can turn on comments about the location type, dates of creation and last update, as well as information about the origin of the name for each location.
  • Names of albedo features (AL), mare/maria (ME), oceanus/oceani (OC), regio/regiones (RE) and terra/terrae (TA) are written in capital letters.
  • Coordinates and altitude of locations can be set manually through the custom_longlat.txt. Their parameters are tailored to the models used in Celestia Origin. Also, it contains locations with not specified coordinates.
  • The database contains 337 locations with zero sizes. If the size of one of them is specified in the custom_size.txt, the script uses it. Else, Importance sets to 20 for albedo features and Size sets to 10 (km) for other location types.
  • Asteroids for the asteroids_locs.ssc are sorted by their identifying number.
  • Venus, Puck, Miranda, Ariel, Umbriel, Titania, Oberon, Triton and Ida are retrograde rotators, and use the "north side of the invariable plane" guideline for their coordinate systems. For correct display in Celestia, their coordinates are inverted. Starting in 2006, the IAU WGCCRE defines the rotation poles of small bodies using the right-hand rule, and thus, minor planets with features named after this date don't need to have their coordinates inverted.
  • The IAU in the location database uses the Vesta coordinate system with an offset of 150° relative to the Dawn team system. Since Celestia Origin uses the model based on the second coordinate system, this shift is hardcoded.

How to update the database file?

  1. Go to Planetary Names: Advanced Nomenclature Search;
  2. Scroll, tap the Search button;
  3. Tap + Add/Remove Columns on the top of the table;
  4. Check all the boxes there;
  5. Scroll, choose the CSV link;
  6. Save the file to the data folder.

The last database update was on January 29, 2024.

celestialocationsmaker's People

Contributors

askaniy avatar pedro-fixingstuff avatar

Stargazers

 avatar  avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.