困ったとき・よくある質問
トラブルシューティングとFAQ
星図が空になる、上下が逆になる、星図全体を横切る線が出る、星が見つからない、本と星座の形が違う、といったときの対処です。
星図が空になる
projectは、裏側の点にはundefinedを返します。orthographicとgnomonicでは、裏側は空の半分です。中心を確かめてください。描きたい星が中心から90度以内にある必要があります。scaleが小さすぎると星がすべて真ん中に集まり、大きすぎると星がページの外に出ます。stereographicなら、短い辺の約4分の1のscaleで半球が収まります。
星図の上下や左右が逆になる
これは仕様で、空を見上げた姿です。北が上で、東が左です。地図の向きにするにはmirror: trueを渡します。SVGの画面ではyが下向きですが、星図のyは上向きです。中心のy - at.yの位置に描いてください。
星図全体を横切る線が出る
全天の3つの図法では、図の端に継ぎ目があります。片側の星と反対側の星を結ぶ線は、図全体を横切る長い線になります。両端が図の半分より離れた線は描かないでください。0時をまたぐ境界の輪も同じです。大きく離れた2点の間では、ペンを上げます。
starByName("sirius")は動くがstarByName("alpha Canis Majoris")は動かない
名前は、ふつうの名前(Sirius)か、パッケージが書く形の符号(α CMa)で、大文字小文字は問いません。つづりで書いたギリシャ文字や属格は読みません。星座の星を探すにはstarsInを使ってください。
見えている星が表にない
表は6.0等以上の星です。もっと暗い星は入っていません。パッケージが星を推測することはありません。
本の星座と形が違う
線は自作です。図は星座の中の星だけを結ぶので、境界をまたぐ形(ペガスス座の大四辺形)は閉じていません。自分の線を引くこともできます。starByHrやstarByNameで星を探してください。
日本語のページでも星の名前は英語のつづり
パッケージに、星の日本語名はありません。日本語名があるのは星座(おおいぬ座)です。Siriusのような名前は、IAUのつづりです。
RangeError: ... declination must be between -90 and 90
図法は、渡された値を確かめます。-90〜90度の外の赤緯や、0以下のscaleはRangeError、数でないものはTypeErrorで、どちらも引数の名前が出ます。
星が多いと遅い
星1つが要素1つです。1,600個(5等)なら数ミリ秒で描けます。5,080個すべては、パソコンなら問題なく、古いスマートフォンでは遅くなります。キャンバスに描くか、図が小さいときは等級の限界を下げてください。
この日本語は、まだ日本語を母語とする方の確認を受けていません。訂正を歓迎します。