astronomia
Advanced tools
The astronomia npm package provides a collection of algorithms and functions for astronomical calculations. It includes tools for computing positions of celestial bodies, converting between different time scales, and performing various other astronomical computations.
Compute Positions of Celestial Bodies
This feature allows you to compute the positions of planets. The code sample demonstrates how to compute the position of Earth on a given date.
const { planetposition, data } = require('astronomia');
const earth = new planetposition.Planet(data.earth);
const jupiter = new planetposition.Planet(data.jupiter);
const date = new Date('2023-10-01');
const pos = earth.position(date);
console.log(pos);Convert Between Time Scales
This feature allows you to convert between different time scales, such as Julian Date and Gregorian Calendar. The code sample shows how to convert a Gregorian date to Julian Date and back.
const { julian, cal } = require('astronomia');
const jd = julian.CalendarGregorianToJD(2023, 10, 1);
const date = cal.JDToCalendarGregorian(jd);
console.log(date);Compute Rise, Transit, and Set Times
This feature allows you to compute the rise, transit, and set times of celestial bodies. The code sample demonstrates how to compute these times for the Sun as observed from Berlin on a given date.
const { rise } = require('astronomia');
const observer = { lat: 52.5200, lon: 13.4050 }; // Berlin
const date = new Date('2023-10-01');
const times = rise.times(observer, date, 'sun');
console.log(times);The astronomy-engine package provides similar functionalities for astronomical calculations, including positions of celestial bodies, rise/set times, and more. It is known for its high precision and ease of use.
The meeusjs package is a JavaScript implementation of the algorithms described in Jean Meeus' 'Astronomical Algorithms'. It offers a wide range of astronomical calculations, similar to astronomia, but is based on a different set of algorithms.
The suncalc package focuses on calculating sun and moon positions, phases, and rise/set times. While it offers fewer features compared to astronomia, it is highly optimized for solar and lunar calculations.
An astronomical library
This library is a translation of meeus from Go to Javascript and contains selected algorithms from the book "Astronomical Algorithms" by Jean Meeus, following the second edition, copyright 1998, with corrections as of August 10, 2009.
Additional algorithms not covered in the book have been added.
npm install --save astronomia
Make sure you add <meta charset="UTF-8"> to your HTML or at least include your
bundle with <script src="your-bundle.js" charset="UTF-8"></script> then
this package runs in modern browsers.
core-js/es6 polyfill)For documentation of the different packages please take a look at the source code as well as at the tests.
If you require a small footprint in your final application, each of the provided packages can be used as a single one:
// instead of
const base = require('astronomia').base
// use
const base = require('astronomia/lib/base')
ES6 Syntax
// instead of
import {base} from 'astronomia'
// use
import base from 'astronomia/src/base'
To access dedicated VSOP87 data sets use e.g.
const {vsop87Bvenus} = require('astronomia').data
// or
const vsop87Bvenus = require('astronomia/data/vsop87Bvenus')
Please take a look at ./docs/migrate_v1.md
npm test
to even run very long lasting tests, do
SLOWTESTS=1 npm test
In local browser
npm run zuul -- --local 3000
If you contribute code to this project, you are implicitly allowing your code to be distributed under the MIT license.
You are also implicitly verifying that all code is your original work or correctly attributed with the source of its origin and licence.
MIT Licensed
See LICENSE for more info.
FAQs
An astronomical library
The npm package astronomia receives a total of 127,048 weekly downloads. As such, astronomia popularity was classified as popular.
We found that astronomia demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
An advanced npm supply chain attack is leveraging Ethereum smart contracts for decentralized, persistent malware control, evading traditional defenses.
Security News
Research
Attackers are impersonating Sindre Sorhus on npm with a fake 'chalk-node' package containing a malicious backdoor to compromise developers' projects.
Security News
The npm package for the LottieFiles Player web component was hit with a supply chain attack after a software engineer's npmjs credentials were compromised.