alvaDesc TOPはこちら

Q1. Dragon 7との違いは何ですか？

A. alvaDesc 1.0は2019年6月末までで販売終了となったDragon 7の開発元であるKode srl.が、新たな分子記記述子計算ソフトとして販売を開始したソフトウェアです。
Dragon 7と同様5,000個を超える多数の分子記述子を計算することができます。alvaDesc 1.0では、Dragon 7に比べより多い5,305個の記述子を計算することができます。
また，MACCS166, ECFP, PFPというハッシュ化された分子フィンガープリントの計算も可能です。
alvaDesc 1.0はDragon 7で提供されていたalvaDesc2.0_descriptors_type
・塩やイオン液体の記述子計算に対応
・相関分析・主成分分析等の解析機能
・GUI，CUIの2つのユーザーインタフェイスを利用でき，Windows, Linux, MacOSプラットフォームをサポート
という機能も同様に提供されます。

(2019/05/15)

Q2. Draon 7の分子記述子と違う所はどこですか？

A. Dragon 7の分子記述子は5,270個でしたが、alvaDesc 1.0では5,305個の分子記述子を計算することができます。alvaDesc 1.0の5,305個の記述子の内、5,270個はDragon 7と同じものです。それに加え、alvaDesc 1.0では新たに35個の記述子が利用できます。
また、alvaDesc1.0もDragon 7と同様に記述子全体が30のブロックに分けられています。ブロック毎の記述子数の比較、新たに加えられた記述子については下の表をご覧ください。

Dragon 7とalvaDesc 1.0の記述子数の比較

(*1) “CATS 2D” at Dragon 7 is included in “Pharmacophore descriptors” at alvaDesc 1.0

alvaDescで新たに加えられた35個の記述子

*

(*) new at alvaDesc

(2019年05月15日)

Q3. ユーザーマニュアルはありますか？

A. ソフトのユーザーマニュアルは、下記の方法によりご参照ください。
alvaDesc 1.0起動後、画面上部のメニューより、「Help」を選択し、「alvaDesc help」をクリックします。
Webブラウザが起動され、「alvaDesc 1.0 – User manual」が表示されます。

(2019/05/15)

Q4. alvaDesc Knimeプラグインのインストール方法は？

A. alvaDesc プラグインをKNIMEから直接ダウンロード可能です。

1. まず，KNIMEバージョンが、3.7.1以降であることを確認してください。
   （＊これより古いバージョンの場合、KNIME自体のアップデートをご検討ください）
2. KNIME操作画面から、File > Preference > Install/update > Available Software Sitesとして、「Alvascience update site」が存在するか確認してください．存在しない場合は，次の操作を行いサイトロケーションを追加してください。
   1. File > Preferences > Install/Update > Available Software Sitesを選択
   2. Add…ボタンをクリック
   3. Name欄に「Alvascience update site」を入力
   4. Location欄に「https://www.alvascience.com/knime/latest」を入力
   5. Addボタンをクリック
   6. Apply and Closeボタンをクリックして終了
3. 続けて，File > Install KNIME Extensions…を選択します。
4. リストの中から「Alvascience ~」を探し、「Alvascience alvaDesc Plugin」を選択します。
5. Nextボタンをクリックし、以降はKNIMEの指示に従い、インストールを進めてください．

(2020/09/23)

Q5. PythonからalvaDescを使う方法は？

A. alvaDescCLIWrapperをインストールすることにより、PythonからalvaDescCLIを呼び出して使えるようになります。次の手順に従ってインストールを行い、サンプルプログラム例を参照してお使いください。

インストール手順

1. ダウンロードページ（alvaDesc本体と同じ弊社DLページ）よりZIPファイルをダウンロードし、任意のディレクトリに展開します。

2. alvaDescCLIWrapperフォルダーの中に入っているセットアッププログラムをコマンドプロンプト上で実行します。

python setup.py install

実行要件

・ライセンスが付与されたバージョン 1.0.14以上のalvaDescがインストールされていること。

・Python 3.5以上がインストールされていること。

サンプルプログラム(Windows)

SMILES表記されたブタンとアスピリンのmolecular weight (MW)とaverage molecular weight (AMW)を計算させます。

from alvadesccliwrapper.alvadesc import AlvaDesc

# aDesc = AlvaDesc("C:/Program Files/Alvascience/alvaDesc/alvaDescCLI.exe")
# To remove blank space, use the command "dir /x" to confirm the short name.
# For example, > cd c:\ & dir /x

aDesc = AlvaDesc("C:/Progra~1/Alvascience/alvaDesc/alvaDescCLI.exe")

aDesc.set_input_SMILES(['CCCC', 'CC(=O)OC1=CC=CC=C1C(=O)O']) # set the molecules SMILES
if not aDesc.calculate_descriptors(['MW', 'AMW']):
    print('Error: ' + str(aDesc.get_error()))
else:
    print('Results: ' + str(aDesc.get_output()))

実行結果

※実行結果の見方

alvaDescCLI実行プログラムのデフォルト格納場所

Windows（＊）

C:/Program Files/Alvascience/alvaDesc/alvaDescCLI.exe

MacOS

/Applications/alvaDesc.app/Contents/MacOS/alvaDescCLI

Linux

/usr/bin/alvaDescCLI

（＊）”Program Files”に含まれるスペースが問題になるため，上記サンプルプログラムのようにMS-DOS短縮名に置き換える必要があります．このような場合，コマンドプロンプト等で親ディレクトリへ移動し，”dir /x”コマンドを実行し，短縮後のフォルダ名を確認することができます．下図で黄色で囲んだ”PROGRA~1″が短縮名になります．

example MS-DOS short name

入出力ファイルの指定

MDLファイルからの入力

aDesc.set_input_file(‘ファイル名.sdf’, ‘MDL’)

テキストファイルへの出力

aDesc.set_output_file(‘ファイル名.txt’)

• set_output_fileを使用すると計算結果はalvaDescの標準形式でファイルに出力されます。get_outputを使用する場合はこの機能を使用することができません。

記述子の計算

選択した記述子の計算

aDesc.calculate_descriptors([‘記述子1’, ‘記述子2’, …])

全ての記述子の計算

aDesc.calculate_descriptors(‘ALL’)

フィンガープリントの計算

MACCS166

aDesc.calculate_fingerprint(‘MACCSFP’)

ECFP(1024ビット長)

aDesc.calculate_fingerprint(‘ECFP’, 1024)

NumPy/Pandas dataframeへの記述子計算結果のコンバート

get_output、get_output_descriptors、get_output_molecule_namesを使用してNumPyやPandas dataframeに計算結果のデータをコンバートすることができます。（alvaDescCLIWrapper ver. 1.0.4より）

サンプルプログラム

import numpy as np
import pandas as pd
from alvadesccliwrapper.alvadesc import AlvaDesc

aDesc = AlvaDesc() # Windows is the default
aDesc.set_input_SMILES([‘C#N’, ‘CCCC’, ‘CC(=O)OC1=CC=CC=C1C(=O)O’])
if not aDesc.calculate_descriptors([‘AMW’, ‘MW’, ‘nBT’]):
print(‘Error: ‘ + aDesc.get_error())
else:
res_out = aDesc.get_output()
# get molecule names according to alvaDescCLI standard
res_mol_names = aDesc.get_output_molecule_names()
res_desc_names = aDesc.get_output_descriptors()

# NumPy array of array and matrix
numpy_array_of_array = np.array([np.array(xs) for xs in res_out])
numpy_matrix = np.matrix(res_out) # NumPy matrix
print(‘NumPy matrix’)
print(numpy_matrix)

# Pandas dataframe
pandas_df = pd.DataFrame(res_out)
pandas_df.columns = res_desc_names
pandas_df.insert(loc=0, column=’NAME’, value=res_mol_names)
print(‘Pandas dataframe’)
print(pandas_df)

結果

NumPy matrix
[[ 4.1529 58.14 13. ]
[ 8.5795 180.17 21. ]]
Pandas dataframe
NAME AMW MW nBT
0 Molecule1 4.1529 58.14 13.0
1 Molecule2 8.5795 180.17 21.0

使用可能なクラス・メソッド

alvaDescCLIWrapperで使用可能なクラス・メソッドの説明ドキュメントは、zipファイル展開後、docフォルダ内のHTMLファイルをご参照ください（例. v1.0.4の alvadesc.html）。

(2021/7/8)

Q6. alvaDescの評価版を使用する方法を教えて下さい（Windows版）

A. alvaDescは無償評価ライセンスをご提供可能です。以下の手順にて、alvaDescの全ての機能を1ヶ月程度ご試用可能になります。尚、ご試用期間中は商用目的にお使いにはなれません。

1. alvaDescソフトウェアのダウンロード

• 弊社からダウンロード用ページのアドレスとログインID／パスワードを別途お知らせ致します。
• ダウンロード用ページにログインし、ご希望のインストーラをダウンロードして下さい。

2.ライセンスリクエストファイルの生成

• ダウンロードされたインストーラを起動し、インストールを行って下さい。
• インストールが完了し、ソフトウェアが立ち上がりましたらライセンス確認画面が表示されます。
• License file not foundと赤字で表示されますので、下の”Request License”ボタンを押下して下さい。
• explorer画面が立ち上がりますので、areqというファイル名を拡張子は変更せず、適当なファイル名に変更し、保存するフォルダを選択し保存して下さい。

3.ライセンスリクエストファイルの送付

• 上記で保存したareqファイルを下記英文情報と共に弊社営業担当までお送り下さい。
• 英文情報

———————————-

Name :

Organization :

Department :

Address :

Phone : +81-

Email :

———————————-

4.ライセンスのインポート

• 開発元からライセンスファイルが弊社に到着次第、お客様にご送付致しますので、適当なフォルダに保存して下さい。
• alvaDescソフトウェアを立ち上げて頂き、License画面下の”Import License”ボタンを押下して下さい。
• explorer画面で保存されたライセンスファイルを指定し”開く”を押下し、ライセンス情報が表示されたら、”Close”ボタンを押下して下さい。
• エンドユーザーライセンス契約が表示されますので、お読みになられた上で問題なければ、中段左にあるチェックボックスをクリックした上で、右下の”I accept”ボタンを押下して下さい。
• これでalvaDescが使用できるようになりました。

(2020/3/24)

Q7. alvaDescのインストール方法を教えて下さい（Windows版）

A. 既に無償評価ライセンスでお使いの場合と新規でインストールされる場合など、以下のケースをご参照下さい。

1.既に無償評価ライセンスでお使いの場合（同じマシンでお使いになる場合）

• alvaDescをご試用されたマシンでお使いになる場合、インストールされたalvaDescソフトウェアをそのままお使い頂けます。
• 弊社よりライセンスファイルをお送りしますので、適当な場所に保存して下さい。（ライセンスリクエストファイルを再度お送り頂く必要はございません。）
• alvaDesc上部メニューの”Help”より”Product license”を選択して頂き、License画面で”Import License”を押下し、保存されたライセンスファイルをインポートして下さい。

2.既に無償評価ライセンスでお使いの場合（ご試用とは別のマシンでお使いになる場合）

• 「新規にインストールされる場合」をご参照下さい。

3.新規にインストールされる場合（シングルライセンス）

i) alvaDescソフトウェアのダウンロード

• 弊社からダウンロード用ページのアドレスとログインID／パスワードを別途お知らせ致します。
• ダウンロード用ページにログインし、ご希望のインストーラをダウンロードして下さい。

ii) ライセンスリクエストファイルの生成

• ダウンロードされたインストーラを起動し、インストールを行って下さい。
• インストールが完了し、ソフトウェアが立ち上がりましたらライセンス確認画面が表示されます。
• License file not foundと赤字で表示されますので、下の”Request License”ボタンを押下して下さい。
• explorer画面が立ち上がりますので、areqというファイル名を拡張子は変更せず、適当なファイル名に変更し、保存するフォルダを選択し保存して下さい。

iii) ライセンスリクエストファイルの送付

• 上記で保存したareqファイルを下記英文情報と共に弊社営業担当までお送り下さい。
• 英文情報

———————————-

Name :

Organization :

Department :

Address :

Phone : +81-

Email :

———————————-

iv) ライセンスのインポート

• 開発元からライセンスファイルが弊社に到着次第ライセンスファイルをお客様にご送付致しますので、適当なフォルダに保存して下さい。
• alvaDescソフトウェアを立ち上げて頂き、License画面下の”Import License”ボタンを押下して下さい。
• explorer画面で保存されたライセンスファイルを指定し”開く”を押下し、ライセンス情報が表示されたら、”Close”ボタンを押下して下さい。
• エンドユーザーライセンス契約が表示されますので、お読みになられた上で問題なければ、中段左にあるチェックボックスをクリックした上で、右下の”I accept”ボタンを押下して下さい。
• これでalvaDescが使用できるようになりました。

4 新規にインストールされる場合（サイトライセンス）

i) サイトライセンスファイルのご送付

• お申込み頂いた情報に基づき、サイトライセンス用のライセンスファイルをご送付致します。適当な場所に保存して下さい。

ii) alvaDescソフトウェアのダウンロード

• 弊社からお知らせするダウンロード用ページにご提供するログインID／パスワードでログインし、ご希望のインストーラをダウンロードして下さい。

iii) ライセンスのインポート

• alvaDescソフトウェアを立ち上げて頂き、License画面下の”Import License”ボタンを押下して下さい。
• explorer画面で保存されたライセンスファイルを指定し”開く”を押下し、ライセンス情報が表示されたら、”Close”ボタンを押下して下さい。
• エンドユーザーライセンス契約が表示されますので、お読みになられた上で問題なければ、中段左にあるチェックボックスをクリックした上で、右下の”I accept”ボタンを押下して下さい。
• alvaDescがご使用になれます。

(2021/2/9)

Q8. alvaDescのアップデート方法を教えて下さい（Windows版）

A. alvaDescにはアップデート版があるかどうかを自動的にチェックする機能がありますので、下記に従ってアップデートを行って下さい。

• ご使用中のalvaDescの上部メニューから”Help” → “About alvaDesc”を選びます。
• About画面が立ち上がって来ますので、中段にある”Check for updates”のチェックボックスにチェックが入っているかどうか確認します。チェックが入っていれば、アップデート版があるかどうか自動でチェックしてくれます。
• アップデート版がある場合、Update available (v x.x.x) がリンク表示されますので、そのリンクをクリックして下さい。
• explorerが立ち上がりますので、アップデート版のインストーラを保存するフォルダを選択し”保存”を押下して下さい。
• 保存したインストーラを実行し、セットアップウィザードに従ってアップデートを完了させて下さい。

尚、v.1.0.xからv.2.0.xへのアップデートなど、メジャーバージョンアップの場合には、”Check for updates”の下に”Version 2 available, please contact your reseller or Alvascience.com to upgrade”などと表示されます。

その場合は、弊社ダウンロードサイトより新しいバージョンのインストーラをダウンロードし、セットアップを行って下さい。

(2020/3/24)

(2023/3/7追記)

Q9. alvaDescを使用しているマシンが壊れてしまい新しいマシンで使用したいのですが、どうすれば良いですか？

A. alvaDescのシングルライセンスはマシン毎に固有のライセンスとなっていますので、別のマシンにエクスポートしてご使用することはできません。ご使用中のライセンスの有効期間内であれば、無償にて新しいマシン向けのライセンスを発行することが可能です。上記 「新規にインストールされる場合（シングルライセンス）」をご参照の上、新規ライセンス発行依頼の理由を記載したメールに新規マシンのリクエストファイルを添付して弊社テクニカルサポート宛て（help@affinity-science.com）にお送り下さい。

尚、サイトライセンスの場合、マシン固有となっておりませんので、お使いのライセンスを新しいマシンに適用して下さい。

(2020/3/24)

Q10. Linux版のインストーラはどれを使えば良いのでしょうか？

A. alvaDescには以下にあげる3種類のLinux版インストーラがあります。

1 DEBパッケージ（Debian系）

alvaDesc_Linux_64_v*.deb

UbuntuなどDebian系Linux用のディストリビューションです。

インストールコマンド例（管理者権限が必要）

$ sudo apt install alvaDesc_Linux_64_v*.deb

インストール先

/usr/bin/ の下にalvaDescCLI、alvaDescGUIがインストールされます。

/usr/share/ の下にhelp file（html）がインストールされます。

2 RPMパッケージ （Red Hat系）

alvaDesc_Linux_64_v*.rpm

Red Hat系のLinuxやTurbolinuxでのプログラムの配布形式RPM（Redhat Package Manager）でのインストーラです。

インストールコマンド例（管理者権限が必要）

$ rpm -Uvh alvaDesc_Linux_64_v*.rpm

インストール先

/usr/bin/ の下にalvaDescCLI、alvaDescGUIがインストールされます。

/usr/share/ の下にhelp file（html）がインストールされます。

3 TGZファイル（Generic）

alvaDesc_Linux_64_v*.tgz

tarコマンドでまとめたアーカイブファイルをgzipコマンドで圧縮したファイルです。

管理者権限が使用できない場合でもインストールすることができますので、そのような場合にお使い下さい。

インストール（管理者権限がある場合）

インストールコマンド例
$ tar -xf alvaDesc_Linux_64_v*.tgz -C /

インストール先

-C / 　を指定することによりDEBパッケージと同様に
/usr/bin/ の下にalvaDescCLI、alvaDescGUIがインストールされます。
/usr/share/ の下にhelp file（html）がインストールされます。

インストール（管理者権限が使用できない場合）

インストールコマンド例

$ tar -xf alvaDesc_Linux_64_v*.tgz -C /home/[user_name]/alvaDesc/

インストール先
-C /alvaDescをインストールする任意のディレクトリ/ 　を指定すると、指定したディレクトリの中に usrディレクトリが作られ、
その下にbin、shareが生成されます。

これにより管理者権限が利用できない場合でもalvaDescをインストールし、使用することができます。
但し、alvaDescGUIからHelpを参照しようとすると、デフォルトで /usr/share/を見に行く仕様となっているためそのままでは参照はできません。
ログインシェルに対応する設定ファイル（.bashrcや.cshrcなど）にalvaDescのヘルプファイルの場所に関する環境変数を設定することで、
alvaDescのGUIよりヘルプページを参照することができるようになります。
例）

export HELPFILE_ALVADESC=/home/[user_name]/alvaDesc/usr/share/alvaDesc/help/index.html

(2020/3/24)

Q11. ライセンスファイルのインストールディレクトリを変更する（Linux版）

通常の認証では、$HOME/.config/Alvascience/alvaDesc/alvalicense_alvaDesc.alic としてライセンスファイルが格納されます。

サイトライセンスなどマルチユーザー環境の場合、環境変数 LICENSEFILE_ALVADESC を使用し、このインストールディレクトリを変更可能です。

例）

export LICENSEFILE_ALVADESC=/opt/alvaDesc/alvalicense_alvaDesc.alic

もしくは、同ファイルをalvaDescGUI、alvaDescCLIと同じディレクトリに格納することでライセンスを認証させることも可能です。

(2020/6/29)

Q12. よく使われているECFP4を計算させるための設定を教えて下さい

A.　alvaDescのフィンガープリントの計算オプションでは、ECFPの場合、中心原子からの最大半径をMaximum lengthと表示しています。ECFP4などフィンガープリント名の最後につく数字は直径を表しておりますので、Maximum length = 半径（radius） = 2 の場合、直径（diameter）は４となります。ビット長は一般的に1024ビットが使用されていますので、alvaDescのECFP計算をデフォルト設定で行いますと、ECFP4を計算させていることになります。

また同様に、PFP計算ではMaximum lengthは最大のパス長（maximum path length）を表しています。

尚、計算されるフィンガープリントはハッシュ化計算がされておりますので、他のツールやソフトウェアから得られた同様のフィンガープリント（例えばECFP4）と同列に比較することはできません。

(2021/5/25)

Q13. 記述子を保存する際の変数削減（Variable reduction）オプションの詳細が知りたい

A. 「Save descriptors」→「Variable reduction」で出力する記述子の数を減らす変数削減として6つのオプションがあります。

このオプションを利用することで、その後の解析の際に邪魔になる記述子を取り除き、データサイズを小さくすることができます。

1. Constant values:

すべての値が同じ場合（定数）、その記述子は保存されません。

2. Near constant values:

記述子が、1つの値だけが異なり残りの値が全て同じ場合（定数）、“near constant value”とみなされその記述子は保存されません。

3. Standard deviation less than:

標準偏差が指定された閾値より小さい記述子は保存されません。

4. At least one missing value:

一つでも欠損値（na）がある記述子は保存されません。

5. All missing values:

すべてが欠損値（na）となっている記述子は保存されません。

6. Pair correlation larger or equal to:

高速V-WSPアルゴリズム※を用いて、指定された閾値以上の相関係数を示す記述子ペアのどちらか一方を自動的に削除します。尚、閾値は相関係数の絶対値を表わしており、正の相関、負の相関共に削除が行われます。

※V-WSPアルゴリズム：

記述子の削減は以下の手順で行われます。

ⅰ．最も相関係数の値が高い記述子のペアを抽出。

ⅱ．抽出された二つの記述子から他の記述子との相関係数の総和を算出して比較し、値が高い方（似通った記述子がより多い方）の記述子を取り除く。

ⅲ．指定された閾値以上の相関係数を持つ記述子ペアが他に存在しているのであれば、ⅰ．に戻り作業を繰り返す。

参考文献

Ballabio, D., Consonni, V., Mauri, A., Claeys-Bruno, M., Sergent, M., & Todeschini, R. (2014), A novel variable reduction method adapted from space-filling designs, Chemometrics and Intelligent Laboratory Systems, 136, 147–154.

https://doi.org/10.1016/j.chemolab.2014.05.010

(2021/5/27) (2022/6/9追記)

Q14. alvaDescのWindows PCへのインストール方法について知りたい

A. こちらのドキュメントをご覧下さい。

(2021/6/3)

Q15. alvaDescのアンインストール方法を教えて下さい（Windows版）

A. WindowsのスタートメニューにあるAlvascienceフォルダを開けると、「alvaDescをアンインストールする」メニューがありますので、クリックし、ユーザーアカウント制御のダイアログからアンインストールすることができます。

また、Windowsの「設定」からアプリ > アプリと機能 を選択し、現れたアプリの中にあるalvaDescの右のメニューからアンインストールをクリックし、アンインストールボタンを押下することによりアンインストールすることもできます。

アンインストールした後でもライセンスファイルはそのまま残ります。特定バージョンのalvaDescに切り替えてご使用されたい場合、現在ご使用のバージョンをアンインストール後、ご使用されたい別のバージョンをインストールされるだけでご利用頂くことができます。

(2022/4/5)

Q16. alvaDescに入っている全記述子のデータタイプ（整数、浮動小数点数、ブーリアンなど）がまとめられた表はありますか

A. こちらからデータタイプがまとめられたExcelファイルをダウンロードしていただくことができます。

(2022/6/9)

Q17. Editメニューの “Copy as SMILES”で生成されるSMILESはCanonical SMILESですか

A. “Copy as SMILES”で生成されるSMILESはCanonical SMILESです。

alvaDescは、入力された分子に対してニトロ基の標準化と芳香族化の標準化を行った後でcanonicalize(正準化)してSMILESに変換します。

但し，canonicalizeのアルゴリズムはツール毎に違っており、alvaDescで生成したものが他のツールで生成したSMILESと異なるケースもあり得ます。alvaDescの場合立体化学を考慮していないため、同じ立体化学をもつ同じ分子でも異なるSMILESになることもあり得ます。

次の文献をご参照ください。
Neglur, G., Grossman, R. L., & Liu, B. (2005). Assigning Unique Keys to Chemical Compounds for Data Integration: Some Interesting Counter Examples. In Data Integration in the Life Sciences (Vol. 3615, pp. 145–157). https://doi.org/10.1007/11530084_13)

(2022/10/4)

Q18. Ubuntu環境でalvaDescCLIWrapperをセットアップして使用する方法を教えて下さい

A. PythonでalvaDescCLIWrapperをセットアップすることにより、Ubuntu環境に既にインストールされているalvaDescをPythonから呼び出して使用することができます。なお、alvaDescは1.0.14以上、Pythonは3.5以上が必要です。

・準備

alvaDescCLIのインストールディレクトリとライセンス状況を確認します。

egghead@DESKTOP-BKJHQMR:~/temp$ which alvaDescCLI
/usr/bin/alvaDescCLI
egghead@DESKTOP-BKJHQMR:~/temp$ alvaDescCLI --license
Your license will expire on 2023/3/31
alvaDescCLI.
Version 2.0 for Linux (x86_64) - v.2.0.14 - built on: 2022/11/11
Your license is valid
License file: /home/egghead/.config/Alvascience/alvaDesc/alvalicense_alvaDesc.alic
Organisation: Affinity Science Corporation
Contact: Affinity Science Corp.
Use: Commercial
Type: Site
Expiration: 2023/3/31
egghead@DESKTOP-BKJHQMR:~/temp$

※Linux用のデフォルトでは、alvaDescCLI実行プログラムは /usr/bin/alvaDescCLI に格納されています。デフォルトディレクトリ以外に格納されていましたら、適宜変更ください。

・セットアップ

まず、ダウンロードしたalvaDescCLIWrapperのzipファイルを展開します。

egghead@DESKTOP-BKJHQMR:~/temp$ unzip python-alvaDesc_all_0_v1_0_6.zip
Archive: python-alvaDesc_all_0_v1_0_6.zip
creating: alvaDescCLIWrapper/
creating: alvaDescCLIWrapper/alvadesccliwrapper/
inflating: alvaDescCLIWrapper/alvadesccliwrapper/alvadesc.py
extracting: alvaDescCLIWrapper/alvadesccliwrapper/__init__.py
inflating: alvaDescCLIWrapper/CHANGES.txt
creating: alvaDescCLIWrapper/doc/
inflating: alvaDescCLIWrapper/doc/alvadesc.html
inflating: alvaDescCLIWrapper/LICENSE.txt
inflating: alvaDescCLIWrapper/README.txt
inflating: alvaDescCLIWrapper/setup.py
egghead@DESKTOP-BKJHQMR:~/temp$

次に、セットアップスクリプトを実行します。

egghead@DESKTOP-BKJHQMR:~/temp$ cd alvaDescCLIWrapper/
egghead@DESKTOP-BKJHQMR:~/temp/alvaDescCLIWrapper$ sudo python3 setup.py install
running install
（途中省略）
Installed /usr/local/lib/python3.8/dist-packages/alvadesccliwrapper-1.0.0-py3.8.egg
Processing dependencies for alvadesccliwrapper==1.0.0
Finished processing dependencies for alvadesccliwrapper==1.0.0
egghead@DESKTOP-BKJHQMR:~/temp/alvaDescCLIWrapper$ cd ..
egghead@DESKTOP-BKJHQMR:~/temp$

※この例ではシステムディレクトリにインストールするため管理者権限が必要です。

・サンプルスクリプトの作成と実行

セットアップが終了したら、次のサンプルプログラムscript.pyを作成してみます。

from alvadesccliwrapper.alvadesc import AlvaDesc

def get_descriptors_from_block(list_descriptors, block_name):
    # [1]: Name
    # [3]: Block
    descs = [desc[1] for desc in list_descriptors if desc[3] == block_name]
    return descs
aDesc = AlvaDesc('/usr/bin/alvaDescCLI')

list_descriptors = aDesc.get_descriptors()
const_descriptors = get_descriptors_from_block(list_descriptors, 'Constitutional indices')

aDesc.set_input_SMILES(['C#N', 'CCCC', 'CC(=O)OC1=CC=CC=C1C(=O)O'])

if not aDesc.calculate_descriptors(const_descriptors):
    print('Error: ' + aDesc.get_error())
else:
    print(aDesc.get_output_descriptors())
    print(aDesc.get_output())

このサンプルは、SMILESで与えられた3つの分子’C#N’、‘CCCC’、‘CC(=O)OC1=CC=CC=C1C(=O)O’に対して’Constitutional indices’のブロックに含まれる記述子を計算させるプログラムです。alvaDescCLIのパスはwhichコマンドの出力等を参照し、適宜修正して下さい。

次に、作成したサンプルスクリプトを実行します（sample.pyはtempディレクトリに保存されている前提です）。

egghead@DESKTOP-BKJHQMR:~/temp$ python3 script.py
['MW', 'AMW', 'Sv', 'Se', 'Sp', 'Si', 'Mv', 'Me', 'Mp', 'Mi', 'GD', 'nAT', 'nSK', 'nAA', 'nTA', 'nBT', 'nBO', 'nBM', 'SCBO', 'RBN', 'RBF', 'nDB', 'nTB', 'nAB', 'nH', 'nC', 'nN', 'nO', 'nP', 'nS', 'nF', 'nCL', 'nBR', 'nI', 'nB', 'nHM', 'nHet', 'nX', 'H%', 'C%', 'N%', 'O%', 'X%', 'nCsp3', 'nCsp2', 'nCsp', 'Fsp3', 'max_conj_path', 'nStructures', 'totalcharge'] [[27.03, 9.01, 2.0214, 3.1018, 2.0057, 3.4983, 0.6738, 1.03393333333333, 0.668566666666667, 1.1661, 1.0, 3.0, 2.0, 0.0, 2.0, 2.0, 1.0, 1.0, 3.0, 0.0, 0.0, 0.0, 1.0, 0.0, 1.0, 1.0, 1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 33.3333333333333, 33.3333333333333, 33.3333333333333, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 1.0, 0.0], [58.14, 4.15285714285714, 6.634, 13.418, 7.807, 16.076, 0.473857142857143, 0.958428571428572, 0.557642857142857, 1.14828571428571, 0.5, 14.0, 4.0, 0.0, 2.0, 13.0, 3.0, 0.0, 3.0, 1.0, 0.0769230769230769, 0.0, 0.0, 0.0, 10.0, 4.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 71.4285714285714, 28.5714285714286, 0.0, 0.0, 0.0, 4.0, 0.0, 0.0, 1.0, 0.0, 1.0, 0.0], [180.17, 8.57952380952381, 13.9664, 21.8436, 13.8636, 23.4984, 0.665066666666667, 1.04017142857143, 0.660171428571428, 1.11897142857143, 0.166666666666667, 21.0, 13.0, 6.0, 4.0, 21.0, 13.0, 8.0, 18.0, 3.0, 0.142857142857143, 2.0, 0.0, 6.0, 8.0, 9.0, 0.0, 4.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 4.0, 0.0, 38.0952380952381, 42.8571428571429, 0.0, 19.047619047619, 0.0, 1.0, 8.0, 0.0, 0.111111111111111, 8.0, 1.0, 0.0]] 
egghead@DESKTOP-BKJHQMR:~/temp$

この例では、記述子記号、値が標準出力に表示されています。

・使用可能なクラス・メソッド

alvaDescCLIWrapperで使用可能なクラス・メソッドの説明ドキュメントは、zipファイル展開後にdocフォルダ内のHTMLファイルをご参照ください（alvaDescCLIWrapper/doc/alvadesc.html）。簡単なサンプルプログラムも掲載されています。

(2023/1/19)

Q19. alvaDescをコマンドラインインターフェース（CLI）から使用する方法を教えて下さい

A. CLIからの使用は、入力する化合物がとても多い場合や他のプログラムと連携して使用する場合など、alvaDescの計算をバックグラウンドでバッチ処理できるので便利です。alvaDescをCLIから使用するには、alvaDescのGUI実行プログラムと同時にインストールされるalvaDescCLI実行ファイルを使用します。 

デフォルト格納ディレクトリ

以下の使用例では、環境変数PATH/Pathにこれらのディレクトリが登録されており、alvaDescCLI実行ファイルを（パス指定することなく）直接実行できることを前提としています。

使用例（Windows/Linux/MacOS共通）

1つのSMILES文字列を入力として，指定記述子を計算

alvaDescCLI --iSMILES=CO --descriptors=MW,MLOGP

出力

alvaDescCLI.
Version 2.0 for Win64 (x86_64) - v.2.0.14 - built on: 2022/11/11
alvaDesc Commercial Site license. Expiration date: 2023/12/31
Licensee: Affinity Science Corporation
Date: 木曜日, 09 2月 2023
Time: 16:51:40
32.05 -0.814

MACCS166計算

alvaDescCLI --iSMILES=CCO --maccsfp

標準入出力を使用した記述子計算

alvaDescCLI --input --inputtype=SMILES --descriptors=MW,nAA,ChiralCenter,MLOGP --labels < sample.smi > output.txt

• iSMILESの場合は、descriptorsで指定した記述子の順序が考慮されますが、それ以外では、記述子リストの順番で出力されます。labelsオプションでご確認ください。

input/outputオプションを使用した入出力ファイルの指定

alvaDescCLI --descriptors=ALL --input=sample.sdf --outpupt=output.txt --labels

• 入力ファイルの拡張子でファイル形式が判定されます。

コマンドヘルプの表示

alvaDescCLI -h

パイプを利用した入力構造の指定

echo CCO | alvaDescCLI --input --inputtype=SMILES --ecfp

• Linux/MacOSでは、”echo -e “C\nCC\nCCC”などとして、改行コードを含めることで複数化合物の一括処理も可能です。

パイプとファイルを利用した入力構造の指定

（Windows）

type sample.smi | alvaDescCLI --input --inputtype=SMILES --descritpors=ALL2D

（Linux/MacOS）

cat sample.smi | alvaDescCLI --input --inputtype=SMILES --descritpors=ALL2D

alvaDescCLIの詳細は、GUIのHelp メニューから alvaDesc Help を選択し、表示されるマニュアルの3. Command-line Interfaceをご参照ください。

(2023/2/9)

Q20. バージョンアップがあった場合、現在有効なライセンスを持っていれば新バージョンは使えるのでしょうか

A. alvaDescのライセンス形態は次の2つに分けられており、形態により新バージョンの使用可否が違ってきます。

1. 企業向け一般ライセンス（商用）：年間（Rent）ライセンスとなります。
2. アカデミックライセンス（教育用）：永久（Permanent）ライセンスのみとなります。

・年間（Rent）ライセンスの場合、ライセンスが有効な期間内であれば、マイナーバージョンアップ（update）、メジャーバージョンアップ（upgrade）に関わらず無償で新しいバージョンをご使用頂けます。

・永久（Permanent）ライセンスの場合、ご購入後1年間は無償でマイナーバージョンアップ版をご使用頂けます。メジャーバージョンアップ版をご使用になりたい場合、別途有償にてのご提供となります。

尚、メジャーバージョンアップ（upgrade）とは、バージョン番号の最初の数字が変わる場合（v.1.x.xからv.2.x.xなど）、マイナーバージョンアップ（update）とはそれ以外、2番目以降の数字が変わる場合を指します。

(2023/3/9)