Variabile

1. In un Part Studio fai clic su per aprire la finestra di dialogo Variabile.

   

2. Nella finestra di dialogo:

   1. Immetti un nome per la variabile (da usare per farvi riferimento).

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

   2. Seleziona un tipo:
      • Lunghezza - Un valore numerico (decimale, intero, frazionario) che rappresenta una lunghezza
      • Angolo - Un valore numerico che rappresenta un angolo (decimale, intero, frazionario)
      • Numero - Un valore numerico (decimale, intero, frazionario)
      • Qualsiasi: uno qualsiasi dei precedenti, un valore numerico con unità diverse o un valore FeatureScript come booleano, mappa, matrice, stringa o una funzione. Vedi https://cad.onshape.com/FsDoc/variables.html#standard-types e gli esempi di seguito.
   3. Immetti un valore (e se lo desideri anche le unità per Lunghezza, Angolo e Qualsiasi).
   4. Inserisci una descrizione personalizzata per la tua variabile.
3. Fai clic su .

1. In un Part Studio fai clic su per aprire la finestra di dialogo Variabile, quindi seleziona Misurazione effettuata:

   

2. Nella finestra di dialogo:
   1. Seleziona un tipo:
      • Distanza: un valore numerico che rappresenta una distanza (decimale, intero, frazione)
      • Lunghezza - Un valore numerico (decimale, intero, frazionario) che rappresenta una lunghezza
      • Diametro: un valore numerico che rappresenta un diametro (decimale, intero, frazione)

   2. Immetti un nome per la variabile (da usare per farvi riferimento).

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

   3. Seleziona le entità tra cui misurare.
   4. Compila i campi rimanenti in base alle tue preferenze.
3. Fai clic su .

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. Nella finestra di dialogo:
   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. Fai clic su .

Esempi

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:

  

Note

• 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):

  

Crea una dimensione, nel campo dimensione immetti # e il nome della variabile (e facoltativamente, come parte di un' espressione, come mostrato di seguito):

e

Salva la dimensione; la variabile viene sostituita con il valore e l'espressione (se applicabile) è risolta:

Quando fai doppio clic sulla quota per la modifica, viene visualizzata la variabile (e l'espressione):

Se per una quota dello schizzo è utilizzata un'espressione senza variabile, questo è indicato tamite l'icona Espressione senza variabile () a sinistra del valore della dimensione. Se per una quota dello schizzo è utilizzata un'espressione con una variabile, è indicata con l'icona Espressione con variabile () a sinistra del valore della dimensione. Vedi Visualizzare espressioni in uno schizzo.

Utilizza variabili ovunque utilizzi espressioni in un Part Studio. Ad esempio, in un'operazione di estrusione o rivoluzione.

Avvia l'operazione nel modo consueto (in questo caso, Rivoluzione); nel campo del valore numerico, immetti # e il nome della variabile (o se necessario come parte di un'espressione):

Accetta la funzione.

Quando modifichi la funzione, la soluzione viene visualizzata nel campo del valore numerico:

Fai clic sul campo per visualizzare la variabile (e l'espressione, se applicabile).

Funzione di riempimento automatico variabile

Una volta definite le variabili, l'inserimento di un hashtag (o un simbolo di cancelletto, un carattere di sottolineatura o qualsiasi lettera) in un campo numerico della finestra di dialogo consente di aprire la funzione di riempimento automatico variabile come mostrato di seguito:

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

Puoi continuare a digitare per filtrare l'elenco in base a opzioni appropriate, utilizzare i tasti freccia per spostarti su e giù nell'elenco e utilizzare il tasto Invio per accettare una variabile dall'elenco quando è evidenziata. È inoltre possibile utilizzare la rotellina del mouse per scorrere l'elenco delle variabili e un clic del mouse per selezionare una variabile particolare. Nota che le funzioni FeatureScript sono incluse nell'elenco anche quando non è utilizzato il simbolo cancelletto:

Nota anche quanto segue:

• Il tasto Esc consente di chiudere il menu a discesa senza selezionare nulla. Anche la rimozione dello stato attivo dal menu a discesa consente di chiuderlo senza selezionare nulla.
• I valori di calcolo sono visualizzati in grigio chiaro e non verranno inseriti (vengono inseriti solo la variabile o il nome della funzione). Lo stesso vale per gli inserimenti delle funzioni, perché i nomi dei segnaposto di inserimento non vengono inseriti.
• Vengono mostrate solo le variabili esistenti nel contesto corrente; le variabili più in basso nell'elenco funzioni non vengono visualizzate

I valori delle variabili possono contenere espressioni. È possibile specificare un array con un indice e l'indice può essere una variabile. Ciò consente di modificare il valore della variabile modificando il valore della variabile indice.

Per utilizzare le matrici nelle variabili, è necessario innanzitutto impostare un indice a base zero.

1. Crea una variabile e imposta il nome su 'config'. Seleziona Numero come tipo e imposta il valore di #config su '2'.
2. Crea una variabile e imposta il nome su 'diameter'. Imposta il valore di #diameter su '[0.25, 0.5, 1] [#config]'.

È il secondo set di parentesi [#config] che funge da puntatore indice nella matrice.

3. Crea una variabile e imposta il nome su 'length'. Imposta il valore di #length su '[2, 4, 10] [#config]'.

4. Crea un cerchio.
5. Crea una linea.
6. Imposta il diametro del cerchio su '#diameter'.

   Poiché #config = 2, il diametro del cerchio è 1.

7. Imposta la lunghezza della linea su '#length'.

   Poiché #config = 2, la lunghezza della linea è 10.

Modifica il valore della variabile indice per modificare gli indici di tutte le variabili di matrice.

È possibile creare variabili in base alle necessità, quando si inserisce un valore numerico in un campo di una finestra di dialogo funzioni, ad esempio. La variabile viene salvata prima dall'operazione corrente nell'elenco funzioni.

Ad esempio, quando si crea uno schizzo, quando viene visualizzato il campo Dimensione, invece di inserire un valore per la dimensione, è possibile digitare il simbolo cancelletto # e viene visualizzato l'elenco delle variabili esistenti, insieme a un'opzione per una nuova variabile:

Seleziona Nuova variabile per aprire la finestra di dialogo Variabile e creare una nuova variabile e utilizzarla nel campo corrente (altrimenti, seleziona una delle variabili esistenti, se disponibili).

La finestra di dialogo Crea variabile offre la possibilità di creare una variabile per una funzione (predefinita) o una configurazione.

Inserisci un nome per la nuova variabile e un valore. Fai clic sul segno di spunta per salvare la nuova variabile e utilizzarla nella funzione aperta.

Puoi utilizzare le funzioni di FeatureScript in una variabile, seguendo la sintassi di FeatureScript.

Ad esempio, puoi creare una variabile di tipo Any, denominata «Regola», per memorizzare una funzione che raddoppia una determinata lunghezza e aggiunge 2,5 mm, come segue:

funzione(len) {return len * 2 + 2,5 mm;}

e quindi fai riferimento a quella variabile in un'espressione, come:

#Adjust(20 mm)

• Quando cambi il valore di una variabile (modificala come faresti con qualsiasi altra funzione), tutte le operazioni che utilizzano la variabile vengono aggiornate automaticamente.
• Quando modifichi il nome di una variabile, puoi scegliere di propagare la modifica ovunque venga utilizzata la variabile:

  

  Seleziona la casella accanto a Aggiorna tutti i riferimenti.

1. In un Part Studio, seleziona l'icona dello strumento Variabile () per aprire la relativa finestra di dialogo:

   

2. Nella finestra di dialogo:
   1. Seleziona un tipo:
   • Lunghezza - Un valore numerico che rappresenta una lunghezza  (decimale, numero intero, frazione)
   • Angolo - Un valore numerico che rappresenta un angolo (decimale, intero, frazionario)
   • Numero - Un valore numerico (decimale, intero, frazionario)
   • Qualsiasi: uno qualsiasi dei precedenti, un valore numerico con unità diverse o un valore FeatureScript come booleano, mappa, matrice, stringa o una funzione. Vedi https://cad.onshape.com/FsDoc/variables.html#standard-types e gli esempi di seguito.
   2. Immetti un nome per la variabile (da usare per farvi riferimento).

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

   3. Immetti un valore (e se lo desideri anche le unità per Lunghezza, Angolo e Qualsiasi).
3. Tocca il segno di spunta.

La variabile creata è elencata nell'elenco funzioni e mostra il nome e il valore della variabile.

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

   

2. Nella finestra di dialogo:
   1. Seleziona un tipo:
   • Distanza: un valore numerico che rappresenta una distanza (decimale, intero, frazione)
   • Lunghezza - Un valore numerico (decimale, intero, frazionario) che rappresenta una lunghezza
   • Diametro: un valore numerico che rappresenta un angolo (decimale, intero, frazione)

3. Immetti un nome per la variabile (da usare per farvi riferimento).

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

   1. Seleziona le entità tra cui misurare.
   2. Compila i campi rimanenti in base alle tue preferenze.
4. Tocca il segno di spunta.

La variabile creata è elencata nell'elenco funzioni e mostra il nome e il valore della variabile.

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. Nella finestra di dialogo:
   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. Tocca il segno di spunta.

Crea una dimensione, nel campo dimensione immetti # e il nome della variabile (e facoltativamente, come parte di un' espressione, come mostrato di seguito):

e

Salva la dimensione; la variabile viene sostituita con il valore e l'espressione (se applicabile) è risolta:

Quando fai doppio clic sulla quota per la modifica, viene visualizzata la variabile (e l'espressione):

Utilizza variabili ovunque utilizzi espressioni in un Part Studio, ad esempio in un'operazione di estrusione o rivoluzione

Avvia l'operazione come al solito (in questo caso, Rotazione); nel campo del valore numerico, Inserisci # e il nome della variabile (o facoltativamente, come parte di un'espressione). Ad esempio: (#x) deg.

Accetta la funzione.

Quando modifichi la funzione, la soluzione viene mostrata nel campo del valore numerico. Ad esempio: 4 deg.

Fai clic sul campo per visualizzare la variabile (e l'espressione, se applicabile).

I valori delle variabili possono contenere espressioni ma devono essere restituiti in base a un valore scalare. È possibile specificare un array con un indice e l'indice può essere una variabile. Ciò consente di modificare il valore della variabile modificando il valore della variabile indice.

Per utilizzare le matrici nelle variabili devi innanzitutto impostare un indice a base zero.

1. Tocca lo strumento Variabile e imposta il nome su "config". Imposta il valore di #config su 2.
2. Tocca lo strumento Variabile e imposta il nome su "diameter". Imposta il valore di #diameter su [0,25, 0,5, 1] [#config].

È importante includere il secondo set di parentesi che contiene "#config". Questo è ciò che consente al valore della variabile #config di puntare alla posizione corretta nell'array.

3. Tocca lo strumento Variabile e imposta il nome su "length". Imposta il valore di #length su [2, 4, 10] [#config].

È importante includere il secondo set di parentesi che contiene "#config". Questo è ciò che consente al valore della variabile #config di puntare alla posizione corretta nell'array.

4. Tocca lo strumento schizzo e fai lo schizzo di un cerchio.
5. Tocca lo strumento schizzo e traccia una linea di schizzo.
6. Imposta il diametro del cerchio su "#diameter".
7. Imposta la lunghezza della linea su "#length".

   Il diametro del cerchio è impostato su 1 e la lunghezza della linea è impostata su 10.

8. Modifica la variabile #config, imposta il valore su 0.

Lo schizzo si aggiorna e il diametro del cerchio è ora impostato su 0,25 e la lunghezza della linea è impostata su 2.

Puoi farlo per tutti gli array che desideri e i tuoi array possono contenere un numero infinito di valori (non sono limitati a soli tre valori come mostra questo esempio).

Puoi utilizzare le funzioni di FeatureScript in una variabile, seguendo la sintassi di FeatureScript.

Ad esempio, puoi creare una variabile di tipo Any, denominata «Regola», per memorizzare una funzione che raddoppia una determinata lunghezza e aggiunge 2,5 mm, come segue:

funzione(len) {return len * 2 + 2,5 mm;}

e quindi fai riferimento a quella variabile in un'espressione, come:

#Adjust(20 mm)

• Quando cambi il valore di una variabile (modificala come faresti con qualsiasi altra funzione), tutte le operazioni che utilizzano la variabile vengono aggiornate automaticamente.
• I nomi delle variabili hanno distinzione tra maiuscole e minuscole
• È possibile inserire una variabile come valore autonomo o come parte di un'equazione.
• È possibile utilizzare una variabile in una dimensione, un'espressione o una funzione.

• Nei casi in cui specifichi una variabile senza unità, anche le espressioni saranno prive di unità o utilizzeranno l'unità dell'area di lavoro. Tuttavia, se aggiungi esplicitamente unità a un valore variabile, qualsiasi espressione dovrebbe anche corrispondere a quella unità quando viene scritta per essere valida.

• Quando modifichi il nome di una variabile, puoi scegliere di propagare la modifica ovunque venga utilizzata la variabile:

  

  Seleziona Aggiorna tutti i riferimenti.

1. In un Part Studio, seleziona Strumento variabili per aprire la relativa finestra di dialogo:

   

2. Nella finestra di dialogo:
   1. Seleziona un tipo:
   • Lunghezza - Un valore numerico che rappresenta una lunghezza  (decimale, numero intero, frazione)
   • Angolo - Un valore numerico che rappresenta un angolo (decimale, intero, frazionario)
   • Numero - Un valore numerico (decimale, intero, frazionario)
   • Qualsiasi: uno qualsiasi dei precedenti, un valore numerico con unità diverse o un valore FeatureScript come booleano, mappa, matrice, stringa o una funzione. Vedi https://cad.onshape.com/FsDoc/variables.html#standard-types e gli esempi di seguito.
   2. Immetti un nome per la variabile (da usare per farvi riferimento).

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

   3. Immetti un valore (e se lo desideri anche le unità per Lunghezza, Angolo e Qualsiasi).
3. Tocca il segno di spunta.

La variabile creata è elencata nell'elenco funzioni e mostra il nome e il valore della variabile.

1. In un Part Studio, seleziona Strumento variabili per aprire la relativa finestra di dialogo, quindi fai clic su Misurata:

   

2. Nella finestra di dialogo:
   1. Seleziona un tipo:
   • Distanza: un valore numerico che rappresenta una distanza (decimale, intero, frazione)
   • Lunghezza - Un valore numerico (decimale, intero, frazionario) che rappresenta una lunghezza
   • Diametro: un valore numerico che rappresenta un angolo (decimale, intero, frazione)

3. Immetti un nome per la variabile (da usare per farvi riferimento).

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

   1. Seleziona le entità tra cui misurare.
   2. Compila i campi rimanenti in base alle tue preferenze.
4. Tocca il segno di spunta.

La variabile creata è elencata nell'elenco funzioni e mostra il nome e il valore della variabile.

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. Nella finestra di dialogo:
   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. Tocca il segno di spunta.

Crea una dimensione, nel campo dimensione immetti # e il nome della variabile (e facoltativamente, come parte di un' espressione, come mostrato di seguito):

e

Salva la dimensione; la variabile viene sostituita con il valore e l'espressione (se applicabile) è risolta:

Quando fai doppio clic sulla quota per la modifica, viene visualizzata la variabile (e l'espressione):

Utilizza variabili ovunque utilizzi espressioni in un Part Studio, ad esempio in un'operazione di estrusione o rivoluzione

Avvia l'operazione come al solito (in questo caso, Rotazione); nel campo del valore numerico, Inserisci # e il nome della variabile (o facoltativamente, come parte di un'espressione). Ad esempio: (#x) deg.

Accetta la funzione.

Quando modifichi la funzione, la soluzione viene mostrata nel campo del valore numerico. Ad esempio: 4 deg.

Fai clic sul campo per visualizzare la variabile (e l'espressione, se applicabile).

I valori delle variabili possono contenere espressioni ma devono essere restituiti in base a un valore scalare. È possibile specificare un array con un indice e l'indice può essere una variabile. Ciò consente di modificare il valore della variabile modificando il valore della variabile indice.

Per utilizzare le matrici nelle variabili devi innanzitutto impostare un indice a base zero.

1. Tocca lo strumento Variabile e imposta il nome su "config". Imposta il valore di #config su 2.
2. Tocca lo strumento Variabile e imposta il nome su "diameter". Imposta il valore di #diameter su [0,25, 0,5, 1] [#config].

È importante includere il secondo set di parentesi che contiene "#config". Questo è ciò che consente al valore della variabile #config di puntare alla posizione corretta nell'array.

3. Tocca lo strumento Variabile e imposta il nome su "length". Imposta il valore di #length su [2, 4, 10] [#config].

È importante includere il secondo set di parentesi che contiene "#config". Questo è ciò che consente al valore della variabile #config di puntare alla posizione corretta nell'array.

4. Tocca lo strumento schizzo e fai lo schizzo di un cerchio.
5. Tocca lo strumento schizzo e traccia una linea di schizzo.
6. Imposta il diametro del cerchio su "#diameter".
7. Imposta la lunghezza della linea su "#length".

   Il diametro del cerchio è impostato su 1 e la lunghezza della linea è impostata su 10.

8. Modifica la variabile #config, imposta il valore su 0.

Lo schizzo si aggiorna e il diametro del cerchio è ora impostato su 0,25 e la lunghezza della linea è impostata su 2.

Puoi farlo per tutti gli array che desideri e i tuoi array sono in grado di contenere un numero infinito di valori (non sono limitati a soli tre valori come mostra questo esempio).

Puoi utilizzare le funzioni di FeatureScript in una variabile, seguendo la sintassi di FeatureScript.

Ad esempio, puoi creare una variabile di tipo Any, denominata «Regola», per memorizzare una funzione che raddoppia una determinata lunghezza e aggiunge 2,5 mm, come segue:

funzione(len) {return len * 2 + 2,5 mm;}

e quindi fai riferimento a quella variabile in un'espressione, come:

#Adjust(20 mm)

• Quando cambi il valore di una variabile (modificala come faresti con qualsiasi altra funzione), tutte le operazioni che utilizzano la variabile vengono aggiornate automaticamente.
• I nomi delle variabili hanno distinzione tra maiuscole e minuscole
• È possibile inserire una variabile come valore autonomo o come parte di un'equazione.
• È possibile utilizzare una variabile in una dimensione, un'espressione o una funzione.