Program: MKLSCONSTANTS

  mklsconstants.........defines some constants used in LOCSMITH
 
  call: constant=mklsconstants(constname);
 
                 constname: string to refer to a specific constant
                            Not case sensitive.
                            See below for a list of defined constants and
                            their 
                     
 
  result: constant: the constant, corresponding to the
                    input CONSTNAME. This might be a number, an array
                    or a string, depending on the constant.
 
  The goal of this routine is to avoid magic numbers that are defined
  somewhere in the code, with nobody knowing how many of them exist and
  where or why they are defined.
 
  The constants defined here are divided into two groups: constants which
  you usually shouldn't change, and constant that are defined here to make
  sure they are available everywhere.
 
 
  You may change he following constants if appropriate for your project:
 
  ReferenceDay: (numeric array) [y m d]
                times in LOCSMITH are counted in seconds since
                this day, 00:00:00.
                Default: [1900 1 1];
 
  Transparency: (number) []
                The Alpha value used for transparency in several types of
                grid plots
 
  SphereFacets: (number) []
                Some plot routines plot additional sphere surfaces as
                beautification or whatever. This constant is passed into
                MatLab's sphere() function and thus defines how fine this
                sphere surface is.
 
  ColorMapLength: (number) [counter]
                Length of colormaps.
 
  FaceColor:    (number or string) [colspec]
                Color specification for faces of surfaces that are drawn
                when plotting grids. This color is used e.g. for th
                augmenting sphere in "cloud"-plots of gridnodes, but also
                for the patches in "surface"-plots of grids.
 
  EdgeColor:    (number or string) [colspec]
                Color specification for faces of surfaces that are drawn
                when plotting grids. This color is used e.g. for th
                augmenting sphere in "cloud"-plots of gridnodes, but also
                for the patches in "surface"-plots of grids.
 
  NodeColor:    (number or string) [colspec]
                Color specification for points (nodes) that are drawn when 
                plotting grids.
                Note that LOCSMITH uses open symbols for inacceptable nodes
                and filled symbols for acceptable nodes.
 
  NodeMarker:   (string) [linespec]
                 linespec string specifying the marker used by MKLSGRIDPLOT
                 and MKLSGRIDRESPLOT to plot station markers.
 
  StationMarker: (string) [linespec]
                 linespec string specifying the marker used by MKLSNETPLOT
                 to plot station markers.
 
  Lighting: (string)
                Surface Lighting type used when plotting grids.
 
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
  YOU SHOULD BE VERY CAREFUL WHEN CHANGING ONE OF THE FOLLOWING:
 
 
  LocationDemo1: (structure)
                Default values for the input of MKLSLOCATIONDEMO. These
                values are used if the location demo routine is called with
                an incomplete list of arguments or with the "demo1"-call.
                This case demonstrates location by BAZ only.
 
  LocationDemo2: (structure)
                Another scenario for MKLSLOCATIONDEMO. These values are
                used for the "demo2"-call. This is a somewhat pathological
                case which demonstrates the Attention Creep Effect in a
                BAZ-only location.
 
  LocationDemo3: (structure)
                Another scenario for MKLSLOCATIONDEMO. These values are
                used for the "demo3"-call. This demo demonstrates the evaluation
                of arrival times. (only P arrival times). Only one depth
                layer is considered.
 
  LocationDemo4: (structure)
                Another scenario for MKLSLOCATIONDEMO. These values are
                used for the "demo4"-call. This demo is a kind of mental
                preparation for LocationDemo5: in "demo4", a single grid
                layer is used to determine longitude, latitude and origin
                time od a deep quake. The layer is at the true depth of
                that quake.
 
  LocationDemo5: (strcuture)
                 Another scenario for MKLSLOCATIONDEMO. These values are
                 used for the "demo5"-call.
                 The situation here is the same as in "demo4", but in
                 "demo5", LOCSMITH also has to determine the focal depth
                 from arrival times.
 
  LocationDemo6: (strcuture)
                 This is an example of a failure: based on demo4, the
                 configuration used here makes LOCSMITH find a solution
                 with reduced compatibility (2 incompatible data) in an
                 area far away from the true hypocenter.
                 It is important to understand that any method that is
                 based on checking examples may fail, since you cannot
                 prove the nonexistence of alternative solutions by giving
                 examples.
 
  LocationDemo7: (structure)
                 An example for incomplete data and non-uniqueness:
                 The same as demo 5, but with only 2 stations.
 
 
  ReftriRoundoff (number)
                 A large number used to round off the computed edge lengths
                 in MKLSGRIDREFTRI. This roundoff is needed to find the
                 second longest edge in a grid without strugglin over
                 roundoff errors of about 1e-12.
 
  TrianglesTetrahedron  (number)
                 Number of triangles of a Tetrahedron.
 
  TrianglesOctahedron   (number)
                 Number of triangles of an Octahedron.
 
  TrianglesIcosahedron  (number)
                 Number of triangles of an Icosahedron
 
  MaxEdgeTetra:  (numeric array) [deg]
                 List of maximum edge lengths of tetrahedron-based grids.
                 The first element is the edge length of the tetrahedron
                 itself, the second element is the length of the longest
                 edge after one iteration, the third if the same after two
                 iterations and so on.
                 The list given here gives max edge lengths only for a few
                 ietrations. For higher iterations, just divide the
                 smallest value in the list by successive powers of two.
                 This list was produced by an aolder version of MKLSGRIDREFTRI.
 
  MaxEdgeOcta:   (numeric array) [deg]
                 List of maximum edge lengths of octahedron-based grids
                 (see MaxEdgeTetra for details)
 
  MaxEdgeIcosa:  (numeric array) [deg] 
                 List of maximum edge lengths of icosahedron-based grids
                 (see MaxEdgeTetra for details)
 
  MaxCCRTetra:  (numeric array) [deg]
                List of maximum circumcircle radii for tetrahedron based
                grids. The first element is the circumcircle radius of the
                intial tetrahedron, the second element is the largest
                circumcircle radius after one iteration, the third the same
                after two iterations and so on.
                The list given here gives radii only for a few iterations.
                For higher iterations, just divide the smallest value in
                the list by successive powers of two. This list was
                produced by MKLSGRIDREFTRI.
 
  MaxCCROcta:   (numeric array) [deg]
                List of maximum circumcircle radii for octahedron based
                grids. See MaxCCRTetra for details.
 
  MaxCCRIcosa:  (numeric array) [deg]
                LIst of maximum circumcircle radii for icosahedron based
                grids. See MaxCCRTetra for details.
 
  LSPath:        (string)
                 path to the directory in which the LOCSMITH m-files reside
                 This is determinded dynamically as the path in which
                 MKLSCONSTANT resides.
                 No trailing slash/backslash.
 
  LSDocPathEN:   (string)
                 path to the directory in which the english LOCSMITH documentation
                 resides. This is the path to the HTML files of the english
                 version of the documentation, not to the images or
                 something else. Cosntructed via a recursive call to
                 MKLSCONSTANT('LSPath').
                 No trailing slash/backslash.
 
  HTMLHead:      (string)
                 HTML header for automatic generation of HTML files from
                 the help lines in m-files, used by MKHELP2HTML
 
  HTMLTitleOpen: (string)
                 Opening phrase for HTML page headline.
                 This is not the title-tag of the HTML page, but the headline
                 of the text.
 
  HTMLTitleClose: (string)
                 Closing phrase for HTML headline
 
  HTMLHelpBodyOpen:  (string)
                 This phrase opens the body part with the actual help lines
 
  HTMLHelpBodyClose: (string)
                 This phrase closes the body part with the actual help
                 lines.
 
  HTMLLinkOpen:  (string)
                 Opening Phrase for link to m-file source code.
                 The link URL has to bewritten between the opening and the
                 middle phrase.
 
  HTMLLinkMiddle (string)
                 Middle phrase for link to m-file source code. This is
                 mainly the constant part of the link text and the closing
                 '>' character fo the anchor opening tag.
 
  HTMLLinkClose: (string)
                 Closing phrase for link to m-file source code
 
  HTMLFoot:      (string)
                 HTML footer for automatic generation of HTML files from
                 the help lines in m-files, used by MKHELP2HTML
 
  HTMLTocLinkOpen: (string)
                 Opening phrase for TOC entries generated by MKHELP2HTML
 
  HTMLTocLinkMiddle: (string)
                 Middle phrase for TOC entries generated by MKHELP2HTML
 
  HTMLTocLinkClose: (string)
                 Closing phrase for TOC entries generated by MKHELP2HTML
 
 
 
  Martin Knapmeyer, 09.09.2004

Read M-File Source Code


eof.