Variable

1. Cuando esté en un Part Studio, haga clic en para abrir el cuadro de diálogo Variable.

   

2. En el cuadro de diálogo:

   1. Escriba un nombre para la variable (con el que se hará referencia a ella).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   2. Seleccione un tipo:
      • Longitud: valor numérico que representa una longitud (decimal, entero, fracción)
      • Ángulo: valor numérico que representa un ángulo (decimal, entero, fracción)
      • Número: valor numérico (decimal, entero, fracción)
      • Cualquiera: cualquiera de los anteriores; valor numérico con diferentes unidades o un valor de FeatureScript como booleano, mapa, matriz, cadena o función. Consulte https://cad.onshape.com/FsDoc/variables.html#standard-types y vea ejemplos a continuación.
   3. Introduzca un valor (y, si lo desea, unidades para Longitud, Ángulo y Cualquiera).
   4. Ingrese una descripción personalizada para su variable.
3. Haga clic en .

1. While in a Part Studio, click to open the Variable dialog box, then click Measured:

   

2. En el cuadro de diálogo:
   1. Seleccione un tipo:
      • Distancia: es un valor numérico que representa una distancia (decimal, entero o fracción)
      • Longitud: valor numérico que representa una longitud (decimal, entero, fracción)
      • Diámetro: es un valor numérico que representa un diámetro (decimal, entero o fracción)

   2. Escriba un nombre para la variable (con el que se hará referencia a ella).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   3. Seleccione las entidades entre las que desee medir.
   4. Complete los campos restantes según sus preferencias.
3. Haga clic en .

The From table option in the Variable feature enables users to create a single variable that stores a subset of rows and columns from the CSV table. The Row options filter the rows and determine the Result type (Single value, Array, or Map) of the variable. The Column options then filter each row and determine the type of each entry in the final variable.

1. While in a Part Studio, click to open the Variable dialog, then click From table:

   

2. In the dialog:
   1. Enter a Name for the variable (and by which to reference it).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   2. Under CSV file, click the Select CSV file field to open the dialog:

      

      Select the CSV file from either the Current document, Other documents, or click the Import button at the bottom of the dialog to select a CSV file from your device.

      Once selected, click the file. It is loaded into the Select CSV file field.

   3. Fill out the Row and Column fields according to your requirements:
      • Access type - Select  By index, By index range, By label, or All values.
        • Index - If By index is selected, enter a single Index value.
        • Min/Max index - When By index range is selected, enter both the minimum and maximum index values.
        • Value - If By label is selected, enter the label's string value.
      • Regular expression - Check to pattern match a set of target strings.
      • Result type - Select Single value, Array, or Map.
        • Label column/row index - If the Result type is a Map, enter either a numerical index value or a variable.
   4. Check Conversion factor and enter a value with measurement units if you are converting from one measurement to another (for example, if the table uses inches, and you want these values converted to centimeters).

      

   5. Optionally, enter a Description to provide some details about the Variable or CSV file being used.
3. Click .

Examples

All examples below use the following 3x3 CSV table:

• An array of arrays - Setting Access type: All values and Result type: Array for both Row and Column creates an array of arrays that corresponds to the entire CSV file:

  

• Rows indexed by the first column - To index the CSV rows by the values in the first column, select Access type: All values, Result type: Map, and Label column index: 0 for Row. This sets the first column in the table as the map key.

  For Column, select Access type: By index range and set the Min/Max index range for the table columns (in the example below, a Min/Max index range of 1/2 is entered, which provides an array for the second and third columns in the table). Finally, select Result type: Array:

  

• First column - To access only the first column, set Access type: All values and Result type: Array for Row. Then select Access type: By index (0) and Result type: Single value for Column:

  

• First row - To access only the first row, set Access type: By index (0) and Result type: Single value for Row. Then select Access type: All values and Result type: Array for Column:

  

Notes

• To view the variable result, hover your mouse over the feature name. A tooltip displays the result from the CSV file:

  

• Since a variable is sourced from a table, its Variable type and Value in the Variable table are read-only (the Dimensions variable in the example below):

  

Cree una cota: en el campo de cota escriba # y el nombre de la variable (y, si lo desea, como parte de una expresión, como se muestra a continuación):

and

Guarde la cota; la variable se reemplaza con el valor y la expresión (si procede) se resuelve:

Al hacer doble clic en la cota para editarla, se muestra la variable (y la expresión):

If an expression without a variable is used for a sketch dimension, it is indicated with the Expression without a variable icon () to the left of the dimension value. If an expression with a variable is used for a sketch dimension, it is indicated with the Expression with variable icon () to the left of the dimension value. See Displaying expressions in a sketch.

Utilice variables en cualquier lugar en el que utilice expresiones en un Part Studio. Por ejemplo, en una operación de extrusión o revolución.

Start the operation as usual (in this case, Revolve); in the numeric value field, enter # and the variable name (or optionally, as part of an expression):

Acepte la operación.

Al editar la operación, la solución se muestra en el campo de valor numérico:

Haga clic en el campo y se mostrará la variable (y la expresión, si procede).

Operación de relleno automático de variables

Cuando tenga variables definidas, al introducir un hashtag (o signo de numeral, guion bajo o cualquier letra) en un campo numérico de un cuadro de diálogo, se abre la operación de relleno automático de variables como se muestra a continuación:

Left: using a variable in a dialog. Right: using a variable in a dimension field in a sketch.

Puede seguir escribiendo para filtrar la lista con opciones razonables, utilizar las teclas de dirección para desplazarse hacia arriba y hacia abajo en la lista y utilizar la tecla Intro para aceptar una variable de la lista cuando esté resaltada. También puede utilizar la rueda de desplazamiento del mouse para desplazarse por la lista de variables y hacer clic con este para seleccionar una variable en particular. Tenga en cuenta que las funciones de FeatureScript también se incluyen en la lista cuando no se usa el signo de la libra:

Tenga en cuenta también lo siguiente:

• El uso de la tecla Escape cierra el menú desplegable sin seleccionar nada. Eliminar el foco del menú desplegable también lo cierra sin seleccionar nada.
• Los valores de cálculo se muestran en gris claro y no se insertarán (solo se inserta la variable o el nombre de la función). Sucede lo mismo con las entradas de función, porque los nombres de marcador de posición de entrada no se insertan.
• Solo se muestran las variables que existen en el contexto actual; las variables más abajo en la lista de operaciones no se muestran

Los valores de las variables pueden contener expresiones. Se puede especificar una matriz con un índice, el cual puede ser una variable. Esto le permite cambiar el valor de la variable mediante la modificación del valor de la variable del índice.

Para utilizar matrices en variables, primero debe configurar un índice basado en cero.

1. Crea una variable y otórguele el nombre 'config'. Seleccione Número como tipo y establezca el valor de #config en '2'.
2. Cree una variable y nómbrela 'diameter'. Establezca el valor de #diameter en '[0.25, 0.5, 1] [#config]'.

Es el segundo conjunto de corchetes [#config] el que sirve como puntero de índice en la matriz.

3. Cree una variable y nómbrela 'length'. Establezca el valor de #length en '[2, 4, 10] [#config]'.

4. Cree un círculo.
5. Cree una línea.
6. Establezca el diámetro del círculo en '#diameter'.

   Dado que #config = 2, el diámetro del círculo es 1.

7. Establezca la longitud de la línea en '#length'.

   Dado que #config = 2, la longitud de la línea es 10.

Cambie el valor de la variable de índice para cambiar los índices de todas las variables de matriz.

Puede crear variables según las necesite, por ejemplo, al introducir un valor numérico en un campo de un cuadro de diálogo de entidades. La variable se guarda antes que la operación actual en la lista de operaciones.

Por ejemplo, al crear un boceto, cuando aparece el campo de cota, en lugar de introducir un valor para la cota, puede escribir el signo de libra #, y se mostrará la lista de variables existentes, junto con una opción para una nueva variable:

Seleccione Nueva variable para abrir el cuadro de diálogo Variable a fin de crear una nueva variable y utilizarla en el campo actual (de lo contrario, seleccione una de las variables existentes, si está disponible).

El cuadro de diálogo Crear variable ofrece la opción de crear una variable para una entidad (por defecto) o una configuración.

Introduzca un nombre para la nueva variable, así como un valor. Haga clic en la marca de verificación para guardar la nueva variable y utilizarla en la función abierta.

Puede usar funciones de FeatureScript en una variable siguiendo la sintaxis de FeatureScript.

Por ejemplo, puede crear una variable del tipo Any, denominada «Ajustar», para almacenar una función que duplique una longitud determinada y añada 2,5 mm de la siguiente manera:

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

y, luego, haga referencia a esa variable en una expresión, como en este caso:

#Adjust(20mm)

• Cuando cambia el valor de una variable (edítala como lo haría con cualquier operación), todas las operaciones que utilizan la variable se actualizan automáticamente.
• When you change the name of a variable, you have the choice to propagate the change everywhere the variable is used:

  

  Marque la casilla situada junto a Actualizar todas las referencias.

1. Cuando esté en un Part Studio, seleccione el ícono de la herramienta Variable () para abrir el cuadro de diálogo de la herramienta Variable:

   

2. En el cuadro de diálogo, haga lo siguiente:
   1. Seleccione un tipo:
   • Longitud: es un valor numérico que representa una longitud (valor decimal, entero o fracción)
   • Ángulo: valor numérico que representa un ángulo (decimal, entero, fracción)
   • Número: valor numérico (decimal, entero, fracción)
   • Cualquiera: cualquiera de los anteriores; valor numérico con diferentes unidades o un valor de FeatureScript como booleano, mapa, matriz, cadena o función. Consulte https://cad.onshape.com/FsDoc/variables.html#standard-types y vea ejemplos a continuación.
   2. Escriba un nombre para la variable (con el que se hará referencia a ella).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   3. Introduzca un valor (y, si lo desea, unidades para Longitud, Ángulo y Cualquiera).
3. Toque la casilla de verificación.

La variable que ha creado aparecerá en la lista de operaciones, donde se figura el nombre y el valor de la variable.

1. While in a Part Studio, select the Variable tool icon () to open the Variable tool dialog box, then tap Measured:

   

2. En el cuadro de diálogo:
   1. Seleccione un tipo:
   • Distancia: es un valor numérico que representa una distancia (decimal, entero o fracción)
   • Longitud: valor numérico que representa una longitud (decimal, entero, fracción)
   • Diámetro: es un valor numérico que representa un ángulo (decimal, entero, fracción)

3. Escriba un nombre para la variable (con el que se hará referencia a ella).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   1. Seleccione las entidades entre las que desee medir.
   2. Complete los campos restantes según sus preferencias.
4. Toque la casilla de verificación.

La variable que ha creado aparecerá en la lista de operaciones, donde se figura el nombre y el valor de la variable.

The From table option in the Variable feature enables users to create a single variable that stores a subset of rows and columns from the CSV table. The Row options filter the rows and determine the Result type (Single value, Array, or Map) of the variable. The Column options then filter each row and determine the type of each entry in the final variable.

iOS support for creating a Variable from a CSV file (From table) is limited to editing and viewing variables created on the desktop (browser) platform.

1. Tap to open the Variable dialog, then tap From table:

   

2. In the dialog:
   1. Enter a Name for the variable (and by which to reference it).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   2. Under CSV file, tap the Select CSV file field to select and open an existing CSV file. It is loaded into the Select CSV file field.

      Fill out the Row and Column fields according to your requirements:

      • Access type - Select  By index, By index range, By label, or All values.
        • Index - If By index is selected, enter a single Index value.
        • Min/Max index - When By index range is selected, enter both the minimum and maximum index values.
        • Value - If By label is selected, enter the label's string value.
      • Regular expression - Check to pattern match a set of target strings.
      • Result type - Select Single value, Array, or Map.
        • Label column/row index - If the Result type is a Map, enter either a numerical index value or a variable.
   3. Toggle Conversion factor and enter a value with measurement units if you are converting from one measurement to another (for example, if the table uses inches, and you want these values converted to centimeters).
   4. Optionally, enter a Description to provide some details about the Variable or CSV file being used.
3. Tap the checkmark.

Cree una cota: en el campo de cota escriba # y el nombre de la variable (y, si lo desea, como parte de una expresión, como se muestra a continuación):

and

Guarde la cota; la variable se reemplaza con el valor y la expresión (si procede) se resuelve:

Al hacer doble clic en la cota para editarla, se muestra la variable (y la expresión):

Utilice variables en cualquier lugar donde utilice expresiones en Part Studio. Por ejemplo, en una operación de extrusión o revolución:

Inicie la operación como de costumbre (en este caso, Revolución). En el campo de valor numérico, escriba # y el nombre de la variable (o bien, como parte de una expresión). Por ejemplo: (#x) deg.

Acepte la operación.

Cuando edite la operación, la solución se mostrará en el campo de valor numérico. Por ejemplo: 4 deg.

Haga clic en el campo y se mostrará la variable (y la expresión, si procede).

Los valores de las variables pueden contener expresiones, pero se deben evaluar como un valor escalar. Se puede especificar una matriz con un índice, el cual puede ser una variable. Esto le permite cambiar el valor de la variable mediante la modificación del valor de la variable del índice.

Para utilizar matrices en variables, primero debe establecer un índice basado en cero.

1. Pulse en la herramienta Variable y establezca el nombre en "config". Defina el valor de #config en 2.
2. Pulse en la herramienta Variable y escriba el nombre «diámetro». Establezca el valor de #diameter en [0,25; 0,5; 1] [#config].

Es importante que incluya el segundo conjunto de corchetes que contenga '#config'. Esto es lo que permite que el valor de la variable #config apunte al lugar correcto de la matriz.

3. Pulse en la herramienta Variable y establezca el nombre en "lenght". Defina el valor de #length en [2, 4, 10] [#config].

Es importante que incluya el segundo conjunto de corchetes que contenga '#config'. Esto es lo que permite que el valor de la variable #config apunte al lugar correcto de la matriz.

4. Pulse en la herramienta de boceto y cree un boceto de un círculo.
5. Pulse en la herramienta de boceto y cree el boceto de una línea.
6. Establezca el diámetro del círculo en "#diameter".
7. Establezca la longitud de la línea en "#length".

   El diámetro del círculo se establece en 1, y la longitud de la línea en 10.

8. Edite la variable #config y establezca el valor en 0.

El boceto se actualizará y el diámetro del círculo se establecerá en 0,25; mientras que la longitud de la línea en 2.

Esto se puede hacer con tantas matrices como desee, y las matrices pueden contener lugares infinitos (no están limitadas a solo tres valores, como se muestra en este ejemplo).

Puede usar funciones de FeatureScript en una variable siguiendo la sintaxis de FeatureScript.

Por ejemplo, puede crear una variable del tipo Any, denominada «Ajustar», para almacenar una función que duplique una longitud determinada y añada 2,5 mm de la siguiente manera:

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

y, luego, haga referencia a esa variable en una expresión, como en este caso:

#Adjust(20mm)

• Cuando cambia el valor de una variable (edítala como lo haría con cualquier operación), todas las operaciones que utilizan la variable se actualizan automáticamente.
• En los nombres de las variables, se distinguen las mayúsculas.
• Puedes introducir una variable como un valor independiente o como parte de una ecuación.
• Las variables se pueden utilizar en una cota, expresión u operación.

• En los casos en que especifique una variable sin unidad, las expresiones también serán sin unidad o asumirán la unidad del área de trabajo. Pero si agrega unidades explícitamente a un valor variable, entonces cualquier expresión también debe coincidir con esa unidad cuando se escribe para ser válida.

• When you change the name of a variable, you have the choice to propagate the change everywhere the variable is used:

  

  Seleccione Actualizar todas las referencias.

1. While in a Part Studio, select the Variable tool to open the Variable tool dialog box:

   

2. En el cuadro de diálogo, haga lo siguiente:
   1. Seleccione un tipo:
   • Longitud: es un valor numérico que representa una longitud (valor decimal, entero o fracción)
   • Ángulo: valor numérico que representa un ángulo (decimal, entero, fracción)
   • Número: valor numérico (decimal, entero, fracción)
   • Cualquiera: cualquiera de los anteriores; valor numérico con diferentes unidades o un valor de FeatureScript como booleano, mapa, matriz, cadena o función. Consulte https://cad.onshape.com/FsDoc/variables.html#standard-types y vea ejemplos a continuación.
   2. Escriba un nombre para la variable (con el que se hará referencia a ella).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   3. Introduzca un valor (y, si lo desea, unidades para Longitud, Ángulo y Cualquiera).
3. Toque la casilla de verificación.

La variable que ha creado aparecerá en la lista de operaciones, donde se figura el nombre y el valor de la variable.

1. While in a Part Studio, select the Variable tool to open the Variable tool dialog box, then click Measured:

   

2. En el cuadro de diálogo:
   1. Seleccione un tipo:
   • Distancia: es un valor numérico que representa una distancia (decimal, entero o fracción)
   • Longitud: valor numérico que representa una longitud (decimal, entero, fracción)
   • Diámetro: es un valor numérico que representa un ángulo (decimal, entero, fracción)

3. Escriba un nombre para la variable (con el que se hará referencia a ella).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   1. Seleccione las entidades entre las que desee medir.
   2. Complete los campos restantes según sus preferencias.
4. Toque la casilla de verificación.

La variable que ha creado aparecerá en la lista de operaciones, donde se figura el nombre y el valor de la variable.

The From table option in the Variable feature enables users to create a single variable that stores a subset of rows and columns from the CSV table. The Row options filter the rows and determine the Result type (Single value, Array, or Map) of the variable. The Column options then filter each row and determine the type of each entry in the final variable.

Android support for creating a Variable from a CSV file (From table) is limited to editing and viewing variables created on the desktop (browser) platform.

1. Tap to open the Variable dialog, then tap From table:

   

2. In the dialog:
   1. Enter a Name for the variable (and by which to reference it).

   Use only English alphanumeric characters and underscores (_) in the Name field. Variable names are case-sensitive and cannot start with a number.

   2. Under CSV file, tap the Select CSV file field to select and open an existing CSV file. It is loaded into the Select CSV file field.

      Fill out the Row and Column fields according to your requirements:

      • Access type - Select  By index, By index range, By label, or All values.
        • Index - If By index is selected, enter a single Index value.
        • Min/Max index - When By index range is selected, enter both the minimum and maximum index values.
        • Value - If By label is selected, enter the label's string value.
      • Regular expression - Check to pattern match a set of target strings.
      • Result type - Select Single value, Array, or Map.
        • Label column/row index - If the Result type is a Map, enter either a numerical index value or a variable.
   3. Toggle Conversion factor and enter a value with measurement units if you are converting from one measurement to another (for example, if the table uses inches, and you want these values converted to centimeters).
   4. Optionally, enter a Description to provide some details about the Variable or CSV file being used.
3. Tap the checkmark.

Cree una cota: en el campo de cota escriba # y el nombre de la variable (y, si lo desea, como parte de una expresión, como se muestra a continuación):

and

Guarde la cota; la variable se reemplaza con el valor y la expresión (si procede) se resuelve:

Al hacer doble clic en la cota para editarla, se muestra la variable (y la expresión):

Utilice variables en cualquier lugar donde utilice expresiones en Part Studio. Por ejemplo, en una operación de extrusión o revolución:

Inicie la operación como de costumbre (en este caso, Revolución). En el campo de valor numérico, escriba # y el nombre de la variable (o bien, como parte de una expresión). Por ejemplo: (#x) deg.

Acepte la operación.

Cuando edite la operación, la solución se mostrará en el campo de valor numérico. Por ejemplo: 4 deg.

Haga clic en el campo y se mostrará la variable (y la expresión, si procede).

Los valores de variables pueden contener expresiones, pero deben evaluarse en un valor escalar. Puede especificar una matriz con un índice, y el índice puede ser una variable. De esta forma, puede cambiar el valor de la variable mediante la modificación del valor de la variable del índice.

Para utilizar matrices en variables, primero debe establecer un índice basado en cero.

1. Pulse en la herramienta Variable y establezca el nombre en "config". Defina el valor de #config en 2.
2. Pulse en la herramienta Variable y escriba el nombre «diámetro». Establezca el valor de #diameter en [0,25; 0,5; 1] [#config].

Es importante que incluya el segundo conjunto de corchetes que contenga '#config'. Esto es lo que permite que el valor de la variable #config apunte al lugar correcto de la matriz.

3. Pulse en la herramienta Variable y establezca el nombre en "lenght". Defina el valor de #length en [2, 4, 10] [#config].

Es importante que incluya el segundo conjunto de corchetes que contenga '#config'. Esto es lo que permite que el valor de la variable #config apunte al lugar correcto de la matriz.

4. Pulse en la herramienta de boceto y cree un boceto de un círculo.
5. Pulse en la herramienta de boceto y cree el boceto de una línea.
6. Establezca el diámetro del círculo en "#diameter".
7. Establezca la longitud de la línea en "#length".

   El diámetro del círculo se establece en 1, y la longitud de la línea en 10.

8. Edite la variable #config y establezca el valor en 0.

El boceto se actualizará y el diámetro del círculo se establecerá en 0,25; mientras que la longitud de la línea en 2.

Esto se puede hacer con tantas matrices como desee, y las matrices pueden contener lugares infinitos (no están limitadas a solo tres valores, como se muestra en este ejemplo).

Puede usar funciones de FeatureScript en una variable siguiendo la sintaxis de FeatureScript.

Por ejemplo, puede crear una variable del tipo Any, denominada «Ajustar», para almacenar una función que duplique una longitud determinada y añada 2,5 mm de la siguiente manera:

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

y, luego, haga referencia a esa variable en una expresión, como en este caso:

#Adjust(20mm)

• Cuando cambia el valor de una variable (edítala como lo haría con cualquier operación), todas las operaciones que utilizan la variable se actualizan automáticamente.
• En los nombres de las variables, se distinguen las mayúsculas.
• Puedes introducir una variable como un valor independiente o como parte de una ecuación.
• Las variables se pueden utilizar en una cota, expresión u operación.