Std UnitsCalculator: Difference between revisions

From FreeCAD Documentation
m (typo)
mNo edit summary
 
(25 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>

<!--T:20-->
{{Docnav
|[[Std_DemoMode|DemoMode]]
|[[Std_DlgCustomize|DlgCustomize]]
|[[Std_Tools_Menu|Std Tools Menu]]
|IconL=Std_DemoMode.svg
|IconR=Std_DlgCustomize.svg
|IconC=Freecad.svg
}}

<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand
|Name=Std_UnitsCalculator
|Name=Std UnitsCalculator
|MenuLocation=Tools → Units calculator...
|MenuLocation=Tools → Units calculator...
|Workbenches=All
|Workbenches=All
|SeeAlso=[[Units]]
}}
}}

==Description== <!--T:3-->


<!--T:2-->
<!--T:2-->
The '''Std UnitsCalculator''' command opens the Units calculator dialog box. The Units calculator can be used to convert values from one unit system to another.
The units calculator dialog allows to calculate quantities to different units.


</translate>
== Description == <!--T:3-->
[[Image:Units_Calculator_it.png]]
<translate>
<!--T:21-->
{{Caption|The Units calculator dialog box}}


<!--T:4-->
==Usage== <!--T:16-->
[[File:Units_Calculator_it.png|none|frame|The units calculator dialog]]


<!--T:22-->
The first field defines a value and a corresponding unit. If you enter an unknown unit, you get a ''syntax error''. Units with exponents can be inserted in the form '''m^3'''. [[Expressions#Units|Here]] is a list of all known units.<br> In the second field you specify the resulting unit. If the unit type of the second filed does not match the unit type of the first field, you get a ''unit mismatch''. For example if you try to calculate "12 g" to "nm", because a mass cannot be expressed as a length.<br> The third field shows the result.
# Select the {{MenuCommand|Tools → [[Image:Std_UnitsCalculator.svg|16px]] Units calculator...}} option from the menu.
# The Units calculator dialog box opens. For more information see [[#Options|Options]].
# The dialog box is modeless, meaning it can stay open while you continue working in FreeCAD.
# Press the {{Button|Close}} button to close the dialog box.


<!--T:5-->
==Options== <!--T:17-->
Pressing return in field one or two will add the result of the calculation to the log area for later usage. The ''Copy'' button copies the result into the clipboard, so you can use it in another dialog of FreeCAD.


<!--T:6-->
===Top row=== <!--T:23-->
In the field ''Quantity'' you can input a value and select a unit type in the combobox behind. You will get as result the [https://en.wikipedia.org/wiki/International_System_of_Units#Base_units base unit] of the selected unit type. For example ''75'' and type ''Frequency'' results in ''75 Hz''.


<!--T:7-->
<!--T:24-->
# Enter a value with units in the first input box. For example {{Value|10 mm}}.
The dialog can stay open as long as you want and does not block the rest of FreeCAD
#* Units with exponents should be entered using the {{Value|^}} notation. For example {{Value|1 m^2}}.
#* If the input value cannot be recognized or if the units are unknown the '''=>''' box will display the 'syntax error' message.
# Enter the target units in the '''as''' input box. For example {{Value|in}}.
#* If the units are unknown the '''=>''' box will display the 'unknown unit' message.
#* If the units in the first and second input box do not match, the '''=>''' box will display the 'unit mismatch' message. In the example the units match as 'mm' and 'in' are both length units.
# If there are no input errors the '''=>''' box will immediately show the result. For the example values the result is {{Value|0,394 in}}.
# Optionally press the {{Button|Copy}} button to copy the content of the '''=>''' box to the clipboard. The value can then for example be pasted in a FreeCAD task panel or dialog box.

===Text area=== <!--T:25-->

<!--T:26-->
# The conversion performed in the top row can be copied to the text area by pressing {{KEY|Enter}} in the first or second input box.
# The text area can contain multiple conversions and its content can be selected and copied to the clipboard with {{KEY|Ctrl+C}} and used in other programs.

===Quantity=== <!--T:27-->

<!--T:28-->
{{Emphasis|This new part ({{Version|0.19}}) of the Units calculator still suffers from some bugs.}}

<!--T:29-->
# Select an option from the '''Unit system''' dropdown list. This will be the target unit system. Select '''Preference system''' to use the unit system defined in the [[Preferences_Editor#Units|Preferences]].
# Select an option from the '''Unit category''' dropdown list.
# Enter a value with units in the '''Quantity''' input box. The units must match the unit category.
#* If the '''Area''' unit category has been selected, entering certain units is problematic. For example to enter {{Value|m^2}} you have to first enter {{Value|^2}}, put the cursor before the {{Value|^}} character and then enter {{Value|m}}.
# Click in the '''Decimals''' input box and press {{KEY|Enter}} to convert the value in the '''Quantity''' input box.

==Notes== <!--T:30-->

<!--T:31-->
* See the [[Expressions#Units|Expressions]] page for a list of all known units.


<!--T:32-->
{{Docnav
|[[Std_DemoMode|DemoMode]]
|[[Std_DlgCustomize|DlgCustomize]]
|[[Std_Tools_Menu|Std Tools Menu]]
|IconL=Std_DemoMode.svg
|IconR=Std_DlgCustomize.svg
|IconC=Freecad.svg
}}


<!--T:8-->
{{Std Base}}
{{Userdocnavi}}
{{clear}}
</translate>
</translate>
{{Std Base navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 15:49, 29 December 2020

Std UnitsCalculator

Menu location
Tools → Units calculator...
Workbenches
All
Default shortcut
None
Introduced in version
-
See also
None

Description

The Std UnitsCalculator command opens the Units calculator dialog box. The Units calculator can be used to convert values from one unit system to another.

The Units calculator dialog box

Usage

  1. Select the Tools → Units calculator... option from the menu.
  2. The Units calculator dialog box opens. For more information see Options.
  3. The dialog box is modeless, meaning it can stay open while you continue working in FreeCAD.
  4. Press the Close button to close the dialog box.

Options

Top row

  1. Enter a value with units in the first input box. For example 10 mm.
    • Units with exponents should be entered using the ^ notation. For example 1 m^2.
    • If the input value cannot be recognized or if the units are unknown the => box will display the 'syntax error' message.
  2. Enter the target units in the as input box. For example in.
    • If the units are unknown the => box will display the 'unknown unit' message.
    • If the units in the first and second input box do not match, the => box will display the 'unit mismatch' message. In the example the units match as 'mm' and 'in' are both length units.
  3. If there are no input errors the => box will immediately show the result. For the example values the result is 0,394 in.
  4. Optionally press the Copy button to copy the content of the => box to the clipboard. The value can then for example be pasted in a FreeCAD task panel or dialog box.

Text area

  1. The conversion performed in the top row can be copied to the text area by pressing Enter in the first or second input box.
  2. The text area can contain multiple conversions and its content can be selected and copied to the clipboard with Ctrl+C and used in other programs.

Quantity

This new part (introduced in version 0.19) of the Units calculator still suffers from some bugs.

  1. Select an option from the Unit system dropdown list. This will be the target unit system. Select Preference system to use the unit system defined in the Preferences.
  2. Select an option from the Unit category dropdown list.
  3. Enter a value with units in the Quantity input box. The units must match the unit category.
    • If the Area unit category has been selected, entering certain units is problematic. For example to enter m^2 you have to first enter ^2, put the cursor before the ^ character and then enter m.
  4. Click in the Decimals input box and press Enter to convert the value in the Quantity input box.

Notes

  • See the Expressions page for a list of all known units.