Index   |   map > toposurf.m
<<  dataplot map/  >>
toposurf
PURPOSE ^
TOPOSURF Visualisation of topological Surfaces/Images
SYNOPSIS ^
function [fig,apd,ini] = toposurf(x,y,z,varargin)
DESCRIPTION ^
 TOPOSURF  Visualisation of topological Surfaces/Images

*************************************************************************
 Intro for Syntax

   The Configuration of TOPOSURF has various Parameters to Control
    the Layout, Colors, Data to show, etc.

   To customize the DefaultValues the Parameter-Value-Pairs can
      be redefined by following Inputs ("..."):

         ... , 'PARAMETER' , Value , ... 

      or in a ConfigFile, Syntax:

         # Parameter: Value  % Comment

         # Parameter
         % Comment
           Value

   Parameter-Value-Pairs from Inputs overwrites the defaults or
    the Configuration of the ConfigFile. 

   Optional Inputs are surrounded by "[]".

 Note: If any error occur, the first Output contains the String
       of the ErrorMessage.

--------------------------------------------------------------
 See Examples:

  toposurf @#topo
  toposurf @#seamount
  toposurf @#isle
  toposurf @#logo
  toposurf @#baltic
  toposurf @#section
  toposurf @#magdev

--------------------------------------------------------------
 Show XYZ-Data:

   FIG = TOPOSURF( X , Y , Z , [ConfigFile] , ... )

   FIG = TOPOSURF( Z , [ConfigFile] , ... )

--------------------------------------------------------------
 Show Data from MAT-File

   FIG = TOPOSURF({ MAT_File XVar YVar ZVar } , [Stride] , [Dim] , [ConfigFile] , ... )

   FIG = TOPOSURF(  MAT_File , [Stride] , [Dim] , [ConfigFile] , ... )

--------------------------------------------------------------
 Show Data from NetCDF-Config   

   FIG = TOPOSURF({ CNF_File [DataVar]   [NC_File]  } , [Stride] , [Dim] , [ConfigFile] , ... )

   FIG = TOPOSURF(  CNF_File , [Stride] , [Dim] , [ConfigFile] , ... )
   
--------------------------------------------------------------
 Show a Map without Data:

   FIG = TOPOSURF( [] , [ConfigFile] , ... )

   FIG = TOPOSURF( ConfigFile , ... )

--------------------------------------------------------------
 Plot Data into a TOPOSURF-Figure

   TOPOSURF( FIG , Type , X , Y , [Z] , ... )

   following Inputs can be Parameter/Values 
     for the GraphicObject, defined by Type

--------------------------------------------------------------
 Save Image to MAT-File

   TOPOSURF( '#MatFile' , FIG , Scale , [FileName] ) 

--------------------------------------------------------------
 Scale Data in Z or C

 Z = TOPOSURF( Handle , 'ZScale' , Z );  % Z-Scales ZData
 C = TOPOSURF( Handle , 'CScale' , Z );  % C-Scales ZData

--------------------------------------------------------------
 Inquire the Configuration
 
   CNF = TOPOSURF                                return DefaultConfiguration

   CNF = TOPOSURF( ConfigFile , 'check' , ... )  check Configuration

  [CNF,File] = TOPOSURF('@FILENAME')  saves a DefaultConfigFile

  [CNF,Help] = TOPOSURF('@-')         returns HelpText
  [CNF,Help] = TOPOSURF('@%')         returns HelpText, prepended with "%"

*************************************************************************
 Show Data

 [FIG,CFG] = TOPOSURF( X , Y , Z , [ConfigFile] , ... )

 TOPOSURF( Config , [Stride] , [Dim] , [ConfigFile] , ... )

    MAT_Config = { MAT_File  [XVar]  [YVar]  [ZVar] }

     empty XYZ-Var: use 'x' 'y' 'z', check in MAT-File for CDataVar 'c'

 NetCDF_Config = { CNF_File  [DataVar]   [NC_File]  } for using LOAD_CDF

     empty DataVar: use 1. DataVar in NetCDF-ConfigFile

 Stride        = [ StrideX    StrideY   ]

     empty Stride: try to use Stride for 1-Pixel-Resolution.

 Dim           = Vector for DimensionNumbers: 3 4 ... 
                  used if Z has more then 2 Dimensions
                  default: 1

 FIG returns the FigureHandle, 

 CFG returns the Configuration of TOPOSURF:

     CFG.axe  AxesHandles
     CFG.bar  ColorBarHandles
     CFG.obj  ObjectHandles
     CFG.cnf  the Configuration

 Following Inputs are Parameter-Value-Pairs (even Number).
  See below for Parameter and Value-Syntax.

 There are 4 Axes created to show your Data:

    CFG.axe.Topo      to show the XYZ-Data as Surface or Image
    CFG.axe.Contour   to show ContourLines
    CFG.axe.GMT       to show GMT-Lines
    CFG.axe.Data      to show additional Data (see below) 
                       and the Border

--------------------------------------------------------------
 NetCDF-Configuration

 A NetCDF-ConfigurationFile (CNF-File) is used to define a 
 multidimensional gridded NetCDF-DataBase, with up to 4 Dimensions: 
  X, Y, Z and Time.
 Additional DataVariables, which correspond to the Dimensions are
 defined.

 The DimensionName in the NetCDF-Files is defined with the KeyWord
 "# *Dim", the Names of the Variables of this Dimension with the 
 KeyWord "# *Var", where "*" has to be replaced with "X", "Y", "Z" 
 and "T". If any Dimension is missing (like Time in case of a Data-
 base without any Time-Dimension) it is empty.

 To create a CNF-File use: CNF_CDF <NetCDF-FileName>
 Load Data using a CNF-File with LOAD_CDF.

 Note: For using a NetCDF-DataBase a valid platform-depended
        MEXCDF-MEX-File must be exist in Matlab's WorkSpace.
       Adjust the Name of the MEXCDF-File in the function NCMEX 
        of the "private"-Directory for TOPOSURF

--------------------------------------------------------------
 Variations in DataSyntax

 TOPOSURF(  Z     , [ConfigFile] , ... )   
 TOPOSURF(  C     , ... ) 
 
   use ( 1 : SIZE(Z,DIM) ) or linear spaced Range or Area for X/Y
    Mercator is set to 'off' in case of Type Image


 TOPOSURF(  X , Y , Z  , ... ) 

 TOPOSURF(  X , Y , C  , ... ) 

 TOPOSURF(  X , Y , [] , ... , 'CData' , C ) 

 TOPOSURF( Config , [ConfigFile] , ... )   
           use full Range of MAT-File or NetCDF-Data

 To create a Figure with the Parameter from a ConfigFile or Defaults/Inputs
  without XYZ-Data use:

 TOPOSURF( [ConfigFile] , ... )
 TOPOSURF( [] , [ConfigFile] , ... )

 Nonempty numeric CData are shown !

*************************************************************************
 Plot Data into a TOPOSURF-Figure

 H = TOPOSURF( FIG , Type , X , Y , [Z] , ... )

     creates a GraphicObject specified by Type in DataAxes of FIG

     Type is a any of: 'plot' | 'line' | 'patch' | 'surface' | 'text' ...

 H = TOPOSURF( AXE , Type , X , Y , [Z] , ... )

     creates a GraphikObject in the specified Axes of FIG
 
 Following Inputs are Property-Value-Pairs for the GraphikHandle.
  See also: HandleGraphicsProperties-Browser of Matlab's HelpDesk

 If Type is any of  'contour' or 'contourf' use:

     TOPOSURF( ... , X , Y , Z ,  ... )

 If Type is any of  'text' or 'shadtext' you can use:

     TOPOSURF( ... , X , Y , [Z] , STRING , ... )

 To see more Options for shadowed text by SHADTEXT type:

     >> help shadtext

 Use a NonZero imaginary Part of X or Y for normalized Units
  the SIGN of the imaginary Part refers to:
   "+": Left/Bottom, "-": Right/Top

 If X and Y have the same Size, a NaN for normalized X xor Y
  will use the Distance of the Other normalized Coordinate.

*************************************************************************
 Save the Image into MAT-File

 Msg = TOPOSURF( '#MatFile' , FIG , Scale , [FileName] )
         saves the current Image, using SAVEIMG
         Scale in [%],  Scale = 0 use GETFRAME (ScreenShot)

 Save the Variables "x", "y", "c", "ext", "cnf" into MAT-File.

 Use the MAT-File as Input for TOPOSURF with Type Image
  for faster proceeding.

 Note: For complex 3D-Graphics in Type Surface
       the Renderer 'zbuffer' is recommended.
       In this Mode the Size of the Fonts is
       NOT printed correctly for PostScript-Devices!!!
       To avoid this, save the 3D-Graphic like descibed above and
       redraw the Graphic using the MatFile as DataBase with
       the Parameter: 'Type'     , 'Image'
                 and  'Renderer' , 'painters'

*************************************************************************
 Scaling for Z-Data in Z and Color

 ZSCL = TOPOSURF( Handle , 'ZScale' ) returns the ZScale-Configuration:

 ZSCL.scl   ScaleFactor * i*Potenz   Zscaled = (Z*real(scl))^imag(scl)
      zc    Center
      geo   True for GeoMode, Zscaled is multiplied by 1/(1852*60)

 CSCL = TOPOSURF( Handle , 'CScale' ) returns the CScale-Configuration:

 CSCL.cl    ColorLimit
      zc    Center
      nc    ColorNumber(s), refers to Center
      cm    ColorMap
      cn    NaN-Color


 Z = TOPOSURF( Handle , 'ZScale' , Z );  % Z-Scales ZData
 C = TOPOSURF( Handle , 'CScale' , Z );  % C-Scales CData

 Handle = FIG | AXE

*************************************************************************
 Inquire the Configuration

 [CNF,INI] = TOPOSURF  returns the DefaultConfiguration

 [CNF,INI] = TOPOSURF( ConfigFile , 'check' , ... )

   check and returns the Configuration of a ConfigFile
    and overlayed Inputs.

 [CNF,INI] = TOPOSURF( '' , 'check' , ... )

   check and returns the InputConfiguration

 [CNF,File] = TOPOSURF('@FILENAME') saves a DefaultConfigFile

 [CNF,Help] = TOPOSURF('@-') returns HelpText
 [CNF,Help] = TOPOSURF('@%') returns HelpText, prepended with "%"

*************************************************************************
 Examples

 TOPOSURF('@#')  List the Commands of all Demos in the MatlabCommandWindow

 TOPOSURF('@#',FileName) Writes the Commands of all Demos into specified File

 [CNF,CMD] = TOPOSURF('@#')    Returns the DefaultConfiguration and
                                the Commands of all Demos.

 [CNF,CMD,FIG] = TOPOSURF('@#NAME')   List and Run the Demo by NAME

 available: 'Topo'      shows the Topography of Matlab's Demo TOPO.MAT
            'SeaMount'  shows the Topography of Matlab's Demo SEAMOUNT.MAT
            'Isle'      show an Island from Matlab's Demo SEAMOUNT.MAT
            'Logo'      Matlab's Logo (LOGO.MAT) in 2D
            'Baltic'    The central Baltic-Sea-Area using GMT-Data
            'Section'   generate and show a synthetic TemperatureSection
            'MagDev'    show the Magnetic Deviation at Greenwich-Meridian
                        from 1900 - 2100, requires GEOMAG

 CMD returns a String with the executed Commands.

 TOPOSURF('@#NAME',FileName) Writes the Commands of Demo into specified File

*************************************************************************
 See also:

 Configuration:   LOAD_CNF, CHECK_CNF, STRUCTCHK, DEFVAL, LOAD_ASC

 Layout:          MERCATOR, GEOAXIS, TIMEAXIS
 Lighting:        LIGHTANG, MATERIAL

 Projection:      MERCATOR, DEG2MERC, MERC2DEG, PPUNIT

 NetCDF-Data:     CNF_CDF, LOAD_CDF, LOOK_CDF, ASSIGN_CDF
 XYZ_Data:        MONOGRID, MKGRID, WHOSFILE
 Smooth:          MEANIND2

 CData:           CHKCDATA, COR4FLAT, SURFACE, IMAGE
 Colors:          FERRETC, BRC, COLSPEC, XRGB, XRGBROWSE

 Contour:         ISOLINES, CONTOURS
 GMT-Lines:       GMTLINES, READ_GMT, SAMPLINE

 DataPlot:        DATAPLOT

 Zoom:            AXE_ZOOM
 Print:           SAVEIMG, SHOWIMG

*************************************************************************
 Configuration
*************************************************************************

 Below the Configuration of TOPOSURF, which can also be written in a
  ConfigFile to load by LOAD_ASC.
  The Parameter(KeyWord)Marker are {'#' ':'}, the CommentMarker '%'.

 Use normal MatlabSyntax for Values in ConfigFile.
 Mask Marker in Values with surrounding "", like: "#"

 Example:

 # Zoom: 'off'   % No Zoom
 # BackColor
 % Color for BackGround
    1  1  1


 Note: The Parameter (Keywords) must be written in the correct
        Upper/Lower-Case-Statement.

       Not all Parameter (Keywords) must be defined in a ConfigFile.
       For undefined Parameter the defaults are used.

       Parameter, defined in the Inputs of TOPOSURF, overwrite
        the defaults or Values from ConfigFile.

       In the Subdirectory "colmaps/" you find  ColorMaps
        to use  by FERRETC. To view the ColorMaps type:
        >> ferretc test

 Use curly braces "{}" in String for Labels to force them to TEX-Interpreter

-------------------------------------------------------------------------

 Valid ColorSpecifier by the Optional Value '#colspecX#':

  Matlab: 'r'   'g'     'b'    'c'    'm'       'y'      'k'     'w'
          'red' 'green' 'blue' 'cyan' 'magenta' 'yellow' 'black' 'white'

    XRGB: type >> xrgbrowse
            or >> xrgb
            or >> colspec(1)


 Statements for required Size:

  "-"   any Size in this Dimension allow
  "-N"  Value can have a Size up to N in this Dimension
  "N"   Value must have Size N in this Dimension
        Single Values will repeated by N
        Longer Sizes are cutted.

-------------------------------------------------------------------------
 Parameter        [Size]  Type / Values            Comment
                  Optional
-------------------------------------------------------------------------
 Basics
-------------------------------------------------------------------------

 AppName         'TOPOSURF'                        FieldName of FigureApplicationData
                                                   #default: 'TOPOSURF'

 Verbose         'on' 'off'                        'on': show Messages in MatlabCommandWindow
                                                   #default: 'on'

 Zoom            'on' 'off'                        'on': Enables Zoom by AXE_ZOOM
                                                   #default: 'on'

 MenuBar         'on' 'off'                        'on': Show MenuBar with XY-Location of Pointer
                                                         and a SaveMenu by SAVEIMG
                                                   #default: 'on'

 Visible         'on' 'off'                        Visibility of Figure
                                                   #default: 'on'

 Renderer        'auto' 'painters' 'zbuffer'       RendererProperty of Figure
                 'OpenGL'                          #default: 'zbuffer'

 Area             [ 1  4 ]  numeric                AxisLimits: [ XMin XMax  YMin YMax ]
                 'auto'                            #default: 'auto'

 XBase            [ 1  -6 ]  uint16                Base for X-Axis
                 'none' 'lon' 'lat'                BaseDate: [ YY MM DD hh mm ss ]
                                                             for TimeLabels using TIMEAXIS
                                                             XData are [days] since BaseDate
                                                   'lon' : use LongitudeLabels by GEOAXIS
                                                   'lat' : use  LatitudeLabels by GEOAXIS
                                                   'none': no special Labels; Frame by MERCATOR
                                                   XBase and YBase must be different or 'none'
                                                   #default: 'none'

 YBase            [ 1  -6 ]  uint16                Base for Y-Axis
                 'none' 'lon' 'lat'                BaseDate: [ YY MM DD hh mm ss ]
                                                             for TimeLabels using TIMEAXIS
                                                             YData are [days] since BaseDate
                                                   'lon' : use LongitudeLabels by GEOAXIS
                                                   'lat' : use  LatitudeLabels by GEOAXIS
                                                   'none': no special Labels; Frame by MERCATOR
                                                   XBase and YBase must be different or 'none'
                                                   #default: 'none'

 Mercator         [ 1  1 ]  numeric                Scale for using MERCATOR, X/Y expected as Lon/Lat
                 'auto' 'off' 'none'               Scale+i*NTickInt: gives the Number of TickIntervalls
                                                   Scale-i*NTickInt: round the AxisLimits to the
                                                                     selected TickIntervall
                                                   A negative Value for Scale use a fixed DataAspectRatio:
                                                    [ 1 YAspect 1 ] with Lon/Lat : -YAspect +/- i*NTickInt
                                                    [ 1 YAspect 1 ]  no  Lon/Lat : -YAspect
                                                    'off': No Lon/Lat, XY-Ratio 1:1
                                                   'none': No Lon/Lat, XY-Ratio auto (by Geometry)
                                                   #default: 'auto'

 Tick             [ 1  -2 ]  numeric               TickIntervall [ XTickInt YTickInt ] | XYTickInt
                 'auto'                            If TimeBase is set to use TIMEAXIS use:'
                                                      [ LabelInt  YTickInt ] | YTickInt
                                                   #default: 'auto'

 Center           [ 1  1 ]  numeric                Z-Center for Smooth, Scale and ColorMap
                 'none' 'min' 'max'                #default:   0

 Smooth           [ 1  -2 ]  uint8                 Smooth for ZData, 2 Elements refers to Center
                 'none'                            #default: [ 1  1 ]

 Scale            [ 1  -2 ]  numeric               Scale for ZData, 2 Elements refers to Center
                 'auto' 'none'                     Effects on Lighting together with LightAngle.
                                                   Linear+i*Potenz: Zscaled = (Z*real(Scale))^imag(Scale)
                                                   The result is scaled by 1/(1852*60) if Mercator
                                                   'auto': Get Linear Part that mean Gradient is EXP(-1)
                                                   #default: 'auto'

-------------------------------------------------------------------------
 Data to Show
-------------------------------------------------------------------------

 Type            'auto' 'Surface' 'Image'          Type of GraphicObject
                                                    Image faster, Surface 3D with Lighting
                                                   #default: 'auto'

 CData                                             RGB-Data for Colors: 3D-RGB-Matrix | { Index CMap }
                                                                        ColorStructure by GETFRAME
                                                   VariableName in MAT-File or NetCDF-ConfigFile
                                                   CData corresponding to ZData to scale in ColorMap
                                                         by ColorLimit, ColorCenter ...
                                                   #default: []

 Contour          [ -  4 ]  cell                   ContourConfig for ISOLINES of ZData or corresponding CData
                                                   { Value(s)  LineColor LineStyle LineWidth }
                                                     Value+i  show IsoLines at:
                                                              ( MOD(Z,V) == 0 ) & ( SIGN(Z) == SIGN(V) )
                                                     Value-i  show IsoLines at: ( MOD(Z,V) == 0 )
                                                   LineColor:  [ R G B ] | ColorSpec
                                                   LineColor:  [ -1 .. 1 ]  Dark or Bright Color by ColorScale
                                                   #default: {}

 StyleFile        [ 1  - ]  char                   StyleFile for DataFile to use by DATAPLOT
                                                   #default: ''

 DataFile         [ 1  - ]  char                   DataFile to use by DATAPLOT
                                                   #default: ''

 DataInit          cell                            Configuration for DATAPLOT
                                                   Use: { [ConfigFile] Parameter Value ... }
                                                   #default: {}

 GMT              [ -  4 ]  cell                   GMT-Config for GMTLINES
                                                   { GMT  LineColor LineStyle LineWidth }
                                                     GMT = { GMT_Config  [Levels]  [+MinSkm] }
                                                     GMT = { GMT_Config  [Levels]  [-MinSkm] }
                                                     NaN for MinSkm use the Value of OneSquarePixel
                                                     NaN +/- N*i for Min/MaxSkm use the Value of N Pixel
                                                     See READ_GMT for GMT-Configs and Levels
                                                   LineColor:  [ R G B ] | ColorSpec
                                                   #default: {}

 Sample           [ 1  -2 ]  numeric               LowSample for GMT-Lines by SAMPLINE in GMTLINES
                                                   [ Sample  [Smooth] ], ZERO use Defaults: [ 3  5 ]
                                                   #default: [ 1  1 ]

-------------------------------------------------------------------------
 Layout
-------------------------------------------------------------------------

 Units           'px' 'cm' 'in' 'mm' 'pt' 'nm'     Units for Geometry, FrameOffset and FrameWidth
                                                   'px': pixels;  'cm': centimeter; 'in': inches;
                                                   'mm': millimeter; 'pt': points;
                                                   'nm': normalized to ScreenSize
                                                   #default: 'px'

 Geometry         [ 1  2 ]  numeric                max. AxesSize: [ Width  Height ] in [Units]
                 'auto'                            'auto': Fit FigureExtension to ScreenSize
                                                   Note: The FigureExtension fits always in ScreenSize
                                                         if the imaginary Part is ZERO,
                                                         use "+i" to prevent this
                                                   #default: 'auto'

 FrameOffset      [ 1  4 ]  numeric                [Units]-Offset for Axes in Figure
                                                   [ Left Right Bottom Top ] | [LRBT]
                                                   "+i" measures from Frame (ignore Fonts)
                                                   #default: [ 0  0  0  0 ]

 FrameWidth       [ 1  1 ]  numeric                [Units]-Width of MercatorBorder, negative: no b/w Stripes
                 'auto' 'none'                     "+i" no Frame is shown (only Ticks)
                                                   'none' | NaN: Frame closed to Figure minus FrameOffset
                                                                    no TickLabels, no Ticks
                                                   #default: 'auto'

 Layer           'top' 'bottom'                    Location of Frame-Layer, 'bottom' hides Ticks in Frame
                                                   #default: 'top'

 BackColor        [ 1  3 ]  numeric                RGB-Color of FigureBackGround
                 '#colspecX#'                      #default: 'w'

 FrameColor       [ 1  3 ]  numeric                RGB-Color of Frame and AxesLabels
                 'auto' 'none' '#colspecX#'        'auto': invert BackColor
                                                   #default: 'auto'

 LineWidth        [ 1  1 ]  numeric                LineWidth of Frame, points
                                                   #default:   0.5

 Grid            '-' '--' ':' '-.' 'none'          GridLineStyle
                                                   #default: 'none'

 XDir            'normal' 'reverse'                Direction of X-Axes
                                                   #default: 'normal'

 YDir            'normal' 'reverse'                Direction of Y-Axes
                                                   #default: 'normal'

 FontName         [ 1  - ]  char                   Use LISTFONTS / UISETFONT to see available Fonts
                                                   #default: 'Helvetica'

 FontWeight      'light' 'normal' 'demi' 'bold'    #default: 'normal'

 FontAngle       'normal' 'italic' 'oblique'       #default: 'normal'

 FontUnits       'px' 'cm' 'in' 'mm' 'pt' 'nm'     Units for FontSize, TitleSize, LabelSize, BarSize
                                                   'px': pixels;  'cm': centimeter; 'in': inches;
                                                   'mm': millimeter; 'pt': points;
                                                   'nm': normalized to AxesHeight
                                                   #default: 'pt'

 FontSize         [ 1  1 ]  numeric                'none': Frame closed to Figure minus FrameOffset
                 'none'                                       no TickLabels, no Ticks
                                                   #default:   10pt

 XLabel           [ 1  - ]  char                   String for Label at X-Axes
                                                   #default: ''

 YLabel           [ 1  - ]  char                   String for Label at Y-Axes
                                                   #default: ''

 LabelName        [ 1  - ]  char                   FontName for Labels, 'auto' use FontName
                 'auto'                            #default: 'auto'

 LabelWeight     'light' 'normal' 'demi' 'bold'    FontWeight for Labels
                                                   #default: 'bold'

 LabelAngle      'normal' 'italic' 'oblique'       FontAngle for Labels
                                                   #default: 'normal'

 LabelColor       [ 1  3 ]  numeric                FontColor for Labels, 'auto' use FontColor
                 'auto' '#colspecX#'               #default: 'auto'

 LabelSize        [ 1  1 ]  numeric                FontSize for Labels, 'auto' use FontSize+1pt
                 'auto'                            "+i"  relative to FontSize
                                                   #default: 'auto'

 Title            [ 1  - ]  char                   String for Title
                                                   #default: ''

 TitleName        [ 1  - ]  char                   FontName for Title, 'auto' use FontName
                 'auto'                            #default: 'auto'

 TitleWeight     'light' 'normal' 'demi' 'bold'    FontWeight for Title
                                                   #default: 'bold'

 TitleAngle      'normal' 'italic' 'oblique'       FontAngle for Title
                                                   #default: 'normal'

 TitleColor       [ 1  3 ]  numeric                FontColor for Title, 'auto' use FrameColor
                 'auto' '#colspecX#'               #default: 'auto'

 TitleSize        [ 1  1 ]  numeric                FontSize for Title, 'auto' use FontSize+2pt
                 'auto'                            "+i"  relative to FontSize
                                                   #default: 'auto'

-------------------------------------------------------------------------
 Lighting for Type Surface
-------------------------------------------------------------------------

 LightAngle       [ 1  2 ]  numeric                [ Azimut  Elevation ], valid if Type Surface
                 'none'                            #default: [ 120  60 ]

 LightColor       [ 1  3 ]  numeric                RGB-Color of Light
                 'none' '#colspecX#'               #default: 'w'

 Material         [ 1  5 ]  numeric                Reflectance Characteristics of Surface
                 'dull' 'metal' 'shiny'            [ AmbStr  DiffStr  SpecStr  SpecExp  SpecColorRefl ]
                                                   #default: [ 0.4  0.6  0  10  1 ]

 Lighting        'none' 'flat' 'gouraud' 'phong'   FaceLighting of Surface
                                                   #default: 'gouraud'

 Shading          [ 1  3 ]  numeric                FaceColor of Surface, is set automaticly to 'texturemap'
                 'none' 'flat' 'interp'             if Size of nonempty CData doesn't match Size of Z
                 'texturemap' '#colspecX#'         #default: 'flat'

 Mapping         'index' 'true'                    Mapping for ColorData
                                                   #default: 'index'

-------------------------------------------------------------------------
 ColorScaling
-------------------------------------------------------------------------

 ColorMap                                          RGB-ColorMap or FERRETC-ColorMap (SPK-File)
                                                    or { FCN ... } for using FEVAL.
                                                   expected symetric if Center is used
                                                   #default: { 'ferretc' , 'terra' }

 ColorLimit       [ 1  2 ]  numeric                [ CMin  CMax ], 'auto': use [ ZMin  ZMax]
                 'auto'                            #default: 'auto'

 ColorCenter      [ 1  1 ]  numeric                Value for Center of ColorMap
                 'auto' 'none' 'min' 'max'         "min"/"max" refers to ColorLimit
                                                   "auto" use Value of CenterRGB-Color for NaN-Values of Image
                                                   #default: 'auto'

 CenterRef        [ 1  - ]  char                   Reference of CenterValue for CenterLine, CenterLabel and BarTick
                 'data' 'color'                    #default: 'data'

 CenterLine       [ 1  - ]  char                   Draw a black Line at CenterValue at ColorBar
                 'off' 'on'                        #default: 'on'

 CenterLabel      [ 1  - ]  char                   Special TickLabel for CenterValue at ColorBar
                                                   #default: ''

 ColorLight       [ 1  -2 ]  numeric               Lighting of ColorMap, 2 Elements refers to ColorCenter
                 'none'                            [ -1 .. 1 ]  Dark or Bright Color by Value / Saturation
                                                   "+R*i" Rotate Color in Hue by R = [ -1 .. 1 ]
                                                   #default: 'none'

 ColorIntervall   [ 1  2 ]  numeric                Intervalls for ColorMap in Range of ColorLimit
                 'auto'                             2 Elements refers to ColorCenter
                                                    defines ColorNumber: Limit/Intervall
                                                   #default: 'auto'

 ColorNumber      [ 1  2 ]  uint16                 Length of ColorMap if ColorIntervall 'auto'
                 'auto'                             2 Elements refers to ColorCenter
                                                   #default: 'auto'


 ColorNaN         [ 1  3 ]  numeric                RGB-Color for NaN-Values of Image
                 'none' '#colspecX#'               BackGroundColor of Axes
                                                   #default: [ 0.75  0.75  0.75 ]

-------------------------------------------------------------------------
 ColorBar
-------------------------------------------------------------------------

 ColorBar        'top' 'bottom' 'left' 'right'     Location of ColorBar
                 'none'                            #default: 'none'

 BarWidth         [ 1  1 ]  uint8                  Width of ColorBar [pixels], "+i" use Units FontWidth
                 'auto'                            'auto': use 2 times FontWidth, min. 10 Pixels
                                                   The Width is limited to a Ratio 1:5
                                                   #default: 'auto'

 BarLimit         [ 1  2 ]  numeric                [ CMin  CMax ], 'auto': use ColorLimit
                 'auto'                            #default: 'auto'

 BarTick          [ 1  - ]  numeric                BarTickIntervall, 2 Elements refers to Center
                 'auto'                             negative Values for 2 Elements use absolute
                                                   More then 2 Elements give a Vector of Ticks
                                                   #default: 'auto'

 BarDir          'normal' 'reverse'                AxisDirection for ColorBar
                                                   #default: 'normal'

 BarContour      'off' 'on'                        'on': show ContourLines by Contour in ColorBar
                                                   #default: 'off'

 BarName          [ 1  - ]  char                   FontName for ColorBar, 'auto' use FontName
                 'auto'                            #default: 'auto'

 BarWeight       'light' 'normal' 'demi' 'bold'    FontWeight for ColorBar
                                                   #default: 'normal'

 BarAngle        'normal' 'italic' 'oblique'       FontAngle for ColorBar
                                                   #default: 'normal'

 BarColor         [ 1  3 ]  numeric                FontColor for ColorBar, 'auto' use FrameColor
                 'auto' '#colspecX#'               #default: 'auto'

 BarSize          [ 1  1 ]  numeric                FontSize for ColorBar, 'auto' use FontSize
                 'auto'                            "+i"  relative to FontSize
                                                   #default: 'auto'

 Label            [ 1  - ]  char                   String for ColorBarLabel
                                                   #default: ''

 Location        'top' 'bottom' 'left' 'right'     Location of ColorBarLabel
                 'auto'                            #default: 'auto'


*************************************************************************

DOWNLOAD M-File ^
236 KByte
CROSS-REFERENCE INFORMATION ^
This function calls:
DATAPLOT Plot a DataSet from a DataFile using Styles from a StyleFile
TOPOSURF Visualisation of topological Surfaces/Images
This function is called by:
TOPOSURF Visualisation of topological Surfaces/Images
SUBFUNCTIONS ^
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 


Generated on Sat 09-May-2009 10:46:59 by m2html © 2003, Revision by Ch.Begler 2008
^