npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@mmomtchev/orbitron

v1.0.2

Published

Generator of orbital animations using NASA/JPL Horizons API

Downloads

14

Readme

orbitron

orbitron is a tool for making orbital animations including spacecraft trajectories using the NASA/JPL Horizons API.

It uses ideas from the unpublished ad-hoc tool by Phoenix7777 used for creating many of the illustrations on Wikipedia.

Usage

Install from npm:

$ npm install -g @mmomtchev/orbitron
....
$ orbitron
Usage: orbitron [options] [command]

Options:
  -h, --help         display help for command

Commands:
  animate [options]  Generate orbital animations using NASA/JPL Horizons API
  lookup <string>    Lookup bodies in the Horizons database
  help [command]     display help for command

Lookup the spacecraft you need

Find the Horizons ID of Voyager 1:

$ orbitron lookup Voyager

Voyager 1 (spacecraft)
		-31
Voyager 2 (spacecraft)
		-32

Generate the animation

Create a slower animation for the first part of the mission (launch to Saturn), include only the inner planets, Jupiter and Saturn, set one day per frame speed (one month per second), linear projection.

$ orbitron animate --start 1977-09-06 --stop 1982-01-01    \
  --out voyager1-part1.mp4 --days 1 --legend               \
  --proj lin --origin sun --body -31=green                 \
  --body sun --body mercury --body venus --body earth      \
  --body mars --body jupiter --body saturn

Create a faster animation for the second part of the mission (Saturn to outer Solar System), include only the gas giants and Earth, set 10 days per frame (almost an year per second), square root isometric projection:

$ orbitron animate --start 1980-01-01 --stop 2024-01-01    \
  --out voyager1-part2.mp4 --days 10 --legend              \
  --proj lin --origin sun --body -31=green                 \
  --body sun --body earth                                  \
  --body jupiter --body saturn --body uranus               \
  --body neptune --body pluto

At the end of the animation, it will be moving right towards you - it is leaving the Solar System in a highly inclined trajectory about 45° from the north.

If you want to produce a GIF file instead, you can use --out voyager1.gif --format gif. To match the style of the Wikipedia articles, you can use:

$ orbitron animate --start 1977-09-06 --stop 1982-01-01           \
  --out voyager.gif --format gif --days 5                         \
  --font Arial --font-size 12 --date top --width 320 --height 200 \
  --proj lin --origin sun --body -31=green                        \
  --body sun --body earth --body mars --body jupiter --body saturn

Fun things to try

  • Animate the Apollo-12 S-IVB stage (yes, it is still there) with the Earth as center of the animation:
$ orbitron animate --start 2003-03-01 --stop 2003-09-01    \
  --out apollo-11-s4b.mp4 --days 1 --legend                \
  --body -998=green                                        \
  --proj lin --origin earth --body moon 

This is in fact the somewhat controversial object J002E3 that was (re-)discoverd in September 2002 and initially got assigned an asteroid designation, but it is now believed to be in fact the S-IVB stage of the Apollo 12 mission. It is in a highly unstable orbit and it is re-captured by the Earth once every 40 years. In this animation you can see it perform an almost perfect natural gravitational sling-shot around the Moon before being ejected once again in a heliocentric orbit.

  • Animate the JWST around the SEMB L2 (Sun & Earth-Moon Barycenter Lagrange 2) point
$ orbitron animate --start 2021-12-26 --stop 2024-01-01         \
  --days 1 --legend --proj isolin --origin @32 --body @32=red   \
  --body earth --body moon --body -170=green --out jwst.mp4

This is called a halo orbit and it is a result from a complex interaction between the two gravitational fields (the Sun and the Earth-Moon system) and the Coriolis force.

  • Animate the Korean spacecraft Danuri (low-energy Moon transfer) around the Earth:
$ orbitron animate --start 2022-08-05 --stop 2023-01-01             \
  --days 1 --legend --proj isolin --origin earth --body @31=yellow  \
  --body earth --body moon --body -155=green --out danuri.mp4

Supported projections

  • lin: Linear, 2D, top-down view from the north, works best for the inner planets
  • log: Logarithmic, 2D, top-down view from the north, works best for huge differences in scale
  • sqrt: Square Root law, 2D, top-down view from the north, works best for the main 8 planets
  • isolin: Linear, isometric 3D view, 45° from the north, for highly inclined orbits around the inner planets
  • isosqrt: Square Root law, isometric 3D view, 45° from the north, for the whole solar system
  • sidelin: Linear, 2D, side view from the plane of the ecliptic, for highly inclined orbits around the inner planets

License

Software

ISC License

Copyright (c) 2024, Momtchil Momtchev [email protected]

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

Data

This tool retrieves automatically data from the public NASA/JPL Horizons API. All the data is copyrighted by NASA/JPL. You are free to use their data, but you are not allowed to republish it as your own. Their copyright notice can be found at Caltech/JPL Privacy Policies and Important Notices near the bottom of the page.

Images and video

You are the sole owner of the images and the videos you create.

Trivia

This tool was at the center of a number of heated discussions on the Space Exploration Stack Exhange (#2) related to the affair on my main profile page in which Stack Exchange is becoming major actor.

Results

  • Apollo 12 S-IVB stage Apollo 12 S-IVB stage

  • First phase of the Voyager 1 mission Voyager 1 part 1

  • Second phase of the Voyager 1 mission Voyager 1 part 2

  • JWST JWST (in green), viewed from Earth (blue) orbiting around L2 (in red) JWST from Earth

JWST (in green) viewed from L2 (in red), with Earth (in blue) and Moon (in white), isometric 3D view from 45° north JWST 3D

JWST (in green) viewed from L2 (in red), with Earth (in blue) and Moon (in white), 2D top down view from the north JWST 2D topdown

JWST (in green) viewed from L2 (in red), with Earth (in blue) and Moon (in white), 2D side view from the the plane of the ecliptic JWST 2D side