`Asterism`型

リファレンスの説明と例は英語です。見出しと目次は日本語です。

One figure of a sky culture: its names, its reading and the stars it joins, as Bright Star Catalogue (HR) numbers. figures(culture) and figureOf(text, culture) turn it into stars and lines.

インポート

import type { Asterism } from "@johnmorrisdotca/hoshi-stars/culture";

定義

interface Asterism {
    readonly id: string;
    readonly name: string;
    readonly names: Readonly<Partial<Record<NameLanguage, string>>>;
    readonly readings: Readonly<{
        ja?: string;
        zh?: string;
    }>;
    readonly aka: readonly string[];
    readonly about: string;
    readonly kind: AsterismKind;
    readonly group: string | undefined;
    readonly partOf?: string;
    readonly missing: number;
    readonly numbers?: Readonly<Record<number, number>>;
    readonly chains: ReadonlyArray<readonly number[]>;
}

メンバー

名前	型	説明
`id`	`string`	A short ASCII key, stable between releases: the IAU abbreviation for a constellation (`Ori`), else a lower-case word (`hokuto-shichisei`, `bei3-dou3`).
`name`	`string`	The name in the culture's own writing: the Latin name (`Orion`) for a Western constellation, the English name (`Big Dipper`) for a Western asterism, `昴` for a Japanese one, the Traditional characters (`北斗`) for a Chinese one.
`names`	`Readonly<Partial<Record<NameLanguage, string>>>`	The name in each language the figure has one in.
`readings`	`Readonly<{ ja?: string; zh?: string; }>`	How the name is read: `ja` in hiragana (`すばる`), `zh` in pinyin with tone marks (`běi dǒu`).
`aka`	`readonly string[]`	Other names it is called by, accepted by `find` (`六連星` for 昴). Empty for most.
`about`	`string`	A few English words on what it is (`the Pleiades`, `Orion's belt`), or an empty string.
`kind`	`AsterismKind`	Whether it is a constellation, an asterism or a Chinese mansion.
`group`	`string \| undefined`	For a Chinese mansion, the quarter of the sky it belongs to (`azure-dragon`, `black-tortoise`, `white-tiger`, `vermilion-bird`); `undefined` otherwise.
`partOf` (省略可)	`string \| undefined`	For a Chinese asterism, the enclosure (`purple-forbidden`, `supreme-palace`, `heavenly-market`) or the id of the mansion it is part of, where Wikidata states it; absent otherwise.
`missing`	`number`	At least how many of its stars are not held: fainter than visual magnitude 6.0, which the catalogue does not hold, or (for a figure read from a source that names stars by number) not named with a catalogue number in that source, so we cannot tell which. The figure draws only the stars we have. 0 where all are held or none is known to be missing.
`numbers` (省略可)	`Readonly<Record<number, number>> \| undefined`	Each held star's number in the figure, by Bright Star Catalogue number, where the culture numbers its stars: the Chinese sky's names do (角宿一 is star 1 of 角宿). `{ 5056: 1, 5107: 2 }` for 角宿; absent where the culture does not number them, and a star the source gives no number has none. The numbers are the source's, repeats and all: in the Chinese sky 斗宿 has two stars numbered 1 and 天園 two numbered 4 (Wikidata names them so), and 三台's pairs share theirs by design; the stars known by a proper name (the Northern Dipper's, 天狼) are numbered by their place in the package's list. A mansion's star 1 is its determinative star (距星) where one star has that number.
`chains`	`readonly (readonly number[])[]`	The stars as HR numbers: chains, each a run of stars joined one to the next; a chain of one is a single star.

例

import { chinese } from "@johnmorrisdotca/hoshi-stars/cultures/chinese";

const dipper = chinese.find("北斗")!;
console.log(dipper.name, dipper.readings.zh, dipper.chains.length);
// each star's number in the asterism: 角宿一 (Spica, HR 5056) is star 1
console.log(chinese.find("角宿")!.numbers);

北斗 běi dǒu 1
{ '5056': 1, '5107': 2 }

出力（このページを作ったときに実行した結果）

ソースを見る GitHub で編集@johnmorrisdotca/hoshi-stars 0.47.0 のソースから作成しました。

この日本語は、まだ日本語を母語とする方の確認を受けていません。訂正を歓迎します。

Asterism型

定義

メンバー

例

`Asterism`型