This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
tutorials:tool_quick_reference_card [2012/04/19 18:55] marcus.williams |
tutorials:tool_quick_reference_card [2019/02/21 02:53] marcus.williams [S] |
||
---|---|---|---|
Line 39: | Line 39: | ||
which matches up element names in Y with those in X. | which matches up element names in Y with those in X. | ||
+ | {{ :howtos:toolcoding:mappingtemplate.xls |Mapping Template}} | ||
==== N ==== | ==== N ==== | ||
**norm()** examples: | **norm()** examples: | ||
Line 55: | Line 56: | ||
a[s,t] = sum (b[s->c,t]; dim=stateCOcounty@state) | a[s,t] = sum (b[s->c,t]; dim=stateCOcounty@state) | ||
a[] = sum (b[s,a]; dim=all) | a[] = sum (b[s,a]; dim=all) | ||
+ | </code> | ||
+ | |||
+ | **shrink()** examples: | ||
+ | <code> | ||
+ | a[t] = shrink (b[byrs,a]) | ||
+ | a[t] = shrink (b[byrs,a]; time) | ||
</code> | </code> | ||
Line 65: | Line 72: | ||
TOOL **comments** are lines beginning with the '!' character and will be ignored. | TOOL **comments** are lines beginning with the '!' character and will be ignored. | ||
- | Navigation and display: ''where(), moveto("pathName"), up(), look(), showenv()'' | + | Goto functionality via ''skipto'' command: |
+ | <code> | ||
+ | skipto label1 | ||
+ | ... | ||
+ | skipped code | ||
+ | ... | ||
+ | label1: | ||
+ | </code> | ||
+ | |||
+ | Navigation and display: ''where()'', ''moveto("pathName")'', ''up()'', ''look()'', ''showenv()'' | ||
Line 73: | Line 89: | ||
</code> | </code> | ||
- | **listen()** example: | + | **listen()** example 1 (for a value to put into a TOOL object): |
<code> | <code> | ||
string $target | string $target | ||
Line 85: | Line 101: | ||
endif | endif | ||
</code> | </code> | ||
+ | |||
+ | Example 2 (for TOOL integer type variable): | ||
+ | <code> | ||
+ | integer $elec_startYear | ||
+ | say ("") | ||
+ | listen (" What is your elec start year? {2007..2090}[2010] ",$elec_startYear) | ||
+ | if $elec_startYear == 0 | ||
+ | $elec_startYear = 2010 | ||
+ | endif | ||
+ | </code> | ||
+ | |||
+ | Example 3 (for a yes/no question): | ||
+ | <code> | ||
+ | boolean $answer | ||
+ | say ("") | ||
+ | listen ("Do you want to do something? {y n}[n] ",$answer) | ||
+ | if $answer== true | ||
+ | say ("Do stuff here") | ||
+ | endif | ||
+ | </code> | ||
+ | |||
+ | |||
**menu()** syntax: | **menu()** syntax: | ||
Line 141: | Line 179: | ||
<code> | <code> | ||
- | while arithmetic-expression | + | while arithmeticExpression |
... | ... | ||
endwhile | endwhile | ||
</code> | </code> | ||
+ | **Boolean** operators: ''>'', ''<'', ''>='', ''<='', ''=='', ''!='', ''AND'', ''OR'' | ||
===== Object Creation and Shaping ===== | ===== Object Creation and Shaping ===== | ||
Line 289: | Line 327: | ||
kingLear | kingLear | ||
</file> | </file> | ||
+ | |||
+ | Or creation with category definition using parameters: | ||
+ | |||
+ | <code> | ||
+ | localinformant vwcCOvpshd[] = create (; object=category, groups=vehWeightClass, members=vehPowerSrcHD, \ | ||
+ | 4_5andUnder="ICE_Gas ICE_Diesel ICE_NGL", \ | ||
+ | 4_5-14_9="ICE_Gas ICE_Diesel", \ | ||
+ | 15andOver="ICE_Diesel") | ||
+ | </code> | ||
**mapcat()** syntax: | **mapcat()** syntax: | ||
Line 325: | Line 372: | ||
</code> | </code> | ||
- | Variable types: ''integer, real, boolean, string'' | + | Variable types: ''integer'', ''real'', ''boolean'', ''string'' |
+ | TOOL operators by order of precedence: | ||
+ | <code> | ||
+ | * / | ||
+ | + - | ||
+ | > < >= <= | ||
+ | == != | ||
+ | AND OR | ||
+ | assign | ||
+ | </code> | ||
===== Object Display ===== | ===== Object Display ===== | ||
Line 370: | Line 426: | ||
where objectTypes are: ''view, creview, localview'' | where objectTypes are: ''view, creview, localview'' | ||
- | [List reserved TOOL variables] | + | Reserved TOOL variables: ''$numScns'', ''$numVars'', ''$scnNumbers[]'', ''$scnNames[]'', ''$scnColours[]'', ''$scnDescs[]'', ''$createView'', ''$history'', ''$background'' |
**quit()** is called as ''quit (return code)'' | **quit()** is called as ''quit (return code)'' |