クエリ言語の活用

Altium Training

Altium Essentials: PCB Global Editing and List Panel

This content is part of the official Altium Professional Training Program. For full courses, materials and certification, visit Altium Training.

概略

数百もの設計オブジェクトを個別に管理していると、回路図やPCBの更新に時間がかかることがあります。この記事では、Altium Designerのクエリ言語を紹介し、論理クエリを使用して対象のオブジェクト群を検索、ハイライト表示、選択、編集する方法を説明します。フィルターの適用範囲、Query HelperとQuery Builderによるクエリの作成、表示の制御、クエリの再利用方法を取り上げます。また、このページには、論理クエリ式の演算子とグローバルシステムクエリ関数の一覧も掲載しています。設計オブジェクトをより自在に操作し、繰り返し行う更新作業を効率化する方法を見ていきましょう。

- クエリで特定のオブジェクトを絞り込む仕組みと、フィルターの適用範囲によって検索対象のドキュメントやオブジェクトがどのように決まるかを学びます。
- クエリ式を作成して検証し、結果の選択、ズーム、マスキングを制御する方法を紹介します。
- フィルターの適用と解除、お気に入りや最近使用したクエリの再利用、括弧を使って式をわかりやすくする方法を解説します。
AIでさらに深掘り:

クエリとは?

複雑な電子回路設計に取り組む際、おそらく最大の課題となるのは、多数の設計オブジェクトの管理です。回路図シート上のコンポーネント、ネットラベル、テキスト文字列から、PCB上の数百ものコンポーネントや配線を構成するトラックまで、これらのオブジェクトにアクセスし、確認、編集できる必要があります。 ほとんどのWindowsアプリケーションと同様に、オブジェクトをダブルクリックすると、そのプロパティを編集できます。単一のオブジェクトであればこれで問題ありませんが、300個以上のコンポーネントのデジグネータ文字列を編集したり、PCB上のすべてのビアを変更したりする場合には適していません。このような変更を行うには、複数のオブジェクトに同時にアクセスする必要があります。 

Altium Designerの回路図エディタとPCBエディタの基盤には、強力なクエリエンジンがあります。このエンジンにクエリを入力すると、必要なオブジェクトだけを正確に絞り込み、検索、編集できます。

Altium Designerの強力なデータフィルタリングおよび編集システムを使用すると、指定したオブジェクト群を返すようにソフトウェアに指示できます。この指示は、クエリという形式で入力します。クエリとは、特定のキーワードと構文を使用して入力する文字列であり、対象のオブジェクトを返します。取得したオブジェクトをどう扱うかは、ユーザー次第です。それらをハイライト表示して、ほかのすべてのオブジェクトを薄暗く表示することも、プロパティを参照または並べ替えて、共通する特定の属性を変更することもできます。

クエリを適用できる場所はいくつかありますが、中心となるのは、以下の画像に示す Filterパネルです。F12を押すと、Filter パネルの表示と非表示を切り替えられます。

クエリが入力されたPCB FilterパネルとSCH Filterパネルクエリが入力されたPCB FilterパネルとSCH Filterパネル

クエリが入力されたPCBLIB FilterパネルとSCHLIB Filterパネル
クエリが入力されたPCBLIB FilterパネルとSCHLIB Filterパネル

パネル内のコントロールでは、クエリを適用するオブジェクトと、クエリの条件に一致するオブジェクトおよび一致しないオブジェクトの扱い方を定義します。

クエリ言語は、PCB Rules and Constraints Editor ダイアログでデザインルールの適用範囲を定義する際にも使用されます(詳細は、PCBデザインルールの定義、適用範囲の設定、および管理 ページを参照してください)。デザインルールの適用対象となるオブジェクトの集合は、クエリだけでなくルールタイプにも依存することに注意してください(たとえば、Widthルールはトラックのみ、Routing Via Styleルールはビアのみを対象とします)。そのため、Filter パネルとルールの適用範囲に同じクエリ式を使用しても、ハイライトされるオブジェクトや適用対象となるオブジェクトが異なる場合があります。

クエリ結果はどこにありますか?

Filter パネルでクエリを作成したら、そのクエリで返されたオブジェクトにはどのようにアクセスすればよいでしょうか。Altium Designer環境では、2つの方法でオブジェクトにアクセスして編集できます。

  • グラフィカルに操作する方法 - フィルターを適用すると、デフォルトではクエリの条件を満たさなかったすべてのオブジェクトがマスクされ(薄く表示され、編集不可になります)、条件を満たしたオブジェクトだけが残ります。このモードは、ワークスペース内でオブジェクトを見つけて確認するのに最適です。マスクされたオブジェクトは編集できないため、Ctrl+A(すべて選択)などのコマンドは、クエリで返されたオブジェクトにのみ適用されます。

  • List パネル - List パネル(Shift+F12)は、設計データをスプレッドシート形式で表示するビューです。デフォルトではすべての設計オブジェクトが表示されますが、フィルターを適用すると、クエリによって返されたオブジェクトのみが表示されます。List パネルには、並べ替えや選択など、一般的なスプレッドシートと同様の機能があり、単一または複数のセルを直接編集できます。 

PCB ListパネルとSCH List パネルには、前のセクションのPSB/SCHクエリの結果が表示されます。PCB ListパネルとSCH List パネルには、前のセクションのPSB/SCHクエリの結果が表示されます。

ハイライト表示オプション

クエリが適用されると(または別の方法でデータフィルタリング機能が使用されると)、対象ドキュメント内の各オブジェクトについて、そのフィルタリング操作の結果に含まれるかどうかが決まります。ただし、結果に含まれるオブジェクトと含まれないオブジェクトがその後どのように表示されるかは、Filter パネルで選択したハイライト表示オプションによって異なります。ハイライト表示オプションは3種類あり、それぞれ完全に独立しているため、1つ、2つ、またはすべてを選択できます。

ズーム

クエリの適用時にZoom オプションが有効になっていると、対象ドキュメントのビューが更新され、結果に含まれるすべてのオブジェクトが収まる領域が表示されます。残りの各オブジェクトが更新後のビューに表示されるかどうかは、その領域に対する位置によって決まるため、全体が表示される場合も、一部のみが表示される場合も、まったく表示されない場合もあります。 

このオプションは、他の一方または両方のオプションと組み合わせて選択されることがよくあります。Mask オプションが有効になっていない場合、結果に含まれないオブジェクトも、更新後の表示範囲内にあればグラフィカルビューに引き続き表示されます。一見すると、このオプションだけを選択しても意味がないように思えるかもしれません。しかし、ドキュメント内のどのオブジェクトについても選択状態やマスク状態を変更せずに、特定のオブジェクトが収まるようにグラフィカルビューを更新したい場合に役立ちます。

選択

Select オプションが有効になっていると、結果に含まれるすべてのオブジェクトが選択状態になり、残りのすべてのオブジェクトは非選択状態になります。選択されたオブジェクトは、選択されていないオブジェクトよりも目立つように表示されます。

現在のクエリを適用するときにSelectオプションが選択されていると、結果セットに含まれるすべてのオブジェクトが選択状態になり、残りのすべてのオブジェクト(結果セットに含まれないオブジェクト)は非選択状態になります。このオプションは通常、一括編集操作の直前に選択します。その時点で選択されているオブジェクトのプロパティだけが更新されるためです。また、特定のオブジェクトを移動、コピー、削除する場合などにも、Selectオプションが役立ちます。

マスク

Mask ハイライト表示オプションは、対象ドキュメント内のオブジェクトのマスク属性を更新します。選択すると、結果に含まれるすべてのオブジェクトがマスクされ、残りのすべてのオブジェクトはマスク解除されます。マスクされたオブジェクトの主な特徴は、オブジェクト自体とそのプロパティを編集できないことです。(マスクされたオブジェクトはリストビューでは淡色で表示されますが、List パネルでall objects オプションが選択されていない場合は、リストビューに表示されません。)マスクされたオブジェクトの主な特徴は、オブジェクト自体とそのプロパティを編集できないことです。

クエリビルダー

PCBエディターには、専用のQuery Builderダイアログが用意されています。このダイアログでは、ドロップダウンリストから判定条件を選択して、複雑なクエリを作成できます。Query Builder の利点は、異なる種類のオブジェクトを対象とするクエリを作成できることです。

「Building Query」ダイアログ(「Query Builder」機能の一部)は、クエリの指定に不慣れなユーザーを支援します。設計者が指定した条件に対応する内容のクエリが自動的に生成されます。

このダイアログの左側には、生成されるクエリでドキュメント内の各オブジェクトが返されるために必要なプロパティを、設計者が指定できるようにするコントロールがあります。各条件を指定または編集するたびに、対応するクエリの内容が更新され、ダイアログの右側に表示されます。その後、OK(またはApply)ボタンをクリックしてダイアログを閉じると、対応するクエリが適用されるか、その内容がFilterパネルにコピーされます(どちらの動作になるかは、最初にこのダイアログを開いた方法によって異なります)。

Query Builderダイアログは、次の場所から開くことができます(下図参照)。

  • PCB FilterパネルでQuery Builder ボタンをクリックすると、クエリを作成し、その文字列をパネルに読み込むことができます。
  • PCB Rules and Constraints EditorダイアログでBuilder ボタンをクリックすると、このルールを適用するオブジェクトを定義するクエリを作成できます。 

PCB Rules and Constraints EditorダイアログからQuery Builder ダイアログを開いた場合は、そのルールの種類に適したオプションのみが表示されます。

下図は、Query Builderダイアログを使用して、5Vネット上のパッドとビアの両方を対象とするクエリを作成している例です。

Query Builderダイアログ
Query Builderダイアログ

  • 必要に応じて条件を追加し、対象とする設計オブジェクト群を絞り込みます。条件は AND または OR で結合できます。デフォルトの論理演算子は AND です。
  • 条件間の論理演算子を変更するには、Condition Type/Operator  列の AND または OR の項目をクリックし、必要な演算子を選択します。それに応じてクエリのプレビューが更新されます。
  • Query Builder ダイアログ(Building Query from Board )では、状況に応じた条件タイプと値を使用して、より簡単にクエリを作成できます。関連する「構成要素」だけを使って作成するため、不適切な組み合わせを避けられます。キーワードの完全な指定や演算子の構文を使用して高度なクエリを作成するには、クエリヘルパー ダイアログを使用します。
  • クエリ文字列内の条件は、いつでも変更できます。Condition Type/Operator  列でその条件の項目をクリックし、ドロップダウンリストの選択肢から新しい条件を選択します。それに応じてクエリのプレビューが更新されます。
  • キーボードショートカットの Ctrl+Up Arrow と Ctrl+Down Arrow  を使用すると、選択した条件の項目を構造内で上下に移動できます。 
  • キーボードショートカットの Ctrl+Right Arrow と Ctrl+Left Arrow  を使用すると、構造内の選択位置でインデントを増減(括弧を追加/削除)できます。

クエリヘルパー

クエリ作成のスキルを高める次のステップは、Query Helper ダイアログを使用することです。Query Helper ダイアログには、目的のクエリを入力できる Query ボックスがあります。また、Query フィールドの下にある構文ボタン(And、Or、<、Not、  Like など)や、Categories フィールドに表示されるすべてのクエリキーワードの一覧も使用できます。

「クエリヘルパー」ダイアログは、独自のクエリを指定したい設計者を支援します。一覧の各キーワードには簡単な説明が用意されていますが、キーワードをハイライトした状態で F1 キーを押すと、オンラインヘルプにアクセスできます。これにより Altium Designer ドキュメントライブラリのダイアログが開き、ハイライトしたキーワードによってドキュメント内のどのオブジェクトが返されるか、そのキーワードの使用方法、および1つ以上の使用例を確認できます。

このダイアログには、次の方法でアクセスできます。

  • Filter パネルの Helper ボタンをクリックします。

PCB Filter パネルへのアクセス

SCH Filter パネルへのアクセス

Helper ボタンは、File-based Libraries Search ダイアログで Advanced をクリックすると使用できるようになります。

File-based Libraries Search ダイアログへのアクセスFile-based Libraries Search ダイアログへのアクセス

ダイアログ上部の Query セクションでは、使用可能な関数を使ってクエリ式を作成します。テキストボックスでは、検索式を確認したり、さらに編集したりできます。検索式を編集するには、テキストボックスに直接入力します。追加する特定のキーワードを検索するには、入力を開始します。入力中は、それまでに入力したテキストに一致する使用可能なキーワードがドロップダウンメニューに表示されます。キーワードをクリックすると、選択したキーワードが自動補完されます。目的のキーワードがハイライトされている場合は、Enter を押しても自動補完できます。

使用可能なキーワードの Categories から、目的のキーワードを探します。正確なキーワードがわからない場合は、Mask フィールドを使用します。たとえば、回路図エディターの Query Helper で、Mask フィールドに *har と入力すると、下の画像のように、ハーネスに特に適用されるキーワードが見つかります。Mask フィールドは、キーワードの Name フィールドと Description フィールドの両方を検索するため、候補となるキーワードを見つける最も手早い方法になる場合があります。

キーワードがハイライトされているとき、または入力済みのキーワード内にカーソルがあるときに F1 を押すと、そのキーワードのドキュメントが開きます。これは、各クエリキーワードの基本的な動作を学ぶうえで最も役立つ資料です。

グリッド内のキーワードをダブルクリックすると、クエリの現在のカーソル位置に追加されます。

ダイアログ中央の領域には、式の作成時に使用できるさまざまな演算子の構文ボタンがあります。各構文ボタンの機能の詳細については、後述の 論理クエリ式の演算子 セクションを参照してください。式の構文が正しいことを確認するには、Check Syntax ボタン(ダイアログの左下)を使用します。

クエリ履歴

フィルターパネル(SCH Filter / SCHLIB Filter、PCB Filter / PCBLIB Filter)で新しいクエリを入力して適用すると、クエリ履歴リストに追加されます。このリストにアクセスするには、パネルの History ボタンをクリックします。History タブがアクティブになった状態で Expression Manager ダイアログが開きます。

Expression Manager ダイアログの 履歴 タブには、過去に使用したクエリ式の一覧が表示されます。ここでは、回路図のクエリ履歴の例を示しています。画像にマウスを合わせると、PCB の同様のリスト例が表示されます。Expression Manager ダイアログの 履歴 タブには、過去に使用したクエリ式の一覧が表示されます。ここでは、回路図のクエリ履歴の例を示しています。画像にマウスを合わせると、PCB の同様のリスト例が表示されます。

リスト内のクエリ履歴を使用するには、その項目を選択して Apply Expression ボタンをクリックするか、項目を直接ダブルクリックします。ダイアログが閉じ、そのクエリ式が該当するフィルターパネルの中央領域に読み込まれます。

クエリ履歴の項目を選択して Add To Favorites ボタンをクリックすると、お気に入りのクエリのリストに追加できます。履歴リストを消去するには、Clear History ボタンを使用します。

リスト内の最近使用したクエリ式は、最大9件まで、フィルターパネルの右クリックメニューの History サブメニューから使用できます。

History リストの内容は、同じ設計領域のフィルターパネル間で共通であり、各パネルからアクセスできます(回路図編集領域では SCH Filter / SCHLIB Filter、PCB編集領域では PCB Filter / PCBLIB Filter)。一部のクエリ式は、回路図エディターで使用しても結果が返されない場合があります。特に、回路図ライブラリエディターでのみ使用できるオブジェクトを対象として作成された場合が該当します。

お気に入りのクエリ

定義したクエリは、次の2つの方法でお気に入りのクエリリストに追加できます。

  • Add To Favorites ボタンをクリックするか、メインの Query Expression 領域内で右クリックし、コンテキストメニューから Add to Favorites コマンドを選択すると、アクティブなフィルターパネルの中央領域に現在定義されているクエリ式が追加されます。
  • Expression Manager ダイアログの History タブで履歴内のクエリエントリを選択し、Add To Favorites ボタンをクリックします。

お気に入りのクエリ式は、Expression Manager ダイアログの Favorites タブに保存され、そこで管理できます。このダイアログには、フィルターパネル(SCH Filter / SCHLIB Filter、PCB Filter / PCBLIB Filter)の Favorites ボタンを使用するか、フィルターパネルのメインの Query Expression 領域内で右クリックして、コンテキストメニューから Organize Favorites コマンドを選択することでアクセスできます。設計スペースからは、ショートカットキー Y を使用し、フィルタリングのポップアップメニューから Organize Favorites を選択してアクセスできます。

エディターのフィルターパネルから、または設計スペースのフィルタリングポップアップメニューを使用して、お気に入りのクエリ一覧にアクセスできます。エディターのフィルターパネルから、または設計スペースのフィルタリングポップアップメニューを使用して、お気に入りのクエリ一覧にアクセスできます。

クエリ式を Favorites リストに追加すると、一意の名前が割り当てられます。デフォルトでは、汎用的な名前 Favorite_n が割り当てられます。ここで、n は次に使用可能な未使用の番号です。エントリの名前は、次のいずれかの方法でいつでも変更できます。

  • クエリエントリを選択し、Rename ボタンをクリックします。
  • クエリエントリを選択し、右クリックメニューから 編集 コマンドを選択します。
  • クエリエントリを選択し、Name フィールド内をもう一度クリックします。

いずれの場合も、必要な新しい名前を入力し、Name フィールドの外側をクリックして変更を確定します。

お気に入りのクエリ式を編集するには、リスト内のエントリを選択し、Edit ボタンをクリックします(または右クリックして、コンテキストメニューから Edit を選択します)。Edit Favorite ダイアログが開きます。このダイアログで、お気に入りの名前や式自体を変更したり、設計オブジェクト(フィルター条件を満たすものと満たさないものの両方)の扱いを指定したりできます。

Edit Favorite ダイアログを使用して、既存のお気に入りのクエリを変更します。左は回路図用、右はPCB用のダイアログです。Edit Favorite ダイアログを使用して、既存のお気に入りのクエリを変更します。左は回路図用、右はPCB用のダイアログです。

Favorites リストからクエリを削除するには、リスト内のエントリを選択し、Remove ボタンをクリックするか、右クリックメニューから Remove コマンドを選択します。削除の確認を求めるダイアログが表示されます。

Favorites リストの内容は、同じ設計領域のフィルターパネル間で共通であり、各パネルからアクセスできます(回路図編集領域では SCH Filter / SCHLIB Filter、PCB編集領域では PCB Filter / PCBLIB Filter)。一部のクエリ式は、回路図エディターで使用しても結果が返されない場合があります。特に、回路図ライブラリエディターでのみ使用できるオブジェクトを対象として作成された場合が該当します。

お気に入りのクエリの使用

お気に入りのクエリは、次の3つの方法で使用できます。

  1. Expression Manager ダイアログの Favorites タブから使用する場合は、エントリを選択して Apply Expression ボタンをクリックするか、エントリをダブルクリックします。ダイアログが閉じ、該当するフィルターパネルの中央領域にクエリ式が読み込まれます。

  2. フィルターパネルの右クリックメニューの上部から使用できます(Favorites リストに最近追加されたクエリ式が最大10件表示されます)。

  3. 設計スペースのフィルタリングポップアップメニュー(Y を押す)から使用できます。メニューの上部に、お気に入りのクエリ式が最大10件表示されます。選択したクエリ式が、該当するフィルターパネルの中央領域に読み込まれます。

Filterメニューをカスタマイズして、お気に入りにショートカットキーを定義することもできます。Altium Designer環境のカスタマイズの詳細については、Altium Designerの設定とカスタマイズを参照してください。

付属のサンプルの使用

回路図エディターとPCBエディターには、サンプルクエリがあらかじめ用意されています。これらのサンプルは、フィルタリングメニューから利用できます。このメニューには、フィルターパネルの式の領域内で右クリックするか、設計スペースでショートカットキー Y を使用してアクセスします。Examples にマウスポインターを合わせると、サブメニューが表示されます。

サブメニューの項目を選択すると、そのフィルターに対応するクエリが適用されます。サンプルで使用されている実際のクエリを確認するには、適用後に History リストを確認してください。このリストには、フィルタリングポップアップメニューからもアクセスできます。

フィルタリングを解除するには、設計スペースで Shift+C を押すか、設計スペース内で右クリックし、コンテキストメニューから Clear Filter コマンドを選択します。

クエリ作成ツール

クエリを記述する最も簡単な方法は、Altium Designerに作成させることかもしれません。これには、Find Similar Objects ダイアログまたは Query Builder ダイアログを使用できます。

類似オブジェクトの検索ダイアログ

類似オブジェクトの検索ダイアログを使用すると、目的のオブジェクトを検索するクエリが生成されます。Create Expression オプションが有効な場合、そのクエリは Filter パネルに表示されます。これは、さまざまなクエリキーワードを学ぶのに非常に有効な方法です。

設計ドキュメント内のマスクされていないオブジェクトを右クリックし、コンテキストメニューから Find Similar Objects を選択すると、Find Similar Objects ダイアログが開きます。

左の画像:PCB版、右の画像:SCH版左の画像:PCB版、右の画像:SCH版

このダイアログでは、右クリックしたオブジェクトに類似するオブジェクトを検索し、一致条件として、どの属性が同じ(または異なる)でなければならないかを指定できます。たとえば、設計内のすべてのGNDパッドを変更する場合は、いずれかのGNDパッドを右クリックしてFind Similar Objectsを選択し、Net フィールドをAny(デフォルト設定)からSameに変更します。ダイアログでApply をクリックすると、すべてのGNDパッドが選択されます。Create Expression オプションが有効な場合、Filter パネルに次のクエリが表示されます。(ObjectKind = 'Pad') And (Net = 'GND').

回路図での例として、ドキュメント内で特定のTextプロパティ(例:'GND')を持つすべての電源オブジェクトのColor プロパティを同じ値に変更できます。また、PCBでの例として、ドキュメント内で特定のVia Diameterプロパティを持つすべてのビアのHole Sizeプロパティを同じ値に変更できます。

Find Similar Objectsダイアログの使用方法の詳細については、類似オブジェクト検索ツールの使用を参照してください。

既存の選択をクリアするオプション

検索を適用する前に既存の選択や編集マスクをクリアするには、Clear Existing オプションを有効にします。連続して検索を実行し、その結果を累積したい場合は、このオプションを無効にします。

フィルターツールバー

Filter Toolbar はPCBドキュメント用に用意されており、指定したプロパティを持つオブジェクト、または指定したコンポーネントの一部であるオブジェクトを除き、ドキュメント内のすべてのオブジェクトをマスクできます。ツールバーの一番右のフィールドでクエリの内容を指定します。このフィールドにクエリを入力するか、ドロップダウンから最近使用したクエリ(クエリのHistory リストにあるもの)を選択できます。Filter Toolbarからクエリを適用する場合、使用するオプションは指定できません。どの場合も、以前のクエリはクリアされ、現在のクエリに対してMaskおよびZoomオプションが使用されます。クエリオプションを使用するには、Filter パネル、Query Builderダイアログ、Query Helperダイアログ、またはFind Similar Objects ダイアログを使用してください。

  • 基板が未配線の場合、フィルターを適用すると、選択したネットに関連する論理接続が表示されます。基板が配線済みの場合、フィルターを適用すると、選択したネットに関連する配線済みトラックが表示されます。
  • マスクを適用すると、フィルターの対象外のオブジェクトはすべて選択・編集できなくなります。マスクの強さは、View ConfigurationパネルのView OptionsタブにあるMask and Dim SettingsセクションのMasked Objectsスライダーバーを使用して、手動で調整できます。
  • 適用済みの既存のフィルターは、Shift+Cキーボードショートカットを使用するか、Filter ツールバーのボタンをクリックすることで、いつでも手動でクリアできます。

論理クエリ式の演算子

クエリ言語で論理クエリ式を定義する際に使用できる演算子の概要を以下に示します。

算術演算子

演算子 説明 例
+ 加算演算子 NetPinCount + NetViaCount
- 減算演算子 ArcStopAngle - ArcStartAngle
* 乗算演算子 PadXSize_BottomLayer * PadYSize_BottomLayer
/ 除算演算子 HoleDiameter / ViaDiameter
Div 整数除算演算子 Color Div 65536
Colorを65536で割り、結果の小数部を切り捨てます
Mod 剰余演算子 Color Mod 256
Colorを256で割った余りを求めます。結果の小数部は求めません

論理演算子

演算子 説明 例
And 論理AND演算子 IsPad And OnMultiLayer
検索結果に含まれるには、オブジェクトがパッドであり、かつMulti-Layerレイヤー上に存在する必要があります
&& 論理AND演算子
(優先順位が低い)
IsPad && OnMultiLayer
検索結果に含まれるには、オブジェクトがパッドであり、かつMulti-Layerレイヤー上に存在する必要があります
Or 論理OR演算子 IsPad Or IsVia
検索結果に含まれるには、オブジェクトがパッドまたはビアである必要があります
|| 論理OR演算子
(優先順位が低い)
IsPad || IsVia
検索結果に含まれるには、オブジェクトがパッドまたはビアである必要があります
Xor 論理排他的OR演算子 OnMultiLayer Xor (HoleDiameter <> 0)
検索結果に含まれるには、オブジェクトがMulti-Layerレイヤー上にあり、 Hole Diameterがゼロであるか、または
Multi-Layerレイヤー上になく、Hole Diameterがゼロ以外である必要があります。
Not 論理NOT演算子 Not OnMultiLayer
検索結果に含まれるには、オブジェクトがMulti-Layerレイヤー上に存在しない必要があります

PCBエディターのクエリ式でNot演算子を使用して特定の種類のプリミティブを除外する場合、そのプリミティブがグループオブジェクトの一部であり、そのグループオブジェクト自体も式で除外されていなければ、プリミティブは除外されないことに注意してください。たとえば、Not IsPadクエリ式はフリーパッドオブジェクト以外のすべてのオブジェクトを返しますが、パッドを含む可能性があるコンポーネントオブジェクトも返すため、コンポーネント内のパッドはこの式の検索結果に含まれます。また、パッドはネットに含まれる場合もあり、PCBエディターではネットもグループオブジェクトとして扱われます。すべてのパッドオブジェクトを除外するには、Not IsPad And Not IsComponent And Not IsNetクエリ式を使用してください。

比較演算子

演算子 説明 例
< 未満演算子 HoleDiameter < 40
検索結果に含まれるには、オブジェクトのHole Diameterが40未満である必要があります
<= 以下演算子 HoleDiameter <= 40
検索結果に含まれるには、オブジェクトのHole Diameterが40以下である必要があります
>= 以上演算子 HoleDiameter >= 40
検索結果に含まれるには、オブジェクトのHole Diameterが40以上である必要があります
> より大きい演算子 HoleDiameter > 40
検索結果に含まれるには、オブジェクトのHole Diameterが40より大きい必要があります
<> 不等価演算子 HoleDiameter <> 40
検索結果に含まれるには、オブジェクトのHole Diameterが40と等しくない必要があります
= 等価演算子 HoleDiameter = 40
検索結果に含まれるには、オブジェクトのHole Diameterが40と等しい必要があります
Between...And... 両端を含む範囲演算子 HoleDiameter Between 30 And 50
検索結果に含まれるには、オブジェクトのHole Diameterが30以上、かつ
50以下である必要があります。
Like Like演算子 Name Like 'ADDR?*'
Name プロパティに関連付けられた文字列がADDRで始まり、
その後に少なくとも1文字以上が続くオブジェクトを返します

ワイルドカード文字

ワイルドカード文字を使用すると、完全には指定されていない文字列を指定できます。通常、これらの文字は他の文字と組み合わせて使用し、文字列の一部を指定します。例外的に、完全には指定されていない文字列パラメーターを受け付けるキーワードもいくつかありますが、ほとんどの場合、文字列にワイルドカード文字を含められるのは、Like演算子で比較する場合に限られます。

演算子 説明 例
? 任意の種類の1文字に置き換えることができます Footprint Like 'DIP1?'
FootprintプロパティがDIP10、DIP12、DIP14などのオブジェクトを返します。
* 任意の種類の任意の数の文字に置き換えることができます Footprint Like 'SIP*'
Footprint プロパティがSIP1、SIP12、SIP216などのオブジェクトを返します。(「*」はno文字にも置き換えられるため、Footprint プロパティがSIPのオブジェクトも返されます。)

ブール文字列

演算子 説明 例
True キーワードの意味を肯定します IsPad = True
返されるオブジェクトはパッドである必要があります
False キーワードの意味を否定します IsVia = False
返されるオブジェクトはビアでない必要があります

丸括弧と優先順位

論理クエリ式で使用する演算子の優先順位を確認しておくことは重要です。優先順位を理解していないと、必要なオブジェクトを対象としない式になってしまう可能性があります。

各種演算子には優先順位が定義されており、丸括弧の優先順位が最も高くなっています。この優先順位によって、ユーザーが丸括弧を指定していない場合に、ソフトウェアがクエリをどのように解釈するかが決まります。優先順位の高い順に並べると、次のようになります。

  1. 丸括弧 ()
  2. Not
  3. ^, *, /, Div, Mod, And
  4. +, -, Or, Xor
  5. =, <>, <, >, <=, >=
  6. &&, ||
この優先順位は、Pascal系言語で使用されるものと似ています。曖昧な場合は左から右へ処理されます。丸括弧は内側から外側へ評価され、同じ優先順位のものは左から右へ評価されます。
クエリが正しく解釈されない可能性が少しでもある場合は、丸括弧を使用することを強くお勧めします。丸括弧を十分に使用すると、曖昧さがなくなり、他の人にとってもクエリが読みやすくなります。

グローバルシステムクエリ関数

Query Helperダイアログに表示されるグローバルシステムクエリ関数
Query Helperダイアログに表示されるグローバルシステムクエリ関数

このセクションでは、Altium Designerの回路図、PCB、およびライブラリドキュメントで使用できるクエリ言語のキーワードについて詳しく説明します。特定のクエリキーワードのヘルプを表示するには、以下の折りたたみ可能なセクションを使用するか、Query Helper、Filterパネル、またはPCBデザインルールのQueryフィールドでキーワードを選択(またはキーワード内をクリック)して、F1を押してください。該当するセクションに直接アクセスできます。

Altium Designerの各エディターやツールで使用できるクエリ言語のキーワードの詳細については、次のページを参照してください。

算術関数

三角関数

指数関数と対数関数

集約関数

システム関数

AI-LocalizedAI で翻訳
問題が見つかった場合、文字/画像を選択し、Ctrl + Enter キーを押してフィードバックをお送りください。
Nav
Contents
機能の提供状況

ご利用可能な機能は、お使いのAltiumソリューション(Altium Develop、Altium Agile Teams、Altium Agile Enterprise、または有効な契約期間中のAltium Designer)によって異なります。

実際にお使いのソフトウェアに文書化されている機能が表示されない場合は、詳細についてAltium Sales までお問い合わせください。

従来のドキュメント

Altium Designer のドキュメントは、バージョンごとに掲載されなくなりました。Altium Designer の旧バージョンのドキュメントは、Other Installers ページの Legacy Documentation の項目をご覧ください。

Contents