変数
Part Studio の式で使用する変数を作成し、値を割り当てます。変数を寸法と式で使用します。変数は Onshape 内のフィーチャーであるため、フィーチャーリスト内での配置が重要です。フィーチャーを使用する前に変数を作成するか、値を必要とする操作中にその場で作成します。
- Part Studio で をクリックして [変数] ダイアログボックスを開きます。
- ダイアログで、次の操作を行います。
変数の名前 (およびその参照先) を入力します。
- タイプを選択します。
- 長さ - 長さを表す数値 (小数、整数、分数)
- 角度 - 角度を表す数値 (小数、整数、分数)
- 数値 - 数値 (小数、整数、分数)
- すべて - 上記のいずれか、異なる単位の数値、またはブーリアン演算、マップ、配列、文字列、関数などの FeatureScript 値。https://cad.onshape.com/FsDoc/variables.htm#standard-types および以下の例を参照してください。
- 値を入力します (必要に応じて、[長さ]、[角度]、および [すべて] の単位)。
- 変数のカスタムの説明を入力します。
名前には、英数字のみを使用してください (少なくとも 1 つの英文字の後に英文字や数字を続けてください)。変数名では、大文字と小文字が区別されます。
- をクリックします。
- Part Studio で をクリックして [変数] ダイアログボックスを開き、[測定済み] をクリックします。
- ダイアログで、次の操作を行います。
- タイプを選択します。
- 距離 - 距離を表す数値 (小数、整数、分数)
- 長さ - 長さを表す数値 (小数、整数、分数)
- 直径 - 直径を表す数値 (小数、整数、分数)
変数の名前 (およびその参照先) を入力します。
- エンティティを選択して間隔を測定します。
- 必要に応じて残りのフィールドに入力します。
名前には、英数字のみを使用してください (少なくとも 1 つの英文字の後に英文字や数字を続けてください)。変数名では、大文字と小文字が区別されます。
- タイプを選択します。
- をクリックします。
寸法を作成し、[寸法] フィールドに # と変数名を入力します (下に示すように、必要に応じて式の一部として)。
および
寸法を保存します。変数は値に置換され、式 (該当する場合) が解決されます。
編集用に寸法をダブルクリックすると、変数 (および式) が表示されます。
変数を含まない式をスケッチ寸法に使用すると、寸法値の左側に変数を含まない式アイコン () が表示されます。変数を含む式をスケッチ寸法に使用すると、寸法値の左に変数を含む式アイコン () が表示されます。「スケッチに式を表示する」を参照してください。
Part Studio で数式を使用する任意の場所で、変数を使用します。たとえば、押し出し操作や回転操作などです。
操作を通常どおり開始します (この場合は [回転])。数値フィールドに # と変数名を入力します (または、必要に応じて式の一部として)。
フィーチャーを受け入れます。
フィーチャーを編集すると、ソリューションが数値フィールドに表示されます。
フィールドをクリックすると、変数 (および該当する場合は式) が表示されます。
変数オートフィルフィーチャー
変数を定義した場合は、数値ダイアログフィールドにハッシュタグ(またはシャープ記号、アンダースコア、または任意の文字)を入力すると、以下のように変数の自動入力フィーチャーが開きます。
リストを妥当なオプションに絞り込むために入力を続けることができ、矢印キーを使用してリストを上下に移動したり、Enter キーを使用して一覧の変数が強調表示されたときにその変数を受け入れることができます。マウスのスクロールホイールを使用して変数リストをスクロールし、マウスをクリックして特定の変数を選択することもできます。シャープ記号を使用しない場合は、FeatureScript 関数もリストに含まれることに注意してください。
また、次の点に注意してください。
- Esc キーを使用すると、何も選択せずにドロップダウンが閉じます。ドロップダウンからフォーカスを削除すると、何も選択せずに閉じます。
- 計算値は薄い灰色で表示され、挿入されません (変数名または関数名のみが挿入されます)。同様に、関数入力の場合も、入力プレースホルダ名が挿入されないためです。
- フィーチャーリストのさらに下の変数は表示されず、現在のコンテキストに存在する変数のみが表示されます。
変数値には式を含めることができます。インデックスを持つ配列を指定することができ、インデックスは変数にすることもできます。これにより、インデックス変数の値を変更することで、変数の値を変更できます。
変数で配列を使用するには、まず 0 から始まるインデックスを設定する必要があります。
- 変数を作成し、名前を「config」に設定します。タイプとして [数値] を選択し、#config の値を 2 に設定します。
- 変数を作成し、名前を「直径」に設定します。#diameter の値を [0.25, 0.5, 1] [#config] に設定します。
-
変数を作成し、名前を「長さ」に設定します。#length の値を [2, 4, 10] [#config] に設定します。
- 円を作成します。
- 線を作成します。
- 円の直径を「#diameter」に設定します。
#config=2 なので、円の直径は 1 です。
- 線の長さを「#length」に設定します。
#config=2 なので、線の長さは 10 です。
これは、配列のインデックスポインタとして機能する括弧 [#config] の 2 番目のセットです。
すべての配列変数のインデックスを変更するには、インデックス変数の値を変更します。
たとえば、[フィーチャー] ダイアログボックス内のフィールドに数値を入力する場合、必要に応じて変数を作成できます。変数は、フィーチャーリストでのその時点での操作に先行して保存されます。
たとえば、スケッチを作成する場合、寸法用の数値を入力する代わりに寸法フィールドが表示され、ポンド記号 #、および新しい変数用のオプションに沿って表示される既存の変数のリストを入力することができます。
新しい変数を選択して [変数] ダイアログを開き、新しい変数を作成して現在のフィールドで使用します (使用可能であれば既存の変数の 1 つを選択することもできます)。
[変数の作成] ダイアログには、フィーチャー (既定) またはコンフィギュレーション用の変数を作成するオプションがあります。
新しい変数の名前と値を入力します。チェックマークをクリックして新しい変数を保存し、開いたフィーチャーで使用します。
FeatureScript の構文に従って、変数で FeatureScript 関数を使用できます。
たとえば、「Adjust」という名前の「任意」型の変数を作成して、指定した長さを 2 倍にし、2.5 mm を加算する関数を次のように格納します。
関数 (len){ return len * 2 + 2.5 mm; }
その変数を次のように式の中で参照します。
#Adjust (20mm)
- 変数の値を変更すると (フィーチャーと同じように編集)、その変数を使用するすべての操作が自動的に更新されます。
- 変数の名前を変更すると、その変数が使用されるすべての箇所に変更を伝播する選択ができます。
[すべての参照を更新] の横にチェックマークを付けます。
- Part Studio で をクリックして [変数ツール] ダイアログボックスを開きます。
- ダイアログボックスで、次の操作を行います。
- タイプを選択します。
- 長さ-長さを表す数値 (十進数、整数、分数)
- 角度 - 角度を表す数値 (小数、整数、分数)
- 数値 - 数値 (小数、整数、分数)
- すべて - 上記のいずれか、異なる単位の数値、またはブーリアン演算、マップ、配列、文字列、関数などの FeatureScript 値。https://cad.onshape.com/FsDoc/variables.htm#standard-types および以下の例を参照してください。
- 変数の名前 (およびその参照先) を入力します。
- 値を入力します (必要に応じて、[長さ]、[角度]、および [すべて] の単位)。
名前には、英数字のみを使用してください (少なくとも 1 つの英文字の後に英文字や数字を続けてください)。変数名では、大文字と小文字が区別されます。
- チェックマークをタップします。
作成した変数がフィーチャーリストに一覧表示され、変数の名前と値が表示されます。
- Part Studio で をクリックして [変数ツール] ダイアログボックスを開き、[測定済み] をクリックします。
- ダイアログで、次の操作を行います。
- タイプを選択します。
- 距離 - 距離を表す数値 (小数、整数、分数)
- 長さ - 長さを表す数値 (小数、整数、分数)
- 直径 - 角度を表す数値 (小数、整数、分数)
-
変数の名前 (およびその参照先) を入力します。
- エンティティを選択して間隔を測定します。
- 必要に応じて残りのフィールドに入力します。
名前には、英数字のみを使用してください (少なくとも 1 つの英文字の後に英文字や数字を続けてください)。変数名では、大文字と小文字が区別されます。
- チェックマークをタップします。
作成した変数がフィーチャーリストに一覧表示され、変数の名前と値が表示されます。
寸法を作成し、[寸法] フィールドに # と変数名を入力します (下に示すように、必要に応じて式の一部として)。
および
寸法を保存します。変数は値に置換され、式 (該当する場合) が解決されます。
編集用に寸法をダブルクリックすると、変数 (および式) が表示されます。
Part Studio で数式を使用する任意の場所で、変数を使用します。たとえば、押し出し操作または回転操作では、次のようになります。
操作を通常どおり開始します (この場合は [回転])。数値フィールドに # と変数名を入力します (または、任意で式の一部として)。たとえば、(#x) deg とします。
フィーチャーを受け入れます。
フィーチャーを編集すると、数値フィールドにソリューションが表示されます。たとえば、: 4 deg となります。
フィールドをクリックすると、変数 (および該当する場合は式) が表示されます。
変数値には式を含めることができますが、スカラー値に対して評価する必要があります。インデックスを持つ配列を指定することができ、インデックスは変数にすることもできます。これにより、インデックス変数の値を変更することで、変数の値を変更できます。
変数で配列を使用するには、まず 0 から始まるインデックスを設定する必要があります。
- 変数ツールをタップし、名前を「config」に設定します。#config の値を 2 に設定します。
- 変数ツールをタップし、名前を「直径」に設定します。#diameter の値を [0.25, 0.5, 1] [#config] に設定します。
- 変数ツールをタップし、名前を「長さ」に設定します。#length の値を [2, 4, 10] [#config] に設定します。
- スケッチツールをタップし、円をスケッチします。
- スケッチツールをタップし、線をスケッチします。
- 円の直径を「#diameter」に設定します。
- 線の長さを「#length」に設定します。
円の直径は 1 に設定され、線の長さは 10 に設定されます。
- #config 変数を編集し、値を 0 に設定します。
「#config」を含む括弧の 2 番目のセットを含めることが重要です。これは、変数 #config の値が配列内の正しい場所を指し示すことができるようにするためです。
「#config」を含む括弧の 2 番目のセットを含めることが重要です。これは、変数 #config の値が配列内の正しい場所を指し示すことができるようにするためです。
スケッチが更新され、円の直径が 0.25 に設定されると、線の長さが 2 に設定されます。
配列は好きなだけいくつでも実行でき、配列の配置は無限大です (この例のように 3 つの値に制限されるわけではありません)。
FeatureScript の構文に従って、変数で FeatureScript 関数を使用できます。
たとえば、「Adjust」という名前の「任意」型の変数を作成して、指定した長さを 2 倍にし、2.5 mm を加算する関数を次のように格納します。
関数 (len){ return len * 2 + 2.5 mm; }
その変数を次のように式の中で参照します。
#Adjust (20mm)
- 変数の値を変更すると (フィーチャーと同じように編集)、その変数を使用するすべての操作が自動的に更新されます。
- 変数名では、大文字と小文字が区別されます。
- 変数は、スタンドアロン値として、または数式の一部として入力できます。
- 変数は寸法、式、またはフィーチャーで使用できます。
-
単位なしで変数を指定する場合、式も単位なしになるか、ワークスペースの単位が想定されます。しかし、変数値に単位を明示的に追加する場合は、単位を記述して有効にするときに、いずれの式もその単位と一致する必要があります。
- 変数の名前を変更すると、その変数が使用されるすべての箇所に変更を伝播する選択ができます。
[すべての参照を更新] を選択します。
- Part Studio で をクリックして [変数ツール] ダイアログボックスを開きます。
- ダイアログボックスで、次の操作を行います。
- タイプを選択します。
- 長さ-長さを表す数値 (十進数、整数、分数)
- 角度 - 角度を表す数値 (小数、整数、分数)
- 数値 - 数値 (小数、整数、分数)
- すべて - 上記のいずれか、異なる単位の数値、またはブーリアン演算、マップ、配列、文字列、関数などの FeatureScript 値。https://cad.onshape.com/FsDoc/variables.htm#standard-types および以下の例を参照してください。
- 変数の名前 (およびその参照先) を入力します。
- 値を入力します (必要に応じて、[長さ]、[角度]、および [すべて] の単位)。
名前には、英数字のみを使用してください (少なくとも 1 つの英文字の後に英文字や数字を続けてください)。変数名では、大文字と小文字が区別されます。
- チェックマークをタップします。
作成した変数がフィーチャーリストに一覧表示され、変数の名前と値が表示されます。
- Part Studio で をクリックして [変数ツール] ダイアログボックスを開き、[測定済み] をクリックします。
- ダイアログで、次の操作を行います。
- タイプを選択します。
- 距離 - 距離を表す数値 (小数、整数、分数)
- 長さ - 長さを表す数値 (小数、整数、分数)
- 直径 - 角度を表す数値 (小数、整数、分数)
-
変数の名前 (およびその参照先) を入力します。
- エンティティを選択して間隔を測定します。
- 必要に応じて残りのフィールドに入力します。
名前には、英数字のみを使用してください (少なくとも 1 つの英文字の後に英文字や数字を続けてください)。変数名では、大文字と小文字が区別されます。
- チェックマークをタップします。
作成した変数がフィーチャーリストに一覧表示され、変数の名前と値が表示されます。
寸法を作成し、[寸法] フィールドに # と変数名を入力します (下に示すように、必要に応じて式の一部として)。
および
寸法を保存します。変数は値に置換され、式 (該当する場合) が解決されます。
編集用に寸法をダブルクリックすると、変数 (および式) が表示されます。
Part Studio で数式を使用する任意の場所で、変数を使用します。たとえば、押し出し操作または回転操作では、次のようになります。
操作を通常どおり開始します (この場合は [回転])。数値フィールドに # と変数名を入力します (または、任意で式の一部として)。たとえば、(#x) deg とします。
フィーチャーを受け入れます。
フィーチャーを編集すると、数値フィールドにソリューションが表示されます。たとえば、: 4 deg となります。
フィールドをクリックすると、変数 (および該当する場合は式) が表示されます。
変数値には式を含めることができますが、スカラー値に対して評価する必要があります。インデックスを持つ配列を指定することができ、インデックスは変数にすることもできます。これにより、インデックス変数の値を変更することで、変数の値を変更できます。
変数で配列を使用するには、まず 0 から始まるインデックスを設定する必要があります。
- 変数ツールをタップし、名前を「config」に設定します。#config の値を 2 に設定します。
- 変数ツールをタップし、名前を「直径」に設定します。#diameter の値を [0.25, 0.5, 1] [#config] に設定します。
- 変数ツールをタップし、名前を「長さ」に設定します。#length の値を [2, 4, 10] [#config] に設定します。
- スケッチツールをタップし、円をスケッチします。
- スケッチツールをタップし、線をスケッチします。
- 円の直径を「#diameter」に設定します。
- 線の長さを「#length」に設定します。
円の直径は 1 に設定され、線の長さは 10 に設定されます。
- #config 変数を編集し、値を 0 に設定します。
「#config」を含む括弧の 2 番目のセットを含めることが重要です。これは、変数 #config の値が配列内の正しい場所を指し示すことができるようにするためです。
「#config」を含む括弧の 2 番目のセットを含めることが重要です。これは、変数 #config の値が配列内の正しい場所を指し示すことができるようにするためです。
スケッチが更新され、円の直径が 0.25 に設定されると、線の長さが 2 に設定されます。
必要な数の配列に対してこれを行うことができ、配列は無限の場所を保持できます (この例で示す 3 つの値だけに制限されません)。
FeatureScript の構文に従って、変数で FeatureScript 関数を使用できます。
たとえば、「Adjust」という名前の「任意」型の変数を作成して、指定した長さを 2 倍にし、2.5 mm を加算する関数を次のように格納します。
関数 (len){ return len * 2 + 2.5 mm; }
その変数を次のように式の中で参照します。
#Adjust (20mm)
- 変数の値を変更すると (フィーチャーと同じように編集)、その変数を使用するすべての操作が自動的に更新されます。
- 変数名では、大文字と小文字が区別されます。
- 変数は、スタンドアロン値として、または数式の一部として入力できます。
- 変数は寸法、式、またはフィーチャーで使用できます。
ラーニングセンターに関するその他のリソースについては、こちらの技術説明記事「パラメトリック変数とコンフィギュレーション変数 (Onshape アカウントが必要です)」を参照してください。また、「変数と式 (Onshape アカウントが必要です)」というコースに登録することもできます。