odatse-LEED のインストール¶

実行環境・必要なパッケージ¶

python 3.9 以上
- 必要なpythonパッケージ
  numpy (>= 1.14)
  
  pydantic (>= 2.0)
ODAT-SE version 3.0 以降
SATLEED
- コンパイルには Fortranコンパイラが必要

ダウンロード・インストール¶

ODAT-SE をインストールする
- ソースコードからのインストール
  
  リポジトリから ODAT-SE のソースファイルを取得します。
```
$ git clone https://github.com/issp-center-dev/ODAT-SE.git
```
  pip コマンドを実行してインストールします。
```
$ cd ODAT-SE
$ python3 -m pip install .
```
  --user オプションを付けるとローカル ($HOME/.local) にインストールできます。
  
  python3 -m pip install .[all] を実行するとオプションのパッケージも同時にインストールします。
SATLEED をインストールする
- SATLEED のソースコードは以下の URL から取得できます。
```
$ wget http://www.icts.hkbu.edu.hk/VanHove_files/leed/leedsatl.zip
```
- ファイルを展開し、所定の手続きに従ってコンパイルします。
  
  SATLEED は計算したい系の詳細によってソースコードのパラメータを適宜書き換える必要があります。 sample/leed にあるサンプルを実行する場合の書き換えとコンパイルを自動で行うスクリプト setup.sh が用意されています。
```
$ cd sample/mapper
$ sh ./setup.sh
```
  setup.sh を実行すると、 leedsatl ディレクトリに satl1.exe と satl2.exe が作成されます。
odatse-LEED をインストールする

odatse-LEED のソースファイルは GitHub リポジトリから取得できます。以下の手順でリポジトリをクローンした後、pip コマンドを実行してインストールします。
$ git clone https://github.com/2DMAT/odatse-LEED.git $ cd odatse-LEED $ python3 -m pip install .
--user オプションを付けるとローカル ($HOME/.local) にインストールできます。

odatse-LEED のライブラリと、実行コマンド odatse-LEED がインストールされます。

実行方法¶

ODAT-SE では順問題ソルバと逆問題解析アルゴリズムを組み合わせて解析を行います。 LEEDの解析を行うには次の2通りの方法があります。

このパッケージに含まれる odatse-LEED プログラムを利用して解析を行います。ユーザは、プログラムの入力となるパラメータファルを TOML 形式で作成し、プログラムの引数に指定してコマンドを実行します。逆問題解析のアルゴリズムはパラメータで選択できます。
odatse-LEED ライブラリと ODAT-SE フレームワークを用いてプログラムを作成し、解析を行います。逆問題解析アルゴリズムは import するモジュールで選択します。プログラム中に入力データの生成を組み込むなど、柔軟な使い方ができます。

パラメータの種類やライブラリの利用方法については以降の章で説明します。

アンインストール¶

odatse-LEED モジュールおよび ODAT-SE モジュールをアンインストールするには、以下のコマンドを実行します。

$ python3 -m pip uninstall odatse-LEED ODAT-SE