Units

SMath Studio can handle units; there's a large list of [Built In Units|built-in units] available for the most common applications that could be easily extended by the user.

{| Cellpadding="0" Cellspacing="0"
|-
| Units are represented with an
| style="color: blue; font-style:italic;" | &#160;italic blue-colored font
| .
|}

{{{{[image|unit example|{UP}units%2funits_wiki_01.png]}}}}

((('''Index'''
* [#InsertUnits|Insert units]
* [#CustomUnits|Custom units]
* [#UnitsLanguage|Units language]
* [#UnitsDescription|Units description]
* [#KnownIssues|Known issues]
* [#History|History]
* [#SeeAlso|See also]
* [#References|References])))


{BR}[anchor|#InsertUnits]
==Insert a unit==

To insert a unit, press the apostrophe ('''&#39;''') and then digit the unit name; the placeholder shape will change and the dynamic assistance box can help you showing the built-in units (mouse pointer '''double-click''' or press the '''TAB''' key to insert the selected unit in the formula).

{{{{[image|insert unit|{UP}units%2funits_wiki_02.gif]}}}}

{BR}Alternatively you can add a built-in unit by the units window ('''CTRL+W''' or menu "'''Insert'''" > "'''Unit...'''"), where you can easily find the unit by name or by family.

{{{{[image|units window|{UP}units%2funits_wiki_03.png]}}}}

{BR}Evaluating an expression that contain units, the output will be delivered with the default units (SI base units); to change the output unit, write your favorite unit in the right placeholder.

{{{{[image|output unit|{UP}units%2funits_wiki_04.gif]}}}}

{BR}'''NOTE:''' the multiplication sign for units is hidden by default, so units like ''kN*''m are shown ''kN m''; to avoid errors the right way to type the unit is '''''&#39;kN*&#39;m''''', __not__ '''''&#39;kNm'''''.


{BR}[anchor|#CustomUnits]
==Custom units==

You may define/override an unit inside the sheet (simplest way) or handling the '' [http://en.smath.info/forum/yaf_postsm5881_Pagesize.aspx#post5881|Units.xml]'' file ([http://en.smath.info/forum/default.aspx?g=posts&m=13259|update]).

{{{{[image|units define|{UP}units%2funits_wiki_05.png]}}}}


{BR}[anchor|#UnitsLanguage]
==Units language==
{| cellspacing="0" cellpadding="8" border="0" style="text-align: center; width: 100%; background-color: #ecffec;"
|-
| style="color: green; font-weight: bold; font-style: italic; font-size: 11px;" | if you have not yet implemented localized units in your country leave a comment here: [http://en.smath.info/forum/yaf_postsm5844_Real-support-of-localization-differences.aspx#post5844|localization differences]
|}

From the menu "'''Tools'''" > "'''Options...'''" you can change the units language.

{{{{[image|units language|{UP}units%2funits_wiki_06.png]}}}}

{BR}The unit localization changes the way in which is written the unit of measurement.

{{{{[image|units localization|{UP}units%2funits_wiki_06_B.png]}}}}


{BR}[anchor|#UnitsDescription]
==Units description==

Both built-in and custom unit description can be retrieved as a string using the [description|description()] function; description's language depends on [Multilanguage support|Interface language].

{{{{[image|units language|{UP}units%2funits_wiki_07.png]}}}}


{BR}[anchor|#KnownIssues]
==Known issues==
{| cellspacing="0" cellpadding="8" border="0" style="text-align: center; width: 100%; background-color: #ecffec;"
|-
| style="color: green; font-weight: bold; font-style: italic; font-size: 11px;" | to  inform the developers about issues you found out use the forum: [http://en.smath.info/forum/yaf_topics15_Bugs-and-Problems.aspx|bugs&problems]
|}

Not all built-in functions work with units; to work with these functions divide the argument for the expected unit and multiply the result by the same unit.

{{{{[image|built-in functions|{UP}units%2funits_wiki_08.png]}}}}

{BR}The 0 value has no units. If you want a unit as output even when the result can be null, set the unit in the right placeholder.

{{{{[image|null output|{UP}units%2funits_wiki_09.png]}}}}

{BR}Be careful in handling [http://en.smath.info/forum/yaf_postsm13234_Help-converting-thermal-units.aspx#post13234|relative and absolute temperature units]; there's an open discussion [http://en.smath.info/forum/yaf_postst1526_Temperature-units-handling.aspx|here]. ''THIS IS SOLVED IN NIGHTLY BUILDS, SEE [http://en.smath.info/forum/default.aspx?g=posts&m=13396|SMath 0.97.5301] or later''

{{{{[image|null output|{UP}units%2funits_wiki_10.png]}}}}

{BR}[anchor|#History]
==History==

* SMath [http://en.smath.info/forum/default.aspx?g=posts&m=1951|0.87.3719] (Beta): first relase
* SMath [http://en.smath.info/forum/default.aspx?g=posts&m=2247|0.88] (Stable): first stable relase
* SMath [http://en.smath.info/forum/default.aspx?g=posts&m=5857|0.90] (Stable): translatable units implemented
* SMath [http://en.smath.info/forum/default.aspx?g=posts&m=13245|0.97.5280] (Nightly build): Units.xml changes
* SMath [http://en.smath.info/forum/default.aspx?g=posts&m=13396|0.97.5301] (Nightly build): Change units &Delta;C, &Delta;F and &Delta;Re added to package


{BR}[anchor|#SeeAlso]
==See also==

* [Built In Units|Built-in Units]
* [Keyboard shortcuts|Keyboard shortcuts]
* [description|description()]


{BR}[anchor|#References]
==References==

* Introduction to SMath Studio 0.88 - page 15, [{UP}Tutorials/IntroductionSMathStudio088May2010.pdf|PDF]
* Video examples of calculations with units for hydraulics (G.Urroz) - [http://www.neng.usu.edu/cee/faculty/gurro/Classes/ClassNotesAllClasses/CEE3510/LabFiles/CL01_ComputationalTools01.htm |See Part 2 SMath Studio]
* Crib Sheet for SMath Studio 0.95 - [{UP}forum_attach/TheWizEd/SMathLib_095.pdf|PDF]
* Crib Sheet for SMath Studio 0.90 - [{UP}forum_attach/TheWizEd/SMathLib_090.pdf|PDF]
* Crib Sheet for SMath Studio 0.89 - [{UP}forum_attach/TheWizEd/SMathLib_089.pdf|PDF]
* Crib Sheet for SMath Studio 0.88 - [{UP}forum_attach/TheWizEd/SMathLib.pdf|PDF]
* Custom units examples - [http://en.smath.info/?file=739161|sm]
* Unit.xml editing - [http://en.smath.info/forum/yaf_postsm5881_Pagesize.aspx#post5881|SMath forum]