Celestia/目錄檔案參考

目錄檔案型別

Celestia 的宇宙包含三類主要天體

每個天體都由不同型別的目錄檔案定義。太陽系目錄（.ssc）檔案包含太陽系天體的定義； .dsc 檔案包含深空天體的定義；恆星可以在 .stc 檔案或 stars.dat 中定義，後者為二進位制格式。使用二進位制恆星格式是因為 Celestia 的宇宙包含的恆星數量遠超深空天體或太陽系天體，因此使用緊湊且快速載入的格式非常重要。

目錄檔案通用語法

除了二進位制 .DAT 恆星目錄外，所有其他目錄都是文字檔案，包含以類似格式排列的天體定義列表。每個定義都包含一個名稱，後跟一個屬性列表。屬性列表是由大括號分組的一組名稱-值對。以下是比鄰星的屬性列表

{
   RA 217.429167
   Dec -62.679444
   Distance 4.225
   SpectralType "M5.5V"
   AppMag 11.09
}

屬性名稱與天體型別相關。屬性值有相應的型別。在上面的例子中，除了 SpectralType 為字串外，所有屬性都是數字。Celestia 目錄檔案可以包含註釋 - 從井號 (#) 到行尾的任何文字都將被忽略。

數字值

Celestia 目錄檔案中的數字是一個標量實數值。非常大或非常小的值可以使用類似 C 語言的指數形式編寫，例如 1.2e-3 代替 .0012。有效數字值的示例

1234
3.14159265
1.234e10
0.1025
-2.24

.1025  (Celestia v1.5.0 or later)
+2.24  (Celestia v1.5.0 or later)

注意：Celestia v1.4.1 及更早版本存在兩個限制，在 v1.5.0 中已修復。在 Celestia v1.4.1 及更早版本中，所有數字必須以數字字元或減號開頭。不應該使用前導小數點或前導加號。也就是說，小於 1 的值必須包含前導 0：0.5 可以，但 .5 不行。另外，會自動假設前導 +。提供前導 + 會導致錯誤。

字串值

字串是由雙引號括起來的任意長度的字元序列。它們可以跨越多行，但字串內的任何換行符都將被逐字解釋。一些特殊字元可以用反斜槓開頭的轉義序列表示。

\": 雙引號字元
\n: 換行符
\\: 反斜槓
\uxxxx: Unicode 字元，其中 xxxx 是由四個十六進位制數字組成的序列

向量值

Celestia 目錄檔案中的向量是由方括號括起來的三個實數值列表。向量示例

[ 0 +1 0 ]
[ 1.2 -3.4 5 ]
[ 1.0e3 2.2 63 ]

屬性列表值

列表中的一些屬性具有複雜的值，這些值本身就是屬性列表。與頂層屬性列表一樣，這些屬性列表也只是一個由大括號括起來的一組名稱-值對。以下是如何在太陽系目錄（.ssc）檔案中設定名為 UniformRotation 的屬性的值

UniformRotation
{
   Period 24.0
   Inclination 23.5
}

（這只是一個示例，用於顯示格式。UniformRotation 指令在 Celestia v1.4.1 及更早版本中不受支援。它需要 Celestia v1.5.0。）

日期值

日期值可以寫成數字或字串。數字將被解釋為儒略日數。日期字串包含公曆的年份、月份和日期。它們可以選擇包含 hh:mm:ss 格式的時間。時間使用 24 小時制。負年份值用作公元前或 BCE 的替代；如果您想要公元前 1 年的日期，您應該將年份設定為零。（這是天文學慣例，與大多數日曆中使用的基督教慣例不同。基督教日曆沒有編號為 0 的年份。）

帶有解釋性註釋的日期值示例

2451545.0              # J2000 - noon January 1, 2000
2453023.1232
"2006 11 8"            # midnight November 8, 2006
"1984 12 25 1:30:00"   # 1:30am December 25, 1985
"-4 8 23 10:00:00"     # 10:00am August 23, 5 B.C.
"2130 4 1 22:10:34.15" # 22:10:34.15 April 1, 2130

從 Celestia v1.5.0 開始，所有目錄時間都使用 TDB（質心動力學時）時間尺度指定。但是，螢幕上的時間顯示為 UTC。TDB 與 UTC（協調世界時）相差 32.184 秒，加上一些整數秒的閏秒。截至 2006 年，TDB 比 UTC 快 65.184 秒。有關更多資訊，請參見關於時間尺度的頁面。