Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Wiki Markup
{alias:sma}
h2. Name

sma — Spline map

h2. Syntax
{panel:|borderStyle=solid|borderWidth=1|bgColor=#FFFFAA}

*sma* *i | v | s | n | ms | l | auto | cur* \[arg1] ;# general syntax for contouring with colorbands, see argument list 

arg1 := \[*can*] \[*smo*] \[*map*] \[*flat*] \[*sav*] \[*noadj*]

{panel}

h2. Description

Contour lines are drawn using spline curves to achieve smooth contours.

h2. Arguments

h4. Main contouring arguments:

Note that the main contouring arguments are the same for other shell commands that contour in various ways.

*i* _incr_
{indent} _incr_ is the increment value.
{indent}

*v* _val1_ \[_val2_ _val3_ ...\]
{indent} Contour at specific values, _val1_, _val2_, ... 
{indent}

*s* _start increment stop_
{indent} *s* for step needs three numbers: _start_, _increment_ and _stop_ The first and last contour will be at _start_ and _stop_. 
{indent}

*n* _number_
{indent} Use _number_ contours (levels), equally distributed between the minimum and maximum value. 
{indent}

*ms* _start1 incr1 stop1 start2 incr2 stop2_
{indent} *ms* for multiple steps needs six following numbers. The first contour will be at _start1_, the last at _stop2_.
{indent}

*l*
{indent} Use levels from the last previous contouring operation. 
{indent}

*auto*
{indent} Automatic selection of appropriate contour intervals. 
{indent}

*cur*
{indent} Use contour level from cursor position. Mark a cursor position on a map with key letter *y*. 
{indent}

h4. Other arguments:

*sav* \[*nodraw*]
{indent}Will save the contours in *active* and in *workspace* under the name *^con* which is not directly visible. If the *sav* argument is used in a command menu which restores the original active data, the user must make it _active_ by *mlo ^con*.
The *nodraw* argument prevents the contours to be drawn on the screen.
{indent} 
*smo* 
{indent}Smoother contouring using b-splines.{indent} 
*can \[frq] \[dis] \[hi] \[anl] \[csl] \[ant] \[ans]* 
{indent}
{info:title=Carthographic annotation.}
*frq* _factor_ - Multiply the frequency counter with factor. 
*dis* _distance_ - Annotate for every distance distance. 
*hi* _workspacename_ - Annotate where contours are crossing lines in workspace workspacename. 
*anl* _n_ | *shf* - Annotation levels every n'th contour / on color highlighted (color shifted) contours. 
*shliw* _n_ - Shift linewith to _n_ for highlighted contours. 
*csl* _color_ - Color select for number annotation. _color_ is red/gre/bla/... 
*ant* _factor_ - Extended annotation testing. factor lower than 0.1 will be more restrictive. factor greater than 0.1 will give more annotation. 
*ans* _factor_ - Annotation size factor setting relative to 1.
{info}
{indent}
 
*numsize* _factor_ 
{indent}Size factor of annotation numbers relative to 1.{indent} 
*csh* _inc_ 
{indent}Color shift. Highlights contours on increment _inc_.{indent} 
*flat* _z\_level_ 
{indent}Contour in a plane at level _z\_level_.{indent} 
*nrg* 
{indent}No regridding for large grids. Gives a more detailed display.{indent} 
*map* 
{indent}Use colors from the map color table on the contours.{indent} 
*eli* _number_
{indent}Eliminate small contours with number of points less than _number_.{indent}
*noadj*
{indent} The contours will, by default, be lifted up (or adjusted) a little bit for better visualization. This can be prevented with the *noadj* argument.
{indent}


h2. Examples

h3. Ex.1: Spline mapping

{noformat:|borderWidth=1|bgColor=#eeeeee}
# 3d annotation is very different from 2d annotation.
z                    ;# erase display
win 450000 460000 6450000 6460000 1500 3000 ; # get a new window by coordinates
mak ran 12           ;# make random points
grp 110 110          ;# make grid
bol tub              ;# draw border line n tube mode
acm i 250            ;# color band contours
spe col con bla blu  ;# contour colors are black and blue
spe col ann bla      ;# annotation color is black
sma i 50 csh 250 ann anl shf shliw 3 frq 0.9 ans 1.5; # spline map with annotation
{noformat}

The above example produces this image (somewhat zoomed) using the random generated grid in active data as input. 

!att:_img_ref^cmd_sma.png!
_Spline map with annotation_

h2. See also

[acm - Color band mapping] , [ann - Simple annotation] , [con - Contour using scalars] , [lco - Line color] , [map - Map display]
{pagebreak}