Skip to the content

Hoshi Stars星

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.

Hoshi is the Japanese word 星 for a star. About the name

Contents

Reference · What is near a star, an object or a point, in the sky and in space; neighbouring constellations

NearestOptionstype

The options of nearest and within.

Import it

import type { NearestOptions } from "@johnmorrisdotca/hoshi-stars/nearest";

Definition

interface NearestOptions {
    count?: number;
    within?: number;
    kind?: "star" | "deep-sky";
    by?: "sky" | "space";
    date?: When;
    magnitude?: number;
    among?: readonly NearestThing[];
}

Members

NameTypeDescription
count (optional)number | undefined

How many to return, nearest first (default 10; within returns all it finds unless this is set).

within (optional)number | undefined

Only answers this near: degrees by angle, light-years by space.

kind (optional)"star" | "deep-sky" | undefined

What to look through: "star" (the default, the Yale bright stars) or "deep-sky" (the Messier objects).

by (optional)"sky" | "space" | undefined

"sky" (the default) sorts by the angle on the sky; "space" sorts by the distance in space, from the parallaxes.

date (optional)When | undefined

A moment: the stars are carried to it by their proper motion before the angles are measured. Precession turns every object the same way, so it does not change an angle. J2000 when left out.

magnitude (optional)number | undefined

The faintest to include, as in stars({ magnitude }): a thing of exactly that magnitude is in. A thing with no magnitude is left out.

among (optional)readonly NearestThing[] | undefined

Look through this list instead of the table that kind names, for example deepSky() from /deep-sky/ngc-ic, or [...stars(), ...nearbyStars()] to count the nearby stars with the bright ones.

Examples

import { nearest, type NearestOptions } from "@johnmorrisdotca/hoshi-stars/nearest";

const options: NearestOptions = { count: 5, magnitude: 3 };
console.log(nearest("Sirius", options).map((found) => found.thing.name));
[ 'Mirzam', 'Wezen', 'Adhara', 'Aludra', 'Saiph' ]

What it prints (run when this page was built)

View sourceEdit on GitHubMade from the source of @johnmorrisdotca/hoshi-stars 0.7.0.