インストール¶
Mayavi自体はインストールするのが難しいパッケージではありませんが,残念ながら依存関係はかなり重いです.幸いなことに,これらの依存関係の多くはPyPIのwheelとして使用できるようになりました.
最新のVTKwheelは,すべての主要プラットフォーム(Windows,MacOS,およびLinux)で利用できますが,64ビットマシンでのみ利用できます.Python3.xはこれらすべてのオペレーティングシステムで,Python 2.7.xはMacOSとLinuxで完全にサポートされています.あなたのプラットフォームがサポートされていない場合は, General Build and Installation instructions
Python3.xでは, PyQt5 をインストールする必要があります.2.7.xには他にもオプションがあり, PySide , PyQt4 , wxPython を使うことができます.これらは,pipまたはパッケージマネージャからインストールできます.
現在,Mayavi自体は新しいwxPython4.xで動作するはずです.ただし, traitsui , pyface ,およびその他のETSパッケージではまだサポートされていないため,UIは正しく動作しません.古いバージョンでも動作するはずです.PyQt/PySideは,ほとんどそのままの状態で動作するはずです.PySide2はまだ若いのでYMMVです.
pip でのインストール¶
pip は, PyPA からPythonパッケージをインストールするための PyPA 推奨ツールです.PyPIで入手可能なMayaviの最新バージョンは, ここ で見ることができます.
pip を使用すると,必要なpythonパッケージを自動的にfetchしてインストールできます.
最新の安定版リリース¶
最新リリース4.6 .0以降では,Python3.xを使用していて64ビットマシンを使用している場合, pip によるインストールが最も簡単で,次のようになります.
$ pip install mayavi
$ pip install PyQt5
よし!
これができない場合は,上記のドキュメントを読み,VTKと適切なUIツールキットをインストールする方法を見つけて,上記の手順を繰り返します.
jupyterノートブックのサポートにも関心がある場合は,次の操作を行います(もちろん jupyter がインストールされていることを確認した後で).
$ jupyter nbextension install --py mayavi --user
$ jupyter nbextension enable --py mayavi --user
また, ipywidgets と ipyevents がインストールされている必要があります.これらは,pipまたは任意のパッケージマネージャを使用してインストールできます.
最新版¶
githubから最新バージョンのMayaviをインストールするには,次の手順を実行します.
$ git clone https://github.com/enthought/mayavi.git
$ cd mayavi
$ pip install -r requirements.txt
$ pip install PyQt5 # replace this with any supported toolkit
$ python setup.py install # or develop
上記の手順に従ってjupyter nbextensionsを追加すれば,準備は完了です.
Mayaviは,ETSの一部である複数のパッケージに依存しています.開発中のmayaviバージョンが,リリースされていないコンポーネントの一部の機能に依存している可能性があります.Mayaviが依存するETSパッケージは, apptools ,traits_ , traitsui , pyface ,および envisage_ です.これらのいずれかが必要な場合は,gitを使ってインストールすることもできます.いずれも比較的簡単にパッケージをインストールできます.
既製のディストリビューションのインストール¶
- Windows:
Windows環境でMayaviをインストールする最善の方法は, Enthought Canopy , Pythonxy , Anaconda などの完全なPythonディストリビューションをインストールすることです.Pythonxyについては,コンポーネントを選択するときにインストーラーで 'ETS' をチェックインする必要があることに注意してください.Pythonxyが使用するディスク容量を減らすには,ほかのコンポーネントのチェックを外します.
- MacOSX:
Pythonの完全なディストリビューション Enthought Canopy (Mayaviを含む)または Anaconda はMacOSXでも利用可能です.
- UbuntuまたはDebian:
- RedHat EL3およびEL4:
Pythonの完全なディストリビューション Enthought Canopy (Mayaviを含む)はRHEL3と4でも利用できます.
EDMは,無料で入手できるEnthoughtのPython環境マネージャーです.新しいPythonユーザは,軽量でカスタムなPython環境を作成できます.EDMの主な利点は,パッケージの依存関係を最先端の方法で確実に管理できることです.競合を解決し,一貫したパッケージ・バージョン・セットを確保できます.これは edmInstaller からダウンロードできます.
EDMはPython 2.7.xとPython3.xランタイムを提供します.Python 2.7がデフォルトバージョンです.EDMをインストールした後,端末から edm を使って簡単にmayaviをインストールできます.
$ edm install mayavi pyqt
これにより,mayaviと 'pyqt' がインストールされます.この後,次のコマンドを実行して,デフォルトのPythonバージョンでシェルを起動できます.
$ edm shell
これにより,MayaviがデフォルトのPython 2.7に設定されます.
python 3.6.xの場合は,次のコマンドを実行してインストールできます.
$ edm environments create --version 3.6 py3
ここで, 'py3' は環境の名前です.必要に応じて,この名前を別の名前に変更できます.環境を作成したら,次の手順でアクティブにできます.
$ edm shell -e py3
これで,次のようにmayaviをインストールできます.
$ edm install mayavi pyqt
'pyqt' は,python 3.6およびpython 2.7に対して明示的にインストールする必要があることに注意してください.
Condaは,複数バージョンのソフトウェア・パッケージとその依存関係をインストールするためのオープンソースのパッケージ管理環境管理システムです.CondaはAnacondaとMinicondaに含まれています.
Minicondaは小さな "bootstrap" バージョンで,conda,python,そしてそれらが依存するパッケージを含みます.オペレーティングシステムによっては, MinicondaInstaller をダウンロードできます.
condaをインストールしたら,コマンドラインから以下を実行する必要があります.
$ conda create -n pyconda python=3.5 pyqt=4
$ source activate pyconda
$ conda install -c menpo mayavi
これで準備万端です.Mayavi 4.6 .0以降では, pyqt=5
を使うこともできます.
Conda-forge によるインストール¶
conda-forgeはコミュニティ主導のインストール可能パッケージのcondaチャネルです.conda-forgeの詳細については,彼らの website にアクセスしてください.
conda-forgeを使用してインストールするには,次の手順に従います.
まず,環境のクローンを作成するか,環境を最初から構築します.
$ conda create --name pyforge --clone root
or
$ conda create --name pyforge python=2.7
次に,conda-forgeチャンネルを追加します.
$ conda config --add channels conda-forge
'pyforge' 環境をアクティブ化します.
$ source activate pyforge
同じキーワードが重複している場合は,最後のインスタンスが使用されます.
$ conda install vtk
$ conda install pyqt=4
最後に,Mayaviは次のようにインストールできます.
$ conda install mayavi
インストールのテスト¶
インストールがOKかどうかをテストする最も簡単な方法は,次のようにmayavi2アプリケーションを実行することです.
mayavi2
コマンドの詳細なヘルプを表示するには,次の操作を実行します.
mayavi2 -h
mayavi2
はmayaviアプリケーションです.win32などの一部のプラットフォームでは,"PythonXYScripts"フォルダにある"mayavi2.exe"プログラムをダブルクリックする必要があります.このディレクトリがパスにあることを確認してください.
注釈
Mayaviは他にもさまざまな方法で使用できますが,最初は mayavi2
アプリケーションが最も簡単です.
mayaviのソースtarballがある場合や,githubリポジトリからソースをチェックアウトしている場合は, mayavi*/examples
の例を実行してください.さまざまな機能を説明するスクリプト例は多数あります.テストは mayavi*/tests
サブディレクトリにあります.
テストスイート¶
tvtkとmayaviの基本的なテストスイートは,noseを使って実行できます.
nosetests -v tvtk/tests
nosetests -v mayavi
統合テストは次のように実行できます.
cd integrationtests/mayavi
python run.py
トラブルシューティング¶
インストールに問題がある場合は, ヘルプの表示 ページで情報の検索方法の詳細を確認するか,メーリングリストに電子メールを送ってください.