検索ボックス用の名前の一覧

English

@johnmorrisdotca/hoshi-stars/names は検索ボックスに必要な一覧です。明るい 5,080 個の星と 110 個のメシエ天体が1行ずつあり、パッケージがすでに持つ表から作るので (新しいデータはありません)、検索するページだけが費用を払います。ほかの 11,788 個の NGC・IC 天体は、別のかたまり @johnmorrisdotca/hoshi-stars/names/ngc-ic です。

import { findName, nameRowById, nameRows } from "@johnmorrisdotca/hoshi-stars/names";
import { findNgcIc } from "@johnmorrisdotca/hoshi-stars/names/ngc-ic";

const star = findName("alpha Ori");
console.log(star.id, star.name.en, star.name.ja, star.pick);

const galaxy = nameRowById("m31");
console.log(galaxy.id, galaxy.name.en, galaxy.kind, galaxy.pick);

const nebula = findNgcIc("North America Nebula");
console.log(nebula.id, nebula.name.en, nebula.kind);

const rows = nameRows();
console.log(`${rows.length} rows, first ${rows[0].id}`);

betelgeuse Betelgeuse ベテルギウス S:2061
m31 Andromeda Galaxy galaxy D:M31
ngc7000 North America Nebula nebula
5190 rows, first sirius

出力:

betelgeuse Betelgeuse ベテルギウス S:2061
m31 Andromeda Galaxy galaxy D:M31
ngc7000 North America Nebula nebula
5190 rows, first sirius

1行の中身

引く

findName(text) は、大文字小文字・空白・アクセント・ギリシャ文字の書き方 (α、alpha、Alp、alf)、上付き数字 (π³)、離して書いた番号 (pi 3 Ori) を区別せず、文字列がちょうど指す1行を返します。Betelgeuse、alpha Ori、α Orionis、HR 2061、M 31、Messier 31、NGC 224、Andromeda Galaxy、ベテルギウス。2行が共有する文字列 (Alpha Centauri は α1 Cen と α2 Cen の両方) は、どれも返しません。searchNames(text, { limit, kinds }) は、先頭が合う行、続いて含む行を、それぞれ重みの順に返し、入力補完に使えます。NGC・IC のかたまりにも同じ3つがあります: ngcIcRows、ngcIcRowById、findNgcIc、searchNgcIc。

小さな最初のかたまり

検索ボックスが最初にほしいのは 135 kB ではなく約 20 kB です。@johnmorrisdotca/hoshi-stars/names/named は、通称のある 335 個の星と 110 個のメシエ天体 (445 行) だけを持ち、その上で nameRows、nameRowById、findName、searchNames がすぐに動きます。各行は、/names が同じ ID に返す行と、ID・名前・符号・位置まで同じなので、このかたまりの結果を見せておき、あとから /names (と /names/ngc-ic) を読んで残りを足しても、ID は変わりません。

import { findName, nameRows, searchNames } from "@johnmorrisdotca/hoshi-stars/names/named";

const rows = nameRows();
console.log(`${rows.length} rows, first ${rows[0].id}`);
console.log(findName("alpha Ori").id, findName("NGC 224").id);
console.log(searchNames("andro", { limit: 3 }).map((row) => row.id).join(" "));

445 rows, first sirius
betelgeuse m31
m31 alpheratz mirach

出力:

445 rows, first sirius
betelgeuse m31
m31 alpheratz mirach

335 個の星は、scripts/make-names-named.ts が明るい星の表から書き出す小さな表から読みます (NOTICE.md に出典のある Yale のデータで、新しいデータはありません)。ID は表を書くときに全体で決めてあるので、このかたまりは星の表を必要とせず、テストがスクリプトをもう一度走らせて、ディスク上の表と違えば失敗します。/names/named は gzip で 22.7 kB です。通称のない星 (alpha-centauri、hr-1234) は入っていません。ここで見つからない検索は /names へ進みます。

自分の一覧

3つの入口を作っている部品も公開してあります。自分の行のリスト（ひとつのカタログの行や、1ページ用の短いリスト）を持つページのためです。/namesと/names/namedにあり、deepSkyRow以外は/names/ngc-icにもあります。

• NAME_KINDSは、行がとれる種類（star、cluster、nebula、galaxy、other）の一覧で、型NameKindと同じ順です。
• nameKey(text)は、findNameが比べるときと同じに整えた文字列です。小文字にし、アクセントを除き、ギリシャ文字を綴り、空白を1つにし、上付き数字を数字にします。Messier 31、M 31、m31はどれもm31になり、NGC 0224はngc224になります。
• slugOf(text)は、文字列からアドレスに使えるIDを作ります。小文字の英数字の連なりを1つのハイフンでつなぎ、アクセントを除き、ギリシャ文字を綴ります。行のIDはこれで作っています。
• deepSkyRow(object, constellations)は、/deep-skyか/deep-sky/ngc-icの天体の行を返します。天体がある星座の名前のために、略号をキーにした星座の表を渡します。
• nameIndex(rows)は、行のリストに対する一覧です。rows(kinds)、byId(id)、find(text)、search(text, { limit, kinds })は、nameRows、nameRowById、findName、searchNamesと同じに働きます。行は重みの大きい順に出て、同じIDの行が2つあるとエラーになります。

import { constellations } from "@johnmorrisdotca/hoshi-stars/constellations";
import { deepSkyObject } from "@johnmorrisdotca/hoshi-stars/deep-sky";
import { NAME_KINDS, deepSkyRow, nameIndex, nameKey, slugOf } from "@johnmorrisdotca/hoshi-stars/names";

console.log(NAME_KINDS.join(" ")); // star cluster nebula galaxy other
console.log(nameKey("Messier 31"), nameKey("α Ori"), nameKey("NGC 0224")); // m31 alpha ori ngc224
console.log(slugOf("Rigil Kentaurus"), slugOf("Boötes")); // rigil-kentaurus bootes

const byAbbreviation = new Map(constellations().map((c) => [c.abbreviation, c]));
const row = deepSkyRow(deepSkyObject("M31"), byAbbreviation);
console.log(row.id, row.kind, row.pick); // m31 galaxy D:M31

const mine = nameIndex([row]);
console.log(mine.find("Messier 31").id, mine.rows(["star"]).length); // m31 0

star cluster nebula galaxy other
m31 alpha ori ngc224
rigil-kentaurus bootes
m31 galaxy D:M31
m31 0

大きさ

行は、パッケージがすでに持つ表から、最初に求められたときに作るので、コードの増分は数キロバイトです。/names は gzip で 135.7 kB (星の表とメシエの表)、/names/ngc-ic は 226.4 kB (大きな星雲星団の表だけで、星の表は含みません)。どちらも 60 kB を超えるので別のかたまりに分けてあり、手前に 22.7 kB の /names/named があります。星とメシエだけがほしいページは NGC・IC の表を読みません。JSON に書き出すと、名前の書き方をすべて並べるので元の表より大きくなります。/names の 5,190 行で gzip 約 300 kB (星 5,080 個で約 296 kB)、/names/ngc-ic の 11,788 行で約 332 kB (大半は銀河) です。自分のサイトで写しを送るなら、行ごとではなく、検索と表示に使う項目だけを送ってください。

わかっている欠け

• 明るい星の HD 番号がありません。 HD 39801 ではベテルギウスは見つかりません。ヘンリー・ドレイパー番号は /nearby の星にしかありません。輝星カタログにはその列があり、足すにはデータの作り直しが必要で、John の了承が要ります (チケット MODULES-1224)。
• バイエル符号もある星のフラムスティード番号 (ベテルギウスの 58 Ori) は、パッケージが出しているデータにないので、入力できる名前になりません。フラムスティード番号だけの星にはあります。
• 近くの星 5,565 個は、まだ行になっていません。