Hoshi Stars documentation
Hoshi Stars 星 — stars you can see without a telescope, as data and as sky charts
The stars you can see without a telescope, with names, colours and distances; the 88 constellations with their lines and boundaries; the Messier objects; and seven map projections to draw them on.
Install
npm install @johnmorrisdotca/hoshi-stars
Start here
Entry points
| Import it | What it is |
|---|---|
@johnmorrisdotca/The 88 constellations, in English and Japanese · 4 exports | |
@johnmorrisdotca/Constellation lines · 3 exports | |
@johnmorrisdotca/Constellation boundaries and which constellation a point is in · 4 exports | |
@johnmorrisdotca/The Messier objects · 8 exports | |
@johnmorrisdotca/NGC and IC objects as well · 7 exports | |
@johnmorrisdotca/Map projections for sky charts · 7 exports | |
@johnmorrisdotca/The Milky Way: a brightness map and soft bands to draw · 9 exports | |
@johnmorrisdotca/Your sky: altitude and azimuth for a place and a moment · 11 exports | |
@johnmorrisdotca/What is near a star, an object or a point, in the sky and in space; neighbouring constellations · 9 exports | |
@johnmorrisdotca/Nearby stars: Proxima Centauri, Barnard's Star and about 5,600 more, with distance and error · 6 exports | |
@johnmorrisdotca/Stars: names, positions, distance and colour · 10 exports |
Guides
How-to
- The starsThe 5,080 stars of the Yale Bright Star Catalogue, how to find one by name, number or brightness, what each field means, and how a star moves.
- Colour and distanceTurn a star's colour index into a temperature and a colour to draw, and its parallax into light-years.
- Constellations and their linesThe 88 constellations by name in English or Japanese, which one a point is in, their boundaries to draw, and a stick figure for each.
- Sky chartsPut stars, constellation lines and boundaries on a flat chart with the seven projections, and turn a point on the chart back into a point of the sky.
- What is nearThe stars and Messier objects nearest a star, an object or a point, by angle on the sky or by distance in space, and the constellations that touch a constellation.
- Nearby stars5,565 more stars with a measured distance and its error, among them Proxima Centauri, Barnard's Star and Wolf 359, as their own import so the bright-star table stays small.
- Plain HTML and a CDNDraw a sky chart on a page with no build step, from jsDelivr or unpkg, and show a star's facts from a single small import.
- BundlersUse the package with Vite or webpack, and keep the bundle to the parts a chart needs.
- FrameworksDraw a chart in React, Vue, Svelte and Angular, each as one small component that writes the package's SVG.
- TypeScript and NodeThe types the package ships, how a wrong projection or a missing star is caught, and drawing the sky on a server.
- Embed a chart in an iframePut a sky chart on a page you cannot run script on, by the address of the embed page, and what each part of the address does.
- Data filesDownload the tables as CSV or Parquet and use them in other languages.
- Serve it yourselfRun your own small HTTP query service.