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.