Std UnitsCalculator: Difference between revisions
Renatorivo (talk | contribs) No edit summary |
(Revised. 'In progress' for now.) |
||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
{{UnfinishedDocu{{#translation:}}}} |
|||
{{Page in progress}} |
|||
<translate> |
<translate> |
||
{{Docnav |
|||
|[[Std_DemoMode|Std DemoMode]] |
|||
|[[Std_DlgCustomize|Std DlgCustomize]] |
|||
|[[Std_Tools_Menu|Std Tools Menu]] |
|||
|IconL= |
|||
|IconR=Std_DlgCustomize.svg |
|||
|IconC=Freecad.svg |
|||
}} |
|||
<!--T:1--> |
<!--T:1--> |
||
{{GuiCommand |
{{GuiCommand |
||
|Name= |
|Name=Std UnitsCalculator |
||
|MenuLocation= |
|MenuLocation=Tools → Units calculator... |
||
|Workbenches=All |
|Workbenches=All |
||
|SeeAlso=[[Units]] |
|||
}} |
}} |
||
== |
==Description== <!--T:3--> |
||
<!--T:2--> |
<!--T:2--> |
||
The |
The '''Std UnitsCalculator''' command opens the Units calculator dialog box. The Units calculator can be used to convert values from one units system to another. |
||
</translate> |
|||
<!--T:4--> |
|||
[[ |
[[Image:Units_Calculator_it.png]] |
||
<translate> |
|||
{{Caption|The Units calculator dialog box}} |
|||
==Usage== <!--T:16--> |
==Usage== <!--T:16--> |
||
# Select the {{MenuCommand|Tools → [[Image:Std_UnitsCalculator.svg|16px]] Units calculator...}} option from the menu. |
|||
# The Units calculator dialog box pops up. |
|||
# 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. |
|||
==Options== <!--T:17--> |
==Options== <!--T:17--> |
||
===Top row=== |
|||
<!--T:10--> |
|||
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'''. See the [[Expressions#Units]] page for a list of all known units. |
|||
# Enter a value with units in the first input box. For example {{incode|10 mm}}. |
|||
<!--T:11--> |
|||
#* Units with exponents should be entered using the {{incode|^}} notation. For example {{incode|1 m^2}}. |
|||
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. |
|||
#* If the input value cannot be recognized or the units are unknown the '''=>''' box will display the 'syntax error' message. |
|||
# Enter the target units in the second input box. For example {{incode|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 {{incode|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:18--> |
|||
The third field shows the result. |
|||
# 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. |
|||
<!--T:5--> |
|||
# 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. |
|||
Pressing return in field one or two will add the result of the calculation to the log area for later usage. The {{Button|Copy}} button copies the result into the clipboard, so you can use it in another dialog of FreeCAD. |
|||
===Quantity=== |
|||
<!--T:6--> |
|||
In the field ''Quantity'' you can set a value. Its unit will be the [https://en.wikipedia.org/wiki/International_System_of_Units#Derived_units base unit] of the selected ''Unit category''. For example a value ''75'' and the unit category "Frequency" results in "75.00 Hz". The number of decimals for the ''Quantity'' can be set in the ''Decimals'' field. In the combo box ''Unit system'' you can select a unit system. The ''Preference system'' is the unit system set in the [[Preferences_Editor#Units|general preferences]]. For example "75.00 Pa" with the "Standard" system results to "0.011 psi" with the "Imperial decimal" system. |
|||
{{Emphasis|This new part of the Units calculator still suffers from some bugs.}} {{Version|0.19}} |
|||
<!--T:7--> |
|||
The dialog can stay open as long as you want and does not block the rest of FreeCAD |
|||
# 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 {{incode|m^2}} you have to first enter {{incode|^2}}, put the cursor before the {{incode|^}} character and then enter {{incode|m}}. |
|||
# Click in the '''Decimals''' input box and press {{KEY|Enter}} to convert the value in the '''Quantity''' input box. |
|||
# Changing the value in the '''Decimals''' input box has no effect. The number of decimals defined in the [[Preferences_Editor#Units|Preferences]] is always used instead. |
|||
==Notes== |
|||
* See the [[Expressions#Units|Expressions]] page for a list of all known units. |
|||
{{Docnav |
|||
|[[Std_DemoMode|Std DemoMode]] |
|||
|[[Std_DlgCustomize|Std DlgCustomize]] |
|||
|[[Std_Tools_Menu|Std Tools Menu]] |
|||
|IconL= |
|||
|IconR=Std_DlgCustomize.svg |
|||
|IconC=Freecad.svg |
|||
}} |
|||
</translate> |
</translate> |
Revision as of 11:00, 22 April 2020
This documentation is a work in progress. Please don't mark it as translatable since it will change in the next hours and days.
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 units system to another.
The Units calculator dialog box
Usage
- Select the Tools → Units calculator... option from the menu.
- The Units calculator dialog box pops up.
- For more information see Options.
- The dialog box is modeless, meaning it can stay open while you continue working in FreeCAD.
- Press the Close button to close the dialog box.
Options
Top row
- Enter a value with units in the first input box. For example
10 mm
.- Units with exponents should be entered using the
^
notation. For example1 m^2
. - If the input value cannot be recognized or the units are unknown the => box will display the 'syntax error' message.
- Units with exponents should be entered using the
- Enter the target units in the second 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.
- If there are no input errors the => box will immediately show the result. For the example values the result is
0,394 in
. - 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
- The conversion performed in the top row can be copied to the text area by pressing 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 Ctrl+C and used in other programs.
Quantity
This new part of the Units calculator still suffers from some bugs. introduced in version 0.19
- 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.
- 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
m^2
you have to first enter^2
, put the cursor before the^
character and then enterm
.
- If the 'Area' unit category has been selected entering certain units is problematic. For example to enter
- Click in the Decimals input box and press Enter to convert the value in the Quantity input box.
- Changing the value in the Decimals input box has no effect. The number of decimals defined in the Preferences is always used instead.
Notes
- See the Expressions page for a list of all known units.
Std Base
- File: New, Open, Close, Close All, Save, Save As, Save a Copy, Save All, Revert, Import, Export,Merge project, Project information, Print, Print preview, Export PDF, Recent files, Exit
- Edit: Undo, Redo, Cut, Copy, Paste, Duplicate selection, Refresh, Box selection, Box element selection, Select All, Delete, Send to Python Console, Placement, Transform, Alignment, Toggle Edit mode, Edit mode, Preferences
- View:
- Miscellaneous: Create new view, Orthographic view, Perspective view, Fullscreen, Bounding box, Toggle axis cross, Clipping plane, Texture mapping, Toggle navigation/Edit mode, Appearance, Random color, Workbench, Status bar
- Standard views: Fit all, Fit selection, Isometric, Dimetric, Trimetric, Home, Front, Top, Right, Rear, Bottom, Left, Rotate Left, Rotate Right
- Freeze display: Save views, Load views, Freeze view, Clear views
- Draw style: As is, Points, Wireframe, Hidden line, No shading, Shaded, Flat lines
- Stereo: Stereo red/cyan, Stereo quad buffer, Stereo Interleaved Rows, Stereo Interleaved Columns, Stereo Off, Issue camera position
- Zoom: Zoom In, Zoom Out, Box zoom
- Document window: Docked, Undocked, Fullscreen
- Visibility: Toggle visibility, Show selection, Hide selection, Select visible objects, Toggle all objects, Show all objects, Hide all objects, Toggle selectability, Toggle measurement, Clear measurement
- Toolbars: File, Edit, Clipboard, Workbench, Macro, View, Structure, Help
- Panels: Tree view, Property view, Selection view, Tasks, Python console, DAG view, Model, Report view
- Link navigation: Go to linked object, Go to the deepest linked object, Select all links
- Tree view actions: Sync view, Sync selection, Sync placement, Pre-selection, Record selection, Single document, Multi document, Collapse/Expand, Initiate dragging, Go to selection, Selection Back, Selection Forward
- Tools: Edit parameters, Save image, Load image, Scene inspector, Dependency graph, Project utility, Measure distance, Add text document, View turntable, Units calculator, Customize, Addon manager
- Macro: Macro recording, Macros, Recent macros, Execute macro, Attach to remote debugger, Debug macro, Stop debugging, Step over, Step into, Toggle breakpoint
- Help: Help, FreeCAD Website, Donate, Users documentation, Python scripting documentation, Automatic Python modules documentation, FreeCAD Forum, FreeCAD FAQ, Report a bug, About FreeCAD, What's This
User documentation
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
- Hubs: User hub, Power users hub, Developer hub