データベースおよびファイルベースのライブラリ内のコンポーネント検索

利用可能なデータベースとファイルベースのライブラリの管理

Altium Designer では、データベースとファイルベースのライブラリコンポーネントは、現在利用可能なライブラリからのみ配置できます。これらには以下が含まれます:

  • 現在のプロジェクト内のライブラリ- ライブラリがプロジェクトの一部である場合、そのコンポーネントは自動的にプロジェクト内に配置できます。

  • インストールされているライブラリ- これらのライブラリは Altium Designer にインストールされています。

  • 定義された検索パス上のライブラリ- 複数のライブラリを含むフォルダへの検索パスを定義することも可能です。新しいコンポーネントがパネルで選択されるたびに、検索パス内のすべてのファイルが検索されるため、この方法はシミュレーションモデルなどの簡単なモデル定義の小さなライブラリにのみ推奨されます。検索パスは、3Dモデルを含むフットプリントのような複雑なモデルには推奨されません。

利用可能なデータベースとファイルベースのライブラリを管理するには、Libraries Preferencesダイアログを使用します。このダイアログは、Componentsパネルの上部にあるComponents panel menu ボタンをクリックし、メニューからLibraries Preferencesを選択することでアクセスできます。

Libraries Preferencesダイアログには3つのタブがあります。これらのタブで定義されたすべてのライブラリとモデルの場所は、利用可能なライブラリのリストを構成するために照合されます。デザインを回路図から PCB レイアウトに転送するような、モデルを検索する必要があるアクションが実行されると、ライブラリはタブの順番で検索され、次にライブラリ/モデルがリストされた順番で各タブの中で検索されます。正しいモデルが見つかると、検索プロセスは終了します。

プロジェクト・ライブラリ

アクティブなプロジェクトに含まれるライブラリは、そのプロジェクトがソフトウェアのアクティブなプロジェクトである場合、Libraries PreferencesダイアログのProjectタブにリストされます。プロジェクト・ライブラリの利点は、プロジェクトを開くと自動的にモデル/ライブラリが利用できるようになることです。デメリットは、モデル/ライブラリがデザインファイルと同じプロジェクトフォルダ構造に保存されていない場合、プロジェクトファイルを移動すると簡単に忘れてしまうことです。

Project タブには、現在のプロジェクトで利用可能なライブラリのリストが表示されます。
Project タブには、現在のプロジェクトで利用可能なライブラリのリストが表示されます。

どのライブラリでもプロジェクト・ライブラリにすることができ、プロジェクトのフォルダに格納されている必要はありません。ライブラリをプロジェクトに含めるには、Projectsパネルでプロジェクト名を右クリックし、Add Existing to Projectコマンドを選択します。

インストールされているライブラリ

ソフトウェアのインストール時に利用可能になったライブラリやモデルを、インストール済みライブラリと呼びます。これらは、Libraries PreferencesダイアログのInstalledタブに表示されます。

このリストは環境設定です。このリストに追加されたライブラリは、すべてのプロジェクトで使用できます。プロジェクト・ライブラリはこのリストに追加できますが、初期状態ではこのリストの一部ではありません。

インストールされたライブラリは、絶対パスまたは [Library Path Relative To]設定からの相対パスを使用してリストできます。相対パスを使用する利点は、複数のPCで共通のサブ環境を作成できるため、PC間でデザイン・ファイルを簡単に移動できることです。さらに、インストールされたライブラリは削除するのではなく、Activatedチェックボックスをクリアすることで一時的に非アクティブにすることができます。

Componentsパネルからアクセスできるのは、Activatedライブラリのみです。

Installedタブには、Altium Designer のインストールで使用できるようになったライブラリが表示されます。
Installedタブには、Altium Designer のインストールで使用できるようになったライブラリが表示されます。

Altium 365 Workspace に接続すると、Workspace Library の健全性の概要も表示されます。これは、完全に健全なコンポーネントの数と、少なくとも 1 つの問題があるコンポーネントの数を一目で示します。デフォルトの Web ブラウザでワークスペースのブラウザ インターフェイスのComponentsページを開くには、See Detailsコントロールをクリックします。

Altium 365 Workspace に接続している場合、ダイアログのグリッド領域で選択されているインストール済みのライブラリを、一番右の列のImportをクリックして Workspace にインポートできます。選択したライブラリがロードされたSimple モードの Library Importerが開きます。

パスの検索

Search Pathタブは、the Project OptionsダイアログのSearch Pathsタブ パス タブで定義されたパス設定に従って検索されたライブラリのリストを表示します。各検索パスはフォルダを定義し、Recursiveオプションが有効な場合、サブフォルダを含めることができます(パスを追加した後、Project Options ダイアログのSearch Pathsタブで利用可能)。検索パスで見つかったすべてのモデルファイルとライブラリファイルが利用可能になります。検索パスはプロジェクトと共に保存されます。

Refresh ボタンをクリックすると、最新の検索パス(Project Options ダイアログのSearch Pathsタブで定義)に基づいてリストが更新されます。

Search Pathsタブには、定義された検索パスで見つかったライブラリがリストされます。
Search Pathsタブには、定義された検索パスで見つかったライブラリがリストされます。

Project Optionsダイアログの Search Pathsタブは、Advanced Settingsダイアログの UI.ProjectOptions.SearchPathsオプションが有効になっている場合に利用できます。

検索パスフォルダ内のファイル数が多い場合、検索パスを使ったモデルの取得に時間がかかることがあります。この理由から、PCB ライブラリは多くのフットプリントを含む大きなファイルになる可能性があるため、この方法を使用することはお勧めしません。この機能は、利用可能なシミュレーションとシグナルインテグリティモデルを参照する方法を提供するために開発されました。

このソフトウェアは、特定のモデル/ライブラリの場所を柔軟にコントロールできますが、各モデルタイプに対して正しいファイル拡張子を使用する必要があります。例えば、フットプリントは、拡張子が.Libまたは.PcbLibのファイルにある場合にのみ検出されます。同様に、SPICE *.SUBCKTは .cttファイルに、SPICE *.MODELは.mdlファイルにある場合のみ検索されます。モデル検索で一致しない場合は、メッセージパネルにエラーが表示されます。

SVN データベースライブラリで使用されるシンボルとモデルのローカライズされたキャッシュ

SVNDbLib ファイルが使用可能なライブラリのリストに追加されると、リポジトリ内のシンボルとモデルのライブラリは設計者のコンピュータのローカルにある一時フォルダにキャッシュされます。ソフトウェアのアクションで回路図のシンボルやモデルの使用が要求されると、そのシンボルやモデルはローカルのキャッシュから取得されます。

キャッシュの自動更新

ソフトウェア内で以下のアクションを実行すると、キャッシュ内のライブラリがソース管理リポジトリから最新のものに自動的に更新されます:

  • インストールされた SVNDbLib ファイルからコンポーネントを配置する(Components パネルから)。

  • デザイン転送の実行(PCB の更新など)。

  • 回路図エディタのTools » Update From Librariesコマンドを使用。

  • PCB Editor でTools » Update From PCB Librariesコマンドを使用。

更新は自動ですが、 PreferencesダイアログのData Management - SVN Libraries ページの Do not check files more often than xx minutesオプションを使用して制御できます。このオプションは基本的にローカルキャッシュに「更新タイマー」を提供します。キャッシュが最後に更新されてから指定された時間が経過した場合、リストされたアクションのいずれかが実行されると、キャッシュは自動的に更新されます。この時間内にアクションが実行された場合、キャッシュの現在のコンテンツが使用され、リポジトリ内のコンテンツと比較して古くなっている可能性があります。

手動でキャッシュを強制更新する

ソース管理リポジトリに現在保存されている最新のライブラリを確保するために、ローカルキャッシュを強制的に更新したい場合があります。例えば、デザインを回路図から PCB に転送するとき。

以下の方法のいずれかを使用して、手動でキャッシュの更新を強制できます:

  • Components パネルの右クリックメニューから利用できるRefresh コマンドの1つを使用。
  • SVNDbLib ファイルをアンインストールし、利用可能なライブラリリストに再インストールする。
Altium Designer を再起動すると、SVN リポジトリに保存されている最新のライブラリでローカルキャッシュが自動的に更新されます。

データベースとファイルベースのライブラリのコンポーネントの検索

ファイルベース(インストール済み、未インストールの両方)とデータベースライブラリからコンポーネントを検索するために、Altium Designer にはライブラリ検索機能があります。

ComponentsパネルのSearchフィールドを使用して、データベースとファイルベースのライブラリからコンポーネントを検索できます。文字列を入力し、Enterキーを押すと、表示されているコンポーネントのパラメータ内の任意の場所で、その文字列について現在のライブラリを検索します。

 Componentsパネルで直接検索を実行することもできます。 Componentsパネルで直接検索を実行することもできます。

File-based Libraries Searchダイアログでは、より詳細な検索が可能です。ComponentsパネルのComponents panel menu ボタンをクリックし、メニューからFile-based Libraries Search を選択すると表示されます。ダイアログの上半分で検索対象を定義し、下半分で検索場所を定義します。

インストールされているライブラリ(Available libraries)、またはハードドライブ上のライブラリ(Libraries on path)を検索します。インストールされているライブラリ(Available libraries)、またはハードドライブ上のライブラリ(Libraries on path)を検索します。検索プロセスは次のように要約できます:

  • 検索は、現在の検索範囲設定に従って検索可能なすべてのライブラリに適用されるフィルタを定義することによって実行されます。

  • Scopeには検索するライブラリのタイプが含まれます。一度に検索できるのは1つのタイプのみです。

  • データベース・コンポーネントの検索を有効にするには、Search inフィールドをDatabase Componentsに設定し、必要なテーブルを選択します。上のドロップダウンにリストされている利用可能なフィールドは、選択したテーブルで利用可能な列見出しを反映するように変更されることに注意してください。ダイアログの残りのオプションは、データベース・ライブラリを検索するときには関係ないので、グレーアウトされます。

  • Scopeは、どのライブラリを検索するかを定義します:ソフトウェアが現在アクセスできるライブラリ(Available libraries)またはフォルダ内のすべてのライブラリ(Libraries on path)。

  • パス上のライブラリを検索する場合、ターゲットは特定のフォルダで、サブディレクトリを含めることもできます。

  • また、Scopeを Refine last searchに設定することで、検索結果内を検索することもできます。

  • Clearをクリックすると、入力した検索パラメータが消去されます。

検索フィルタの設定

Filters領域は、検索に適用するテキスト文字列を定義するために使用します。設定する領域は3つあります:

  • Field- 検索するコンポーネントの属性です。Name、Description、Comment、Footprint、またはコンポーネントに追加されたパラメータなど、任意のコンポーネントまたはフットプリントの属性を指定できます。ドロップダウンから使用可能なフィールドを選択するか、テキストボックスにフィールドを入力します。

  • Operator- 一致の判定方法を定義します。これは、 equalscontainsstarts withends withのいずれかになります。equalsは文字列の完全一致を必要とするため、検索文字列が正しく完全であると確信できる場合にのみ使用する必要があることに注意してください。

  • Value- 選択した演算子に従って、選択したフィールドで検索する文字。ドロップダウンから利用可能な値を選択するか、テキストフィールドに値を入力します。

デフォルトでは、3つのフィルタ制約があります。Add Rowコントロールを使用して、最大7行を追加して合計10行にすることができます。最後に追加したフィルター制約行は、Remove Rowを使って削除できます。未使用の行は削除できます。

スコープの設定

検索には基本的に2つのアプローチがある:

  • 現在利用可能なライブラリ -Componentsパネルの上部にあるドロップダウンに表示されるライブラリのリストです。 パネルの上部にあるドロップダウンに表示されるライブラリのリストです。

  • オプションが有効になっている場合、特定のフォルダとサブディレクトリに保存されているライブラリ。

検索は、定義されたスコープに該当するすべてのライブラリにある、Search inドロップダウンで選択された検索タイプ(Components/Footprints/3D Models/Database Components)のすべてのアイテムを返します:

  • Available libraries - 利用可能なライブラリ内の指定されたモデルタイプのみを検索します。

  • Libraries on path- 指定されたフォルダー内の利用可能なライブラリーから、指定されたモデルタイプを検索します。Libraries on path scopeオプションを選択すると使用可能になるダイアログのPath領域では、検索条件を指定し絞り込むために、パスを定義したり、サブディレクトリを含めたり、ライブラリファイルマスクを含めたりすることができます:

    • Path- ライブラリを検索するフォルダを編集して定義するか、フィールドの最後にあるブラウズ・アイコンをクリックしてフォルダをブラウズします。

    • Include Subdirectories - 指定したパスとそのサブパスからライブラリを検索する場合は、有効にします。

    • File Mask- ファイルマスク文字列を入力するか、ドロップダウンリストから既存のファイルマスクのいずれかを選択します。検索は、文字列に一致するものをフィルタリングします。文字列には*(任意の文字)ワイルドカードを使用できます。たとえば、すべてのファイルを検索するには*と入力し、M で始まるすべてのファイルを検索するには M と入力します。

     

Refine last search を有効にすると、前回の検索で得られた Query Results リストからさらに検索条件を定義できます。例えば、DIP に基づいた名前で PCB フットプリントを検索し、定義された高さが 100 mil 未満のフットプリントのみを検索して返したい場合、このオプションを有効にします。新しいクエリ式を入力し、Search をクリックします。前のクエリ結果のサブセットは、Componentsパネルの新しい Query Results リストとして表示されます。

例えば、ハードディスク上の特定のフォルダ内のライブラリにあると思われるコンポーネントを検索し、そのライブラリが現在Available File-based Libraries にリストされていない場合、検索を以下のように定義します:

  1. Scope領域で、Search inComponentsに設定し、Libraries on path を選択する。

  2. Path領域で、検索したいライブラリドキュメントを含むフォルダを指すように Pathを設定します。

  3. Searchをクリックします。検索が実行されると、結果がComponentsパネルに表示されます。

Altium Designer にインストールされているライブラリからのみコンポーネントを配置できます。現在インストールされていないライブラリからコンポーネントを配置しようとすると、そのインストールを確認する必要があります。

高度な検索モード

ライブラリ検索は、実際にはクエリを使用して実行されます。File-based Libraries Searchダイアログで、Advancedモードに切り替えてクエリを調べます。

ダイアログのAdvancedモードでは、クエリ言語キーワードを使用して独自のクエリを作成し、クエリベースの検索を実行することもできます。利用可能なクエリー言語キーワードの詳細については、以下のセクションを参照してください。

Advancedモードが選択されている場合、以下の追加コントロールを使用します:

  • Helper- クリックしてQuery Helperダイアログを開き、定義済みのライブラリ関数とシステム関数を使用してライブラリ検索クエリを簡単に作成できます。また、HistoryボタンとFavoritesボタンを使用して、最近適用されたクエリや事前に定義されたライブラリー・クエリを選択することもできます。

  • History- クリックして Expression Managerダイアログを開き、ライブラリ検索に使用する、以前に適用されたクエリ式を1つ選択します。また、Favoritesボタンを使用して、指定したライブラリ検索に定義済みのクエリを使用することもできます。

  • Favorites- クリックして Expression Managerダイアログを開き、ライブラリ検索で使用するお気に入りのクエリ式を1つ選択します。Historyリストから式を削除、名前変更、またはコピーして、Favoritesリストを変更することもできます。

データベースコンポーネントを検索する場合、Advancedモードでは SQL クエリ検索を実行できます。このレベルの検索では、ダイアログのクエリエディタセクションにSQLクエリを直接入力することができ、指定したクエリ式に基づく「細かい」検索が可能です。

Advancedを クリックすると、強力なSQLベースのクエリ検索にアクセスできます。シンプルな検索に戻るには、もう一度Advancedを クリックします。

コンポーネントとライブラリのクエリ関数

Query Helperダイアログのコンポーネントとライブラリのクエリ関数
Query Helperダイアログのコンポーネントとライブラリのクエリ関数

Altium Designer の回路図と PCB エディタの根底には、強力なクエリエンジンがあります。このエンジンにクエリを入力することで、必要なオブジェクトを論理的にスコープできます。

クエリは、特定のキーワードと構文を使用して入力する文字列で、対象のオブジェクトを返します。多くのキーワードが用意されており、タイプ、プロパティ、またはその両方によってオブジェクトを絞り込むことができます。

クエリ言語の詳細については、クエリ言語の使用を参照してください。

以下のセクションでは、Altium Designer でデータベースやファイルベースのコンポーネントを検索する際に使用できるクエリ言語のキーワードについて説明します。特定のクエリキーワードに関するヘルプは、Query Helper で次の折りたたみ可能なセクションを使用するか、キーワードをハイライト(または内部をクリック)してください。

コンポーネントとライブラリのクエリ機能にアクセスするには、File-based Libraries Search ダイアログの Helperボタンをクリックします。

コンポーネント

すべて

フットプリント

If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
機能の可用性

利用できる機能は、所有している Altium Platform ソリューション (Altium Develop、または Altium Agile のエディション) によって異なります。

説明されている機能がお使いのソフトウェアに表示されない場合、Altium の営業担当者にお問い合わせください

従来のドキュメント

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

Content