xarray

xarray：ND 標記數組和資料集

xarray （發音為“ex-array”，以前稱為xray ）是一個開源專案和 Python 包，它使標記多維數組的使用變得簡單、高效且有趣！

Xarray 在類似 NumPy 的原始陣列之上引入了維度、座標和屬性形式的標籤，從而提供了更直觀、更簡潔且不易出錯的開發體驗。該軟體包包括一個龐大且不斷增長的與領域無關的函數庫，用於使用這些數據結構進行高級分析和視覺化。

Xarray 受到 pandas 的啟發並大量借鑒，pandas 是一個流行的數據分析包，專注於標記的表格數據。它特別適合處理 netCDF 檔案（xarray 資料模型的來源），並與 dask 緊密整合以實現並行計算。

為什麼是 xarray？

多維（又稱 N 維，ND）數組（有時稱為“張量”）是計算科學的重要組成部分。他們涉足廣泛的領域，包括物理學、天文學、地球科學、生物資訊學、工程、金融和深度學習。在 Python 中，NumPy 提供了用於處理原始 ND 陣列的基本資料結構和 API。然而，現實世界的數據集通常不僅僅是原始數字；它們具有標籤，用於編碼有關數組值如何映射到空間、時間等位置的資訊。

Xarray 不僅僅追蹤數組上的標籤——它還使用它們來提供強大而簡潔的介面。例如：

• 按名稱對維度套用操作： x.sum('time') 。
• 按標籤而非整數位置選擇值： x.loc['2014-01-01']或x.sel(time='2014-01-01') 。
• 數學運算（例如， x - y ）基於維度名稱而不是形狀跨多個維度進行向量化（數組廣播）。
• 使用 groupby 進行靈活的分割-應用-組合操作： x.groupby('time.dayofyear').mean() 。
• 基於座標標籤的資料庫式對齊，可平滑處理缺失值： x, y = xr.align(x, y, join='outer') 。
• 以 Python 字典的形式追蹤任意元資料： x.attrs 。

文件

有關 xarray 的更多信息，請參閱其官方文件：https://docs.xarray.dev/。

嘗試互動式 Jupyter 筆記本。

貢獻

您可以在我們的貢獻頁面找到有關為 xarray 做出貢獻的資訊。

聯絡我們

• 在 GitHub 討論上提出使用問題（「我該怎麼做？」）。
• 報告錯誤、建議功能或查看 GitHub 上的原始程式碼。
• 對於不太明確的問題或想法，或宣布 xarray 用戶感興趣的其他項目，請使用郵件清單。

焦點數量

Xarray 是 NumFOCUS 的財政資助項目，NumFOCUS 是一家致力於支持開源科學計算社區的非營利組織。如果您喜歡 Xarray 並希望支持我們的使命，請考慮捐款以支持我們的努力。

歷史

Xarray 是 The Climate Corporation 開發的內部工具的演進。它最初由Climate Corp 研究人員Stephan Hoyer、Alex Kleeman 和Eugene Brevdo 編寫，並於2014 年5 月作為開源發布。成為NumFOCUS 的財政資助計畫。

貢獻者

感謝我們的眾多貢獻者！

執照

版權所有 2014-2024，xarray 開發者

根據 Apache 許可證 2.0 版（“許可證”）獲得許可；除非遵守許可證，否則您不得使用此文件。您可以在以下位置取得許可證副本：

https://www.apache.org/licenses/LICENSE-2.0

除非適用法律要求或書面同意，否則根據許可證分發的軟體均以「原樣」分發，不帶任何明示或暗示的保證或條件。請參閱許可證，了解許可證下管理權限和限制的特定語言。

Xarray 捆綁了 pandas、NumPy 和 Seaborn 的部分內容，所有這些都可以在「3-clause BSD」許可證下使用：

• 熊貓： setup.py ， xarray/util/print_versions.py
• NumPy： xarray/core/npcompat.py
• Seaborn： xarray/core/plot/utils.py中的_determine_cmap_params

Xarray 也捆綁了部分 CPython，可根據xarray/core/pycompat.py中的「Python Software Foundation License」取得。

Xarray 使用 icomoon 套件（免費版本）中的圖標，該套件可在「CC BY 4.0」授權下使用。

這些許可證的全文包含在許可證目錄中。