次のような繰り返し作業に何時間も費やしたことがあるかもしれません - 駐車スペースに1つずつ番号を割り当てる、ビューマップで未使用のアイテムを見つける、連続コピーを使用した各要素IDを編集する ‐ これらのタスクがいかに面倒でエラーになりやすいかをご存じのはずです。これらのタスクを自動的に実行できるとしたらどうでしょうか。
Archicad 24では、 実験的な機能としてArchicad-Python Connectionアドオン を公開しています。Pythonを使用すると、このようなタスクを高速に、自動的に、正確に実行できます。Pythonは優れた読みやすさと、平易な英語に似た親しみやすい構文を提供しています。
Python言語を知らなくても、恐れることはありません。まだまだPythonの良さを享受できるでしょう。現在は、https://graphisoft.com/downloads/pythonで入手可能なスクリプトの例がいくつかあります。
Python環境のセットアップ
ARCHICAD-Python Connection には、インストールされたPython環境（バージョン3.7以降）と実行中のARCHICADインスタンス（バージョン24以降）が必要です。
Pythonをインストールするにはさまざまな方法があります。最も簡単な方法は、こちら から最新のPythonバージョンを直接ダウンロードして、インストーラを実行することです。デフォルトのオプションでインストールすることをお勧めします。
Windows10
- 実行可能ファイルをダブルクリックします。
- [今すぐインストール]をクリックして、Pythonをデフォルトのオプションでインストールします。
- または、インストールする機能とインストールする場所を選択する場合は、[インストールのカスタマイズ]を選択します。
上級ユーザーの場合：PATH環境変数にPythonを追加し、pyランチャーをインストールし、スクリプトファイルをPythonに関連付けることをお勧めします。これらのオプションは、Pythonインストーラーの「オプション機能」および「詳細オプション」セクションにあります。これらのオプションを使用すると、Pythonスクリプトの実行が簡単になります。
- 完了したら、[閉じる]をクリックして、Python環境をインストールします。
macOS
- ダウンロードしたファイルをダブルクリックします。
- [続行]をクリックします。インストーラは、重要な情報 とPythonの 使用許諾契約について説明します。
- 次のステップでは、Pythonをインストール先を指定します。将来の互換性のために、内蔵ドライブにインストールしてください。
- インストールする要素をカスタマイズするには、 カスタマイズをクリックして、 [インストールの種類]をクリックします。 または、標準インストールのままにしておきます。
- [インストール]をクリックすると、インストールプロセスが開始されます。完了したら、[閉じる] をクリックしてインストーラを閉じます。インストーラが不要になった場合は、インストーラを削除することもできます。
Archicad内でPythonを使用する
ArchicadなしでPythonスクリプトを実行することはできますが、Pythonパレットはスクリプトを管理および実行するためのよりユーザーフレンドリーな方法を提供します。これを開くには、[作業環境]ダイアログでPythonパレット実験機能を有効にする必要があります。
Pythonパレットを有効にする
- [オプション]> [作業環境]> [その他のオプション]に移動します。
- [試験機能]で、[Pythonパレットを有効にする]チェックボックスを オン にします
- ウィンドウ > パレット > PythonパレットからPythonパレットを開きます
 |
Pythonパレットは、コンピューターに何かが不足している場合に通知します。Pythonがインストールされていない場合、 [Pythonのインストール]ボタンをクリックすると、Pythonの最新バージョンをダウンロードするためのPythonの公式Webページが開きます。
|
 |
Archicad-Python Connection が まだインストールされていない場合、Connectionのインストールボタンは不足しているパッケージを自動的にインストールします。 |
Pythonとの接続が確立されると、Pythonパレットを介していくつかのスクリプトを実行する準備が整います。
使用されているPython環境のバージョンを確認するには、
注：現在、PythonパレットはArchicadを再起動しパレットが開かれるたびに更新を確認する必要があります。したがって、インターネット接続はパレットを開くために必要です。
パレットでのスクリプトの管理
Pythonパレットには、Pythonスクリプトを管理および実行するためのいくつかの基本的な関数が含まれています。
コンピュータの複数の場所に保存されているスクリプトを表示できます。
フォルダを選択しているときに
Pythonパレットを介してスクリプトを実行
Pythonパレットでスクリプトを実行するには、次のいずれかを実行できます。
- リスト内のスクリプトをダブルクリックします
- スクリプトを選択し、[実行]ボタンをクリックします
イベントは、パレットの コンソール フィールドに1つずつ表示されます。プロセスが終了すると、パレットに結果が表示され、スクリプトが正常に実行されたかどうかが通知されます。
注：Pythonスクリプトの実行によって行われたすべての元に戻すことができる変更は、1つの元に戻す手順で元に戻すことができます。たとえば、スクリプトが複数の要素のプロパティ値を変更した場合、使用できる元に戻す手順は1つだけで、すべてのプロパティ値が元の状態にリセットされます。
スクリプトがArchicadでは元に戻せない変更を行った場合（たとえば、ナビゲーターのマップの表示でアイテムを移動または名前変更した場合）、それらの変更を元に戻すことはできません。
例
椅子の番号付け
私たちは通常、連続コピーを使用して、エリア（例.講堂）内に椅子を配置します。ただし、椅子が連続コピーされると、元のオブジェクトの要素IDもすべての新しいオブジェクトに複製されます。要素IDを変更してすばやく番号を付け直すために、Chairnumberingというデモスクリプトを作成しました。
スクリプトが実行されると、すべてのフロアに配置された 椅子 として分類されたすべてのオブジェクトのIDが変更されます。非表示のオブジェクトはこの影響を受けません。
実行
- こちらからスクリプトをダウンロードしてください。
- ダウンロードしたZIPパッケージをフォルダーに解凍します。
- サンプルプロジェクトファイルまたは実際のプロジェクトを開きます。
- ウィンドウ>パレット> Pythonパレットに移動してPythonパレットを開きます >
- スクリプトが配置されているフォルダーを参照して、スクリプトをパレットに追加します。
- スクリプトを選択して[実行]を押すか、スクリプトをダブルクリックして、スクリプトを実行し ます。
- 椅子の要素IDは自動的に設定されます。サンプルプロジェクトのラベルは、平面図ビューに要素IDの値を表示します。
要件
カスタマイズせずにスクリプトを正常に実行するには、次の要件を満たす必要があります。
- プロジェクトでARCHICAD分類という名前の分類システムが利用可能である必要があります
- 椅子はARCHICAD分類で 椅子 として分類する必要があります
- Archicadバージョンは24ビルド3008以上である必要があります
- Archicad-Python Connection バージョン24.2310以降
スクリプトは、オブジェクトのZ座標を使用して行を識別します。デフォルトでは、同じ列の椅子のZ座標間の最大差が0.25m未満の場合、椅子は同じ列にグループ化されます。
カスタマイズオプションの詳細については、ダウンロードしたパッケージ内の添付のPDFガイドをご覧ください。
ビューマップで未使用のアイテムを移動する
注：ナビゲーター項目の移動は元に戻せません。したがって、このスクリプトによって行われた変更は元に戻せません。
実行
- こちらからスクリプトをダウンロードしてください。
- ZIPパッケージを解凍します。
- サンプルプロジェクトファイルまたは実際のプロジェクトを開きます。
- ウィンドウ>パレット> Pythonパレットに移動してPythonパレットを開きます >
- スクリプトが配置されているフォルダを参照して、スクリプトをパレットに追加します。
- スクリプトを選択して[実行]を押すか、スクリプトをダブルクリックして、スクリプトを実行し ます。
- 未使用のアイテムは、ナビゲータのビューマップの --UnusedViews-- という新しいフォルダに移動されます。
要件
カスタマイズせずにスクリプトを正常に実行するには、次の要件を満たす必要があります。
- Archicad 24 3008 以上
- Archicad-Python Connection バージョン24.2310以降
このスクリプトは、現在開いているArchiCADプロジェクト由来のものは必要としません。
PythonパレットなしでもArchiCADPythonAPIを使用できることに注意してください。Archicad pypiパッケージ（Python Wrapper）が既にインストールされている場合は、どこでもPythonスクリプトを実行できます（ターミナル内、またはVisual Studio Codeなどのお気に入りの統合開発環境内）。
