変数

1. Part Studio で をクリックして [変数] ダイアログボックスを開きます。

   

2. ダイアログで、次の操作を行います。

   1. 変数の名前 (およびその参照先) を入力します。

   名前フィールドには、英数字と下線 (_) のみを使用してください。変数名は大文字と小文字が区別され、数字で始めることはできません。

   2. タイプを選択します。
      • 長さ - 長さを表す数値 (小数、整数、分数)
      • 角度 - 角度を表す数値 (小数、整数、分数)
      • 数値 - 数値 (小数、整数、分数)
      • すべて - 上記のいずれか、異なる単位の数値、またはブーリアン演算、マップ、配列、文字列、関数などの FeatureScript 値。https://cad.onshape.com/FsDoc/variables.html#standard-types および以下の例を参照してください。
   3. 値を入力します (必要に応じて、[長さ]、[角度]、および [すべて] の単位)。
   4. 変数のカスタムの説明を入力します。
3. をクリックします。

1. Part Studio で をクリックして [変数] ダイアログボックスを開き、[測定済み] をクリックします。

   

2. ダイアログで、次の操作を行います。
   1. タイプを選択します。
      • 距離 - 距離を表す数値 (小数、整数、分数)
      • 長さ - 長さを表す数値 (小数、整数、分数)
      • 直径 - 直径を表す数値 (小数、整数、分数)

   2. 変数の名前 (およびその参照先) を入力します。

   名前フィールドには、英数字と下線 (_) のみを使用してください。変数名は大文字と小文字が区別され、数字で始めることはできません。

   3. エンティティを選択して間隔を測定します。
   4. 必要に応じて残りのフィールドに入力します。
3. をクリックします。

変数フィーチャーの [From テーブル] オプションを使用すると、CSV テーブルの行と列のサブセットを格納する単一の変数を作成できます。[行] オプションは行を絞り込み、[変数] の結果タイプ (単一値、配列、またはマップ) を決定します。次に、[列] オプションで各行を絞り込み、最終変数の各エントリのタイプを決定します。

1. Part Studio で をクリックして [変数] ダイアログボックスを開き、[From テーブル] をクリックします。

   

2. ダイアログで、次の操作を行います。
   1. 変数の名前 (およびその参照先) を入力します。

   名前フィールドには、英数字と下線 (_) のみを使用してください。変数名は大文字と小文字が区別され、数字で始めることはできません。

   2. [CSV ファイル] で、[CSV ファイルの選択] フィールドをクリックしてダイアログを開きます。

      

      [現在のドキュメント] または [その他のドキュメント] から CSV ファイルを選択するか、ダイアログの下部にある [インポート] ボタンをクリックしてデバイスから CSV ファイルを選択します。

      選択したらファイルをクリックします。ファイルが [CSV ファイルを選択] フィールドに読み込まれます。

   3. 必要に応じて [行] と [列] のフィールドに入力してください。
      • アクセスタイプ - [インデックス別]、[インデックス範囲別]、[ラベル別]、または [すべての値] を選択します。
        • インデックス - [インデックス別] を選択した場合は、インデックスの値を 1 つ入力します。
        • 最小/最大インデックス - [インデックス範囲別] を選択した場合は、インデックスの最小値と最大値の両方を入力します。
        • 値 - [ラベル別] を選択した場合は、ラベルの文字列値を入力します。
      • 正規表現 - ターゲット文字列のセットがパターンマッチしているかどうかをチェックします。
      • 結果タイプ - [単一値]、[配列]、または [マップ] を選択します。
        • ラベル列/行インデックス - 結果タイプがマップの場合は、数値のインデックス値または変数を入力します。
   4. ある単位から別の単位に変換する場合 (たとえば、テーブルでインチを使用し、これらの値をセンチメートルに変換したい場合など) は、変換係数を確認して、測定単位で値を入力してください。

      

   5. オプションで、使用されている変数または CSV ファイルの詳細についての説明を入力します。
3. をクリックします。

例

以下のすべての例では、次の 3x3 の CSV テーブルを使用しています。

• 配列の配列 - 行と列の両方でアクセスタイプ: すべての値と結果タイプ: 配列を設定すると、CSV ファイル全体に対応する配列が作成されます。

  

• 最初の列でインデックス化された行 - CSV 行を最初の列の値でインデックス化するには、[行]で アクセスタイプ: すべての値、結果タイプ: マップ、ラベル列インデックス: 0 を選択します。これにより、テーブルの最初の列がマップキーとして設定されます。

  [列] で、[アクセスタイプ: インデックス範囲別] を選択し、テーブルの列の最小/最大インデックスの範囲を設定します (下の例では、最小/最大インデックスの範囲に 1/2 と入力されており、テーブルの 2 番目と 3 番目の列の配列になります）。最後に、[結果タイプ: 配列] を選択します。

  

• 最初の列 - 最初の列のみにアクセスするには、[行] でアクセスタイプ: すべての値と結果タイプ: 配列を設定します。次に、[列] でアクセスタイプ: インデックス別 (0) と結果タイプ: 単一値を選択します。

  

• 最初の行 - 最初の行のみにアクセスするには、[行] でアクセスタイプ: インデックス別 (0) と結果タイプ: 単一値を設定します。次に、[列] でアクセスタイプː すべての値と結果タイプː 配列を選択します。

  

注記

• 変数の結果を表示するには、フィーチャー名の上にマウスのカーソルを合わせます。ツールチップに CSV ファイルの結果が表示されます。

  

• 変数はテーブルから取得されるため、変数テーブル内の変数タイプと値は読み取り専用です (以下の例ではディメンション変数)。

  

寸法を作成し、[寸法] フィールドに # と変数名を入力します (下に示すように、必要に応じて式の一部として)。

および

寸法を保存します。変数は値に置換され、式 (該当する場合) が解決されます。

編集用に寸法をダブルクリックすると、変数 (および式) が表示されます。

変数を含まない式をスケッチ寸法に使用すると、寸法値の左側に変数を含まない式アイコン () が表示されます。変数を含む式をスケッチ寸法に使用すると、寸法値の左に変数を含む式アイコン () が表示されます。「スケッチに式を表示する」を参照してください。

Part Studio で数式を使用する任意の場所で、変数を使用します。たとえば、押し出し操作や回転操作などです。

通常どおり操作を開始します (この場合は [回転])。数値フィールドに # と変数名 (または、必要に応じて式の一部として) を入力します。

フィーチャーを確定します。

フィーチャーを編集すると、ソリューションが数値フィールドに表示されます。

フィールドをクリックすると、変数 (および該当する場合は式) が表示されます。

変数オートフィルフィーチャー

変数を定義した場合は、数値ダイアログフィールドにハッシュタグ (またはシャープ記号、アンダースコア、または任意の文字) を入力すると、以下のように変数の自動入力フィーチャーが開きます。

左ː ダイアログで変数を使用。右ː スケッチの寸法フィールドで変数を使用。

リストを妥当なオプションに絞り込むために入力を続けることができ、矢印キーを使用してリストを上下に移動したり、Enter キーを使用して一覧の変数が強調表示されたときにその変数を受け入れることができます。マウスのスクロールホイールを使用して変数リストをスクロールし、マウスをクリックして特定の変数を選択することもできます。シャープ記号を使用しない場合は、FeatureScript 関数もリストに含まれることに注意してください。

また、次の点に注意してください。

• Esc キーを使用すると、何も選択せずにドロップダウンが閉じます。ドロップダウンからフォーカスを削除すると、何も選択せずに閉じます。
• 計算値は薄い灰色で表示され、挿入されません (変数名または関数名のみが挿入されます)。同様に、関数入力の場合も、入力プレースホルダ名が挿入されないためです。
• フィーチャーリストのさらに下の変数は表示されず、現在のコンテキストに存在する変数のみが表示されます。

変数値には式を含めることができます。インデックスを持つ配列を指定することができ、インデックスは変数にすることもできます。これにより、インデックス変数の値を変更することで、変数の値を変更できます。

変数で配列を使用するには、まず 0 から始まるインデックスを設定する必要があります。

1. 変数を作成し、名前を「config」に設定します。タイプとして [数値] を選択し、#config の値を 2 に設定します。
2. 変数を作成し、名前を「直径」に設定します。#diameter の値を [0.25, 0.5, 1] [#config] に設定します。

これは、配列のインデックスポインタとして機能する括弧 [#config] の 2 番目のセットです。

3. 変数を作成し、名前を「長さ」に設定します。#length の値を [2, 4, 10] [#config] に設定します。

4. 円を作成します。
5. 線を作成します。
6. 円の直径を「#diameter」に設定します。

   #config=2 なので、円の直径は 1 です。

7. 線の長さを「#length」に設定します。

   #config=2 なので、線の長さは 10 です。

すべての配列変数のインデックスを変更するには、インデックス変数の値を変更します。

たとえば、[フィーチャー] ダイアログボックス内のフィールドに数値を入力する場合、必要に応じて変数を作成できます。変数は、フィーチャーリストでのその時点での操作に先行して保存されます。

たとえば、スケッチを作成する場合、寸法用の数値を入力する代わりに寸法フィールドが表示され、ポンド記号 #、および新しい変数用のオプションに沿って表示される既存の変数のリストを入力することができます。

新しい変数を選択して [変数] ダイアログを開き、新しい変数を作成して現在のフィールドで使用します (使用可能であれば既存の変数の 1 つを選択することもできます)。

[変数の作成] ダイアログには、フィーチャー (既定) またはコンフィギュレーション用の変数を作成するオプションがあります。

新しい変数の名前と値を入力します。チェックマークをクリックして新しい変数を保存し、開いたフィーチャーで使用します。

FeatureScript の構文に従って、変数で FeatureScript 関数を使用できます。

たとえば、「Adjust」という名前の「任意」型の変数を作成して、指定した長さを 2 倍にし、2.5 mm を加算する関数を次のように格納します。

関数 (len){ return len * 2 + 2.5 mm; }

その変数を次のように式の中で参照します。

#Adjust (20mm)

• 変数の値を変更すると (フィーチャーと同じように編集)、その変数を使用するすべての操作が自動的に更新されます。
• 変数の名前を変更すると、その変数が使用されるすべての箇所に変更を伝播する選択ができます。

  

  [すべての参照を更新] の横にチェックマークを付けます。

1. Part Studio で変数ツールアイコン () を選択して [変数ツール] ダイアログボックスを開きます。

   

2. ダイアログボックスで、次の操作を行います。
   1. タイプを選択します。
   • 長さ-長さを表す数値 (十進数、整数、分数)
   • 角度 - 角度を表す数値 (小数、整数、分数)
   • 数値 - 数値 (小数、整数、分数)
   • すべて - 上記のいずれか、異なる単位の数値、またはブーリアン演算、マップ、配列、文字列、関数などの FeatureScript 値。https://cad.onshape.com/FsDoc/variables.html#standard-types および以下の例を参照してください。
   2. 変数の名前 (およびその参照先) を入力します。

   名前フィールドには、英数字と下線 (_) のみを使用してください。変数名は大文字と小文字が区別され、数字で始めることはできません。

   3. 値を入力します (必要に応じて、[長さ]、[角度]、および [すべて] の単位)。
3. チェックマークをタップします。

作成した変数がフィーチャーリストに一覧表示され、変数の名前と値が表示されます。

1. Part Studio で変数ツールアイコン () を選択して [変数ツール] ダイアログボックスを開き、[測定済み] をタップします。

   

2. ダイアログで、次の操作を行います。
   1. タイプを選択します。
   • 距離 - 距離を表す数値 (小数、整数、分数)
   • 長さ - 長さを表す数値 (小数、整数、分数)
   • 直径 - 角度を表す数値 (小数、整数、分数)

3. 変数の名前 (およびその参照先) を入力します。

   名前フィールドには、英数字と下線 (_) のみを使用してください。変数名は大文字と小文字が区別され、数字で始めることはできません。

   1. エンティティを選択して間隔を測定します。
   2. 必要に応じて残りのフィールドに入力します。
4. チェックマークをタップします。

作成した変数がフィーチャーリストに一覧表示され、変数の名前と値が表示されます。

変数フィーチャーの [From テーブル] オプションを使用すると、CSV テーブルの行と列のサブセットを格納する単一の変数を作成できます。[行] オプションは行を絞り込み、[変数] の結果タイプ (単一値、配列、またはマップ) を決定します。次に、[列] オプションで各行を絞り込み、最終変数の各エントリのタイプを決定します。

iOS での CSV ファイル (From テーブル) からの変数作成のサポートは、デスクトップ (ブラウザ) プラットフォームで作成した変数の編集と表示に限定されています。

1. をタップして [変数] ダイアログを開き、[From テーブル] をタップします。

   

2. ダイアログで、次の操作を行います。
   1. 変数の名前 (およびその参照先) を入力します。

   名前フィールドには、英数字と下線 (_) のみを使用してください。変数名は大文字と小文字が区別され、数字で始めることはできません。

   2. [CSV ファイル]の下で、[CSV ファイルを選択] フィールドをタップして、既存の CSV ファイルを選択して開きます。[CSV ファイルを選択] フィールドに読み込まれます。

      必要に応じて、[行] フィールドと [列] フィールドに入力します。

      • アクセスタイプ - [インデックス別]、[インデックス範囲別]、[ラベル別]、または [すべての値] を選択します。
        • インデックス - [インデックス別] を選択した場合は、インデックスの値を 1 つ入力します。
        • 最小/最大インデックス - [インデックス範囲別] を選択した場合は、インデックスの最小値と最大値の両方を入力します。
        • 値 - [ラベル別] を選択した場合は、ラベルの文字列値を入力します。
      • 正規表現 - ターゲット文字列のセットがパターンマッチしているかどうかをチェックします。
      • 結果タイプ - [単一値]、[配列]、または [マップ] を選択します。
        • ラベル列/行インデックス - 結果タイプがマップの場合は、数値のインデックス値または変数を入力します。
   3. ある単位から別の単位に変換する場合 (たとえば、テーブルでインチを使用し、これらの値をセンチメートルに変換したい場合など) は、変換係数に切り替えて、測定単位で値を入力してください。
   4. オプションで、使用されている変数または CSV ファイルの詳細についての説明を入力します。
3. チェックマークをタップします。

寸法を作成し、[寸法] フィールドに # と変数名を入力します (下に示すように、必要に応じて式の一部として)。

および

寸法を保存します。変数は値に置換され、式 (該当する場合) が解決されます。

編集用に寸法をダブルクリックすると、変数 (および式) が表示されます。

Part Studio で数式を使用する任意の場所で、変数を使用します。たとえば、押し出し操作または回転操作では、次のようになります。

操作を通常どおり開始します (この場合は [回転])。数値フィールドに # と変数名を入力します (または、任意で式の一部として)。たとえば、(#x) deg とします。

フィーチャーを確定します。

フィーチャーを編集すると、数値フィールドにソリューションが表示されます。たとえば、: 4 deg となります。

フィールドをクリックすると、変数 (および該当する場合は式) が表示されます。

変数値には式を含めることができますが、スカラー値に対して評価する必要があります。インデックスを持つ配列を指定することができ、インデックスは変数にすることもできます。これにより、インデックス変数の値を変更することで、変数の値を変更できます。

変数で配列を使用するには、まず 0 から始まるインデックスを設定する必要があります。

1. 変数ツールをタップし、名前を「config」に設定します。#config の値を 2 に設定します。
2. 変数ツールをタップし、名前を「直径」に設定します。#diameter の値を [0.25, 0.5, 1] [#config] に設定します。

「#config」を含む括弧の 2 番目のセットを含めることが重要です。これは、変数 #config の値が配列内の正しい点を指し示すことができるようにするためです。

3. 変数ツールをタップし、名前を「長さ」に設定します。#length の値を [2, 4, 10] [#config] に設定します。

「#config」を含む括弧の 2 番目のセットを含めることが重要です。これは、変数 #config の値が配列内の正しい点を指し示すことができるようにするためです。

4. スケッチツールをタップし、円をスケッチします。
5. スケッチツールをタップし、線をスケッチします。
6. 円の直径を「#diameter」に設定します。
7. 線の長さを「#length」に設定します。

   円の直径は 1 に設定され、線の長さは 10 に設定されます。

8. #config 変数を編集し、値を 0 に設定します。

スケッチが更新され、円の直径が 0.25 に設定されると、線の長さが 2 に設定されます。

配列は好きなだけいくつでも実行でき、配列の配置は無限大です (この例のように 3 つの値に制限されるわけではありません)。

FeatureScript の構文に従って、変数で FeatureScript 関数を使用できます。

たとえば、「Adjust」という名前の「任意」型の変数を作成して、指定した長さを 2 倍にし、2.5 mm を加算する関数を次のように格納します。

関数 (len){ return len * 2 + 2.5 mm; }

その変数を次のように式の中で参照します。

#Adjust (20mm)

• 変数の値を変更すると (フィーチャーと同じように編集)、その変数を使用するすべての操作が自動的に更新されます。
• 変数名では、大文字と小文字が区別されます。
• 変数は、スタンドアロン値として、または数式の一部として入力できます。
• 変数は寸法、式、またはフィーチャーで使用できます。

• 単位なしで変数を指定する場合、式も単位なしになるか、ワークスペースの単位が想定されます。しかし、変数値に単位を明示的に追加する場合は、単位を記述して有効にするときに、いずれの式もその単位と一致する必要があります。

• 変数の名前を変更すると、その変数が使用されるすべての箇所に変更を伝播する選択ができます。

  

  [すべての参照を更新] を選択します。

1. Part Studio で をクリックして [変数ツール] ダイアログボックスを開きます。

   

2. ダイアログボックスで、次の操作を行います。
   1. タイプを選択します。
   • 長さ-長さを表す数値 (十進数、整数、分数)
   • 角度 - 角度を表す数値 (小数、整数、分数)
   • 数値 - 数値 (小数、整数、分数)
   • すべて - 上記のいずれか、異なる単位の数値、またはブーリアン演算、マップ、配列、文字列、関数などの FeatureScript 値。https://cad.onshape.com/FsDoc/variables.html#standard-types および以下の例を参照してください。
   2. 変数の名前 (およびその参照先) を入力します。

   名前フィールドには、英数字と下線 (_) のみを使用してください。変数名は大文字と小文字が区別され、数字で始めることはできません。

   3. 値を入力します (必要に応じて、[長さ]、[角度]、および [すべて] の単位)。
3. チェックマークをタップします。

作成した変数がフィーチャーリストに一覧表示され、変数の名前と値が表示されます。

1. Part Studio で をクリックして [変数ツール] ダイアログボックスを開き、[測定済み] をクリックします。

   

2. ダイアログで、次の操作を行います。
   1. タイプを選択します。
   • 距離 - 距離を表す数値 (小数、整数、分数)
   • 長さ - 長さを表す数値 (小数、整数、分数)
   • 直径 - 角度を表す数値 (小数、整数、分数)

3. 変数の名前 (およびその参照先) を入力します。

   名前フィールドには、英数字と下線 (_) のみを使用してください。変数名は大文字と小文字が区別され、数字で始めることはできません。

   1. エンティティを選択して間隔を測定します。
   2. 必要に応じて残りのフィールドに入力します。
4. チェックマークをタップします。

作成した変数がフィーチャーリストに一覧表示され、変数の名前と値が表示されます。

変数フィーチャーの [From テーブル] オプションを使用すると、CSV テーブルの行と列のサブセットを格納する単一の変数を作成できます。[行] オプションは行を絞り込み、[変数] の結果タイプ (単一値、配列、またはマップ) を決定します。次に、[列] オプションで各行を絞り込み、最終変数の各エントリのタイプを決定します。

Android での CSV ファイル (From テーブル) からの変数作成のサポートは、デスクトップ (ブラウザ) プラットフォームで作成した変数の編集と表示に限定されています。

1. をタップして [変数] ダイアログを開き、[From テーブル] をタップします。

   

2. ダイアログで、次の操作を行います。
   1. 変数の名前 (およびその参照先) を入力します。

   名前フィールドには、英数字と下線 (_) のみを使用してください。変数名は大文字と小文字が区別され、数字で始めることはできません。

   2. [CSV ファイル]の下で、[CSV ファイルを選択] フィールドをタップして、既存の CSV ファイルを選択して開きます。[CSV ファイルを選択] フィールドに読み込まれます。

      必要に応じて、[行] フィールドと [列] フィールドに入力します。

      • アクセスタイプ - [インデックス別]、[インデックス範囲別]、[ラベル別]、または [すべての値] を選択します。
        • インデックス - [インデックス別] を選択した場合は、インデックスの値を 1 つ入力します。
        • 最小/最大インデックス - [インデックス範囲別] を選択した場合は、インデックスの最小値と最大値の両方を入力します。
        • 値 - [ラベル別] を選択した場合は、ラベルの文字列値を入力します。
      • 正規表現 - ターゲット文字列のセットがパターンマッチしているかどうかをチェックします。
      • 結果タイプ - [単一値]、[配列]、または [マップ] を選択します。
        • ラベル列/行インデックス - 結果タイプがマップの場合は、数値のインデックス値または変数を入力します。
   3. ある単位から別の単位に変換する場合 (たとえば、テーブルでインチを使用し、これらの値をセンチメートルに変換したい場合など) は、変換係数に切り替えて、測定単位で値を入力してください。
   4. オプションで、使用されている変数または CSV ファイルの詳細についての説明を入力します。
3. チェックマークをタップします。

寸法を作成し、[寸法] フィールドに # と変数名を入力します (下に示すように、必要に応じて式の一部として)。

および

寸法を保存します。変数は値に置換され、式 (該当する場合) が解決されます。

編集用に寸法をダブルクリックすると、変数 (および式) が表示されます。

Part Studio で数式を使用する任意の場所で、変数を使用します。たとえば、押し出し操作または回転操作では、次のようになります。

操作を通常どおり開始します (この場合は [回転])。数値フィールドに # と変数名を入力します (または、任意で式の一部として)。たとえば、(#x) deg とします。

フィーチャーを確定します。

フィーチャーを編集すると、数値フィールドにソリューションが表示されます。たとえば、: 4 deg となります。

フィールドをクリックすると、変数 (および該当する場合は式) が表示されます。

変数値には式を含めることができますが、スカラー値に対して評価する必要があります。インデックスを持つ配列を指定することができ、インデックスは変数にすることもできます。これにより、インデックス変数の値を変更することで、変数の値を変更できます。

変数で配列を使用するには、まず 0 から始まるインデックスを設定する必要があります。

1. 変数ツールをタップし、名前を「config」に設定します。#config の値を 2 に設定します。
2. 変数ツールをタップし、名前を「直径」に設定します。#diameter の値を [0.25, 0.5, 1] [#config] に設定します。

「#config」を含む括弧の 2 番目のセットを含めることが重要です。これは、変数 #config の値が配列内の正しい点を指し示すことができるようにするためです。

3. 変数ツールをタップし、名前を「長さ」に設定します。#length の値を [2, 4, 10] [#config] に設定します。

「#config」を含む括弧の 2 番目のセットを含めることが重要です。これは、変数 #config の値が配列内の正しい点を指し示すことができるようにするためです。

4. スケッチツールをタップし、円をスケッチします。
5. スケッチツールをタップし、線をスケッチします。
6. 円の直径を「#diameter」に設定します。
7. 線の長さを「#length」に設定します。

   円の直径は 1 に設定され、線の長さは 10 に設定されます。

8. #config 変数を編集し、値を 0 に設定します。

スケッチが更新され、円の直径が 0.25 に設定されると、線の長さが 2 に設定されます。

必要な数の配列に対してこれを行うことができ、配列は無限の場所を保持できます (この例で示す 3 つの値だけに制限されません)。

FeatureScript の構文に従って、変数で FeatureScript 関数を使用できます。

たとえば、「Adjust」という名前の「任意」型の変数を作成して、指定した長さを 2 倍にし、2.5 mm を加算する関数を次のように格納します。

関数 (len){ return len * 2 + 2.5 mm; }

その変数を次のように式の中で参照します。

#Adjust (20mm)

• 変数の値を変更すると (フィーチャーと同じように編集)、その変数を使用するすべての操作が自動的に更新されます。
• 変数名では、大文字と小文字が区別されます。
• 変数は、スタンドアロン値として、または数式の一部として入力できます。
• 変数は寸法、式、またはフィーチャーで使用できます。