安裝 statsmodels¶
安裝 statsmodels 最簡單的方式是將其安裝為 Anaconda 發行版的一部分,這是一個用於資料分析和科學計算的跨平台發行版。這是大多數使用者建議的安裝方法。
同時也提供了從 PyPI、原始碼或開發版本安裝的說明。
Python 支援¶
statsmodels 支援 Python 3.8、3.9 和 3.10。
Anaconda¶
statsmodels 可透過 Anaconda 提供的 conda 取得。可以使用以下命令安裝最新版本
conda install -c conda-forge statsmodels
PyPI (pip)¶
若要使用 pip 取得 statsmodels 的最新發行版本
python -m pip install statsmodels
請點擊此連結至我們的 PyPI 頁面,直接下載 wheel 或原始碼。
對於 Windows 使用者,有時可以在此處找到非官方的最新二進位檔(wheel)。
取得原始碼¶
我們發佈新版本的頻率不高,但我們原始碼的主要分支通常適用於日常使用。您可以從我們的 github 儲存庫取得最新的原始碼。或者,如果您已安裝 git
git clone git://github.com/statsmodels/statsmodels.git
如果您想隨時掌握 github 上的原始碼更新,只需定期執行
git pull
在 statsmodels 目錄中。
從原始碼安裝¶
您需要安裝 C 編譯器才能建置 statsmodels。如果您是從 github 原始碼而不是原始碼發行版建置,那麼您還需要 Cython。您可以依照以下說明來設定 Windows 的 C 編譯器。
如果您的系統已設定 pip、編譯器和 git,您可以嘗試
python -m pip install git+https://github.com/statsmodels/statsmodels
如果您沒有安裝 pip 或想要更手動地執行安裝,您也可以輸入
python -m pip install .
statsmodels 也可以在 develop 模式下安裝,這會將 statsmodels 就地安裝到目前的 python 環境中。這樣做的好處是,當 python 解譯器重新啟動時,已編輯的模組將立即重新解譯,而無需重新安裝 statsmodels。
python -m pip install -e .
通常建議使用 --no-build-isolation
來加速建置過程。
編譯器¶
Linux¶
如果您使用 Linux,我們假設您已熟悉自行安裝 gcc。它很可能已經安裝了。
Windows¶
如果可能,強烈建議使用 64 位元的 Python。
對於 Windows 使用者來說,取得正確的編譯器尤其令人困惑。隨著時間的推移,Python 已使用各種不同的 Windows C 編譯器建置。本指南應有助於釐清哪個版本的 Python 預設使用哪個編譯器。
Mac¶
在 MacOS 上安裝 statsmodels 需要安裝 gcc,它提供合適的 C 編譯器。我們建議安裝 Xcode 和 Command Line Tools。
相依性¶
目前的最低相依性為
從 git 結帳建置時需要 Cython,但從 PyPI 執行或安裝則不需要
Cython >= 3.0.10 是從 github 建置程式碼所必需的,但從原始碼發行版則不需要。
鑑於發行週期較長,statsmodels 遵循寬鬆的時基相依性策略:最低相依性會延遲約一年半到兩年。我們下一次計畫的最低版本更新預計在 2020 年上半年。
選用相依性¶
cvxopt 是某些模型的正規化擬合所必需的。
Matplotlib >= 3 是繪圖函式和執行許多範例所必需的。
如果安裝了 X-12-ARIMA 或 X-13ARIMA-SEATS,則可用於時間序列分析。
pytest 是執行測試套件所必需的。
IPython >= 6.0 是在本機建置文件或使用筆記本所必需的。
joblib >= 1.0 可以用於加速某些模型的分散式估計。
jupyter 是執行筆記本所必需的。
可以透過修改安裝命令,與 statsmodels 一起安裝選用相依性
python -m pip install statsmodels[extras]
其中 <extras>
是要安裝的額外元件的逗號分隔列表(build
、develop
、docs
)。