Wakusei Planets ドキュメント

Wakusei Planets 惑星 — The Sun, planets and moons for the web

太陽・惑星・衛星を、線画、陰影つきの絵、表面の地図で描きます。実際の大きさ・傾き・自転つきで、任意の日時の衛星の位置も分かります。

インストール

npm install @johnmorrisdotca/wakusei-planets

最初に読む

• はじめにページに惑星を1つ置いて、傾けたり回したりできるようにします。5分ほどです。

エントリーポイント

ガイド

やり方

• HTMLページにCDNから入れるscriptタグ1つで、jsDelivrやunpkgから惑星をページに入れます。陰影つきも同じです。
• Viteやwebpackなどのバンドラーで使うバンドラーのアプリで要素をimportします。必要な天体だけを選び、線画だけのページに three.js を入れないようにします。
• 自分のページに入れるデモで天体を決めて、HTML、ESモジュール、React、Vue、Angular、Svelte、iframe のそのまま動くコードをコピーします。
• React・Vue・Svelte・Angularで使うフレームワークごとのコンポーネントです。ブラウザー専用のimportは、サーバー描画が通らない場所に置きます。
• iframeで埋め込むiframe 1つで、自分のスクリプトなしに、他人のページに天体を出します。
• TypeScriptとNodeサーバーで天体をSVG文字列として描きます。衛星の位置を調べ、型を使います。
• 見た目と天体見た目、天体ごとのエントリー、three.js、画像、ページを軽く保つ決まり。
• 集合写真ビルダー太陽系の天体を好きなだけ一枚に並べ、光を当てて、コードや保存用の絵を取り出します。
• 衛星と時間ある日時の衛星の位置つきで惑星を描きます。時間を速く進めることもできます。
• 自分の three.js シーンで使う本物の太陽・惑星・冥王星・衛星を、すでにある three.js のシーンに置きます。chikyu-earth の宇宙ビューが例です。
• 座標変換度単位の角度、名前付き座標系、AU 単位の成分を使う純粋な座標変換。
• 場所から見た太陽と月緯度と経度から、太陽と月の位置、日の出と日の入り、月の出入りと月相を求めます。suncalc 2 と同じ名前で、より正確なエンジンです。
• 時刻ユリウス日、暦、時刻系、恒星時、火星の時刻。数キロバイトで、依存はありません。
• 望遠鏡なしで見える星6.0 等級までの5,080個の星。名前、位置、固有運動、距離、色。gzip で約100 kB、依存はありません。
• 宇宙ビュー地球・月・太陽・惑星を、好きな日時の場所に置きます。月の満ち欠けも、地球の昼の側も、本物の太陽の光から決まります。縮尺は二通り、時間は前にも後ろにも進み、地球から太陽系ぜんぶまでズームできます。
• 乗って見るカメラを動く点 (衛星、惑星、自分で用意したもの) に乗せて、その点が回る天体を真下や地平線の向きで見ます。天体は半径で決まるので、どの天体でも使えます。
• 有名な探査機パイオニア10号からウェッブ望遠鏡まで、有名な探査機10機。情報、航海の出来事、任意の日の位置を、JPL Horizons に合わせて用意しました。探査機ごとに別の表で、gzip で 2〜127 kB です。
• 近くにあるもの、近づく時刻ある日付に、ある天体にいちばん近い天体を、空の見かけの角度か宇宙での距離でさがします。2つの天体がいちばん近づく時刻も、JPL Horizons と秒の単位で比べて確かめています。
• ズームと移動パッケージのどの表示も、ドラッグ、ピンチ、ホイール、キーでズームも移動もできます。ページに操作部品は要りません。要素ごとのズームの範囲と、その理由、手を外す方法、共通のバーを足す方法も説明します。
• データファイル天体、軌道、探査機の表を使います。
• 自分でサーバーを動かす自分のコンピューターで小さな JSON サービスを動かします。

解説

• なぜパッケージが2つあるのかwakusei-planets と chikyu-earth がそれぞれ何をするか、どちらを入れればよいか、1つだけで使うときと2つ一緒に使うときを説明します。
• しくみ数値の出どころ、天体の向きの決め方、たくさん置いても軽い理由。
• アーキテクチャ事実、位置、線画、陰影つきの見た目、要素がどう組み合わさっているか、そして純粋な部分がどこでも動く理由を説明します。
• 精度惑星と衛星の位置が JPL Horizons からどれだけ離れているかを天体ごとに示し、それぞれの作り方を説明します。

困ったとき・よくある質問

• 困ったとき天体が出ない、のっぺりしている、動かないときに確かめること。

アップグレード

• アップグレードバージョンごとに対応が必要な変更と、使いたくなる新機能を説明します。

• 変更履歴@johnmorrisdotca/wakusei-planets 0.24.0 のソースから作成しました。
• すべてのエクスポートを1ページでapi.html
• 言語モデル向けのドキュメントllms.txt · llms-full.txt

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