TT.points.in.classes(soiltexture)
TT.points.in.classes()所属R语言包：soiltexture
Classify a table of soil texture data according to a soil texture triangle.
根据土壤纹理三角形土壤纹理数据分类的表。
译者：生物统计家园网 机器人LoveR
描述----------Description----------
The function calculate in which classe(s) of a texture triangle
该函数计算，其中CLASSE（s）的一个纹理三角形
(classification system defined by 'class.sys') lies each soil
（由class.sys）定义的分类系统在于每个土
sample (with texture data) in the table 'tri.data'. As a sample
样品（与纹理数据）在表tri.data。作为试样
may lie inside a texture class, but also at the edge of 2 or
内部可能在于纹理类，而且在2的边缘或
more texture classes, the function does not only output
更多的质地，功能不只是输出
one single texture class per sample. If 'PiC.type' is 'n' or
一个单一的纹理类，每个样品。 ，如果PiC.type是n或
'l', it rather output a table where each column is a texture
L，而不是输出表中的每一列是一个质地
class and each row a texture sample, and yes / no information
类，每一行的纹理样本，是/否信息
about the belonging of the sample to each texture class.
每个纹理类的样品的归属。
Alternatively, If 'PiC.type' is 't'it will output a text
或者，如果PiC.type是tit将输出一个文本
string (per sample) containing all the texture classes
字符串（每个样品），其中包含所有的纹理类
to which that point belong.
该点属于。
The texture data in 'tri.data' can be transformed into
的纹理数据，可以转化为在tri.data
another particle size system prior to their classification
另一个粒子的大小之前，其分类系统
if needed. See the options base.css.ps.lim, tri.css.ps.lim,
如果需要的话。见的的的选项base.css.ps.lim，tri.css.ps.lim，
dat.css.ps.lim, css.transf and text.transf.fun.
dat.css.ps.lim，css.transf text.transf.fun。
ON DEFAULT VALUES OF TT.points.in.classes() ARGUMENTS? As
，TT.points.in.classes（）参数的默认值？如
TT.points.in.classes() shares
TT.points.in.classes（股）
its arguments with many other functions, their default value
它的参数与许多其他的功能，它们的默认值
is not defined in TT.points.in.classes() source code, but rather in
TT.points.in.classes（）的源代码中没有定义，而是在
a dedicated list object called 'TT.par' and stored in the
称为TT.par，并存储在一个专用的列表对象
environment TT.env. The function TT.get() is used to retrieve
环境TT.env。的的功能TT.get（）用于检索
the default value of the arguments defined in TT.par (see
在TT.par定义的参数的默认值（见
?TT.get). For instance, to know the default value of 'class.sys',
？TT.get）。例如，要知道的默认值“class.sys”的，
you can type TT.get("class.sys"). To set a different default
你可以输入TT.get（“class.sys）。要设置不同的默认
value for a given argument in R, use TT.set() (see ?TT.set).
在R给定的参数值中，使用TT.set（）（见TT.set）。
For instance to change the default value of 'class.sys', type
例如要更改默认值“class.sys”，
TT.set( "class.sys" = "USDA.TT" ).
TT.set（“class.sys”=“USDA.TT”）。
用法----------Usage----------
TT.points.in.classes(tri.data,
class.sys = NULL,
PiC.type = NULL,
css.names = NULL,
text.sum = NULL,
base.css.ps.lim = NULL,
tri.css.ps.lim = NULL,
dat.css.ps.lim = NULL,
css.transf = NULL,
text.transf.fun = NULL,
trsf.add.opt1 = NULL,
trsf.add.opt2 = NULL,
text.tol = NULL,
tri.sum.tst = NULL,
tri.pos.tst = NULL,
collapse = NULL,
texture2xy = FALSE,
blr.tx = NULL,
blr.clock = NULL)
参数----------Arguments----------
参数：tri.data
Data frame. Data frame containing the CLAY, SILT and SAND 'coordinates' of the texture data points to be classified The data frame can contain more column than needed (ignored). The data frame must have column named CLAY, SILT and SAND (uppercase, the order has no importance) or named after the 'css.names' argument (alternative names). The sum of CLAY, SILT and SAND must be equal to 'text.sum' ('text.tol' determines the error tolerance).
数据框。数据框包含的粘土，粉土和沙“坐标”的纹理数据点进行分类的数据框可以包含多个列（忽略）。数据框必须有列命名为粘土，淤泥和沙子（大写字母的顺序并不重要）或命名后“css.names”参数（备选名称）。粘土，淤泥和沙子的总和必须等于text.sum“（”text.tol“确定的容错）。
参数：class.sys
Single text string. Text code of the texture classification system to be used for the classification of 'tri.data'. Possible values are "none" (no classification plotted), "USDA.TT" (USDA texture triangle), "FAO50.TT" (FAO texture triangle with a 50 microns silt-sand limit. DEFAULT VALUE), "FR.AISNE.TT" (French texture triangle of the Aisne region soil survey), "FR.GEPPA.TT" (French GEPPA texture triangle), "DE.BK94.TT" (German texture triangle), "UK.SSEW.TT" (Soil Survey of England and Wales), "AU.TT" (Australian texture triangle), "BE.TT" (Belgium texture triangle), "CA.EN.TT" (Canadian texture triangle, with English class abbreviations) and "CA.FR.TT" (Canadian texture triangle, with French class abbreviations) (see the package vignette for a complete list).
一个文本字符串。的纹理分类系统的文本代码被用于分类tri.data。可能的值是“无”（无分类标出），“USDA.TT”（USDA质感的三角形），的“FAO50.TT”（粮农组织50微米淤砂的限制，默认值为质感的三角形），“ FR.AISNE.TT“（法国埃纳省区域土壤调查的纹理三角形的），”FR.GEPPA.TT“（法国GEPPA质感的三角形），的”DE.BK94.TT“（德国质感的三角形），”英国SSEW.TT“（英格兰和威尔士）的土壤调查，的”AU.TT“（澳大利亚质感的三角形），”BE.TT“（比利时质感的三角形），”CA.EN.TT“（加拿大质地三角英语课的缩写）和“CA.FR.TT”（加拿大的纹理三角形，与法语课的缩写）（见包的完整列表的小插曲）。
参数：PiC.type
Single character string. If equal to 'n', then a table of 0, 1, 2 or 3 is outputed (0 if the sample does not belong to a class, 1 if it does, 2 if it lies on an edge and 3 if it lies on a vertex). Notice that the accuracy of the classification is not garanteed for samples lying very close to an edge, or right on it. See <http://www.mail-archive.com/r-help@r-project.org/msg96180.html>
单字符的字符串。如果等于东经，然后一个表的0，1，2或3 outputed（0，如果样品不属于一类，1，如果这样做，2，如果是在于和3的边缘上，如果是位于的顶点）。请注意，分类的准确性不保证下样品躺在非常接近边缘，或向右就可以了。见<http://www.mail-archive.com/r-help@r-project.org/msg96180.html>
参数：css.names
Vector of 3 character strings. Name of the columns in 'tri.data' that contains the CLAY SILT and SAND values, respectively. If NULL, default c("CLAY","SILT","SAND") value is assumed. Not to be confused with 'css.lab' that defines the labels of the CLAY SILT and SAND axes in the plot.
向量的3个字符的字符串。黏土质粉沙，沙值，分别包含“tri.data中的列的名称。如果为NULL，默认的c（“土”，“淤”，“沙”）的值是假定的。为了不被混淆与“css.lab定义标签的黏土质粉沙和沙轴的图。
参数：text.sum
Single numerical. Sum of the 3 particle size classes for each texture value (fixed). The real sum of the 3 particle size classes in 'tri.data' should be >= text.sum * (1-text.tol) OR <= text.sum * (1+text.tol), where 'text.tol' is an argument that can be changed. If some of the texture values don't match this requirement, an error occur (function fails) and TT.points.in.classes returns a of bad values with their actual particle size classes sum. You can 'normalise' you data table () prior to the use of TT.points.in.classes, by using the function TT.normalise.sum(), so all values match the 'text.sum' criteria. See also 'tri.sum.tst' that can be set to FALSE to avoid sum of particle size classes tests.
单一的数值。 3粒径为每个纹理值（固定）的类的总和。实际收入的3颗粒大小类在“tri.data”应该是> = text.sum *（1 text.tol）或<= text.sum的*（1 + text.tol），其中“文本。托尔“是一个参数，该参数是可以改变的。如果一些纹理值不符合此要求，出现错误（函数将失败）和TT.points.in.classes的返回一个坏的价值观，用自己的实际颗粒尺寸大小的总和。您可以标准化你的数据表（）之前使用TT.points.in.classes的，通过使用的功能TT.normalise.sum（），因此，所有的值匹配“text.sum”标准。参见“的tri.sum.tst”，可以设置为false，以避免颗粒大小类测试的总和。
参数：base.css.ps.lim
Vector of 4 numericals. Particle size boundaries (upper and lower) of the 3 particle size classes (CLAY, SILT and SAND, starting from the lower size of CLAY particles, 0, to the upper size of the SAND particles, 2000), in micrometers, FOR THE BASE SYSTEM. These particles size class limits are the references and all other texture values with different limits will be converted into that reference if (and only if) css.transf == TRUE (not default). If NULL, 'base.css.ps.lim' will be set to the default value of the texture classification system chosen ('class.sys'). The transformation function is set by 'text.transf.fun' and is a log-linear interpolation by default.
向量的4 numericals。粒子颗粒大小类（粘土，淤泥和沙子，从较低的粘土颗粒大小，0，大小的沙粒上，2000年），在微米大小的界限（上，下），对于基系统。不同的限制，这些粒子尺寸级别限制的引用和所有其他的纹理值将被转换成引用（且仅当）css.transf == TRUE（而不是默认值）。如果为NULL，base.css.ps.lim将被设置为默认值的纹理分类系统选择（class.sys）。变换函数被设置由text.transf.fun，缺省情况下，是一个对数 - 线性内插。
参数：tri.css.ps.lim
Vector of 4 numericals. Particle size boundaries (upper and lower) of the 3 particle size classes (CLAY, SILT and SAND, starting from the lower size of CLAY particles, 0, to the upper size of the SAND particles, 2000), in micrometers, FOR THE TEXTURE TRIANGLE. If not NULL, different from 'base.css.ps.lim', and css.transf == TRUE (not default), then the CLAY SILT and SAND coordinates of the texture triangle will be converted into the 'base.css.ps.lim' reference. If NULL, 'tri.css.ps.lim' will be set to the default value of the texture classification system chosen ('class.sys'). The transformation function is set by 'text.transf.fun' and is a log-linear interpolation by default.
向量的4 numericals。颗粒大小类（粘土，淤泥和沙子，从较低的粘土颗粒大小，0，大小的沙粒上，2000年），在微米的粒度范围（上限和下限），对于纹理三角形。如果不是NULL，从“base.css.ps.lim”，并css.transf不同== TRUE（而不是默认值），然后是黏土质粉沙和沙的纹理三角形的坐标将被转换成“base.css.ps林的参考。如果为NULL，tri.css.ps.lim将被设置为默认值的纹理分类系统选择（class.sys）。变换函数被设置由text.transf.fun，缺省情况下，是一个对数 - 线性内插。
参数：dat.css.ps.lim
Vector of 4 numericals. Particle size boundaries (upper and lower) of the 3 particle size classes (CLAY, SILT and SAND, starting from the lower size of CLAY particles, 0, to the upper size of the SAND particles, 2000), in micrometers, FOR THE TEXTURE DATA TABLE ('tri.data'). If not NULL, different from 'base.css.ps.lim', and css.transf == TRUE (not default), then the CLAY SILT and SAND coordinates of the texture data in tri.data will be converted into the 'base.css.ps.lim' reference. If NULL, 'tri.css.ps.lim' will be set to the default value of the texture classification system chosen ('class.sys'). The transformation function is set by 'text.transf.fun' and is a log-linear interpolation by default.
向量的4 numericals。颗粒大小类（粘土，淤泥和沙子，从较低的粘土颗粒大小，0，大小的沙粒上，2000年），在微米的粒度范围（上限和下限），对于纹理数据表（tri.data）。如果不是NULL，从“base.css.ps.lim”，并css.transf不同== TRUE（而不是默认值），然后是黏土质粉沙和沙坐标tri.data的纹理数据将被转换成“碱基。css.ps.lim参考。如果为NULL，tri.css.ps.lim将被设置为默认值的纹理分类系统选择（class.sys）。变换函数被设置由text.transf.fun，缺省情况下，是一个对数 - 线性内插。
参数：css.transf
Single logical. Set to TRUE to transform the texture coordinates of the texture triangle ('class.sys') or the texture data ('tri.data') into the base particle size class limits. See 'base.css.ps.lim' for the base plot particle size class limits, 'tri.css.ps.lim' for the triangle particle size class limits and 'dat.css.ps.lim' for the data table particle size class limits. The transformation function is set by 'text.transf.fun' and is a log-linear interpolation by default. The default value is FALSE, so no transformation is made.
单一的逻辑。设置为TRUE时，变换的纹理坐标的纹理三角形（class.sys）或纹理数据（tri.data）到基体颗粒大小级限制。请参阅“base.css.ps.lim”的基本图粒径级限制，的“tri.css.ps.lim”的三角形粒径类限制和的“dat.css.ps.lim”的数据表颗粒大小类的限制。变换函数被设置由text.transf.fun，缺省情况下，是一个对数 - 线性内插。默认值是FALSE，所以没有改造而成。
参数：text.transf.fun
R function with the same argument names and same output as the function TT.text.transf(). 'text.transf.fun' is the function that transform the texture values from one system of particle class size limits to another. Only used if css.transf == TRUE. Default value is text.transf.fun=TT.text.transf. See also 'base.css.ps.lim', 'tri.css.ps.lim' and 'dat.css.ps.lim'.
R的功能的的功能TT.text.transf（）使用相同的参数名称和相同的输出。 “text.transf.fun的功能是，将纹理值从一个系统的颗粒级的大小限制到另一个。仅用于css.transf == TRUE。默认值是text.transf.fun = TT.text.transf。参见“base.css.ps.lim”，“tri.css.ps.lim”和“dat.css.ps.lim的。
参数：trsf.add.opt1
Non pre-defined format. If the user specifies its own texture transformation function in 'text.transf.fun' (not TT.text.transf()), then he can use 'trsf.add.opt1' and 'trsf.add.opt1' as new, additional, argument for his function. So the format of 'trsf.add.opt1' depends on the function defined by the user in 'text.transf.fun'.
非预定义的格式。如果用户指定自己的纹理变换功能“text.transf.fun”（，不TT.text.transf（）），那么他就可以使用“trsf.add.opt1”和“trsf.add.opt1”作为新的，另外，他的功能参数。所以trsf.add.opt1的格式取决于由网站用户在text.transf.fun定义的功能。
参数：trsf.add.opt2
Non pre-defined format. If the user specifies its own texture transformation function in 'text.transf.fun' (not TT.text.transf()), then he can use 'trsf.add.opt1' and 'trsf.add.opt1' as new, additional, argument for his function. So the format of 'trsf.add.opt1' depends on the function defined by the user in 'text.transf.fun'.
非预定义的格式。如果用户指定自己的纹理变换功能“text.transf.fun”（，不TT.text.transf（）），那么他就可以使用“trsf.add.opt1”和“trsf.add.opt1”作为新的，另外，他的功能参数。所以trsf.add.opt1的格式取决于由网站用户在text.transf.fun定义的功能。
参数：text.tol
Single numerical. Tolerance on the sum of the 3 particle size classes. The real sum of the 3 particle size classes in 'tri.data' should be >= text.sum * (1-text.tol) OR <= text.sum * (1+text.tol). See 'text.sum' for more details, as well as 'tri.sum.tst' (to prevent texture sum tests).
单一的数值。公差的总和3粒径类的。 3粒径类在tri.data真正的总和应该是> = text.sum *（1-text.tol）OR <= text.sum的*（1 + text.tol）。有关详细信息，请参阅“text.sum”，以及“tri.sum.tst”（防止纹理和检验）。
参数：tri.sum.tst
Single logical. If TRUE (the default), the sum of the 3 texture classes of each texture value in 'tri.data' will be checked in regard to 'text.sum' and 'text.tol'. If FALSE, no test is done.
单一的逻辑。如果为True（默认值），3个纹理类的每个纹理值在“tri.data”的总和将被中关于“text.sum”和“text.tol检查。如果为FALSE，没有进行测试。
参数：tri.pos.tst
Single logical. If TRUE (the default), the position of texture values in 'tri.data' are tested to check that they are not OUTSIDE the texture triangle (i.e. that some texture values may be negative).
单一的逻辑。如果是TRUE（默认值），位置的纹理值在“tri.data”的测试，以确定它们是不是外面的的纹理三角形（即一些纹理值可能为负）。
参数：collapse
Single character string. If PiC.type = "t" and a sample lie on the edge of 2 texture classes, then both will be outputed in a single character string, separated by 'collapse'. Example of output: [1] "C" "VF, F" "C" "C" "M"
单字符的字符串。如果PiC.type =“t”和样本谎言的边缘上的2个纹理类，则都将被outputed一个字符中的字符串中，分隔的“崩溃”。输出示例：[1]“C”“VF，F”“C”“C”，“M”
参数：texture2xy
Single logical. Set to FALSE to avoid any transformation of the texture data (trigonometric) prior to testure data classification. Setting to FALSE avoid some numerical accuracy problems when a point is on the border of a texture class.
单一的逻辑。设置为false，以避免任何转换之前testure数据分类的纹理数据（三角）。设置为false可避免一些数值精度问题，当一个点是在边框的质感一流。
参数：blr.tx
Vector of 3 character strings. The 1st, 2nd and 3rd values must be either CLAY, SILT or SAND, and determines the particle size classes associated with the BOTTOM, LEFT and RIGHT axis, respectively. CLAY, SILT and SAND order in the vector is free, but they should all be used one time. The CLAY, SILT and SAND names must appear whatever the corresponding columns names in 'tri.data' (eventually set by 'css.names') and whatever the labels of the axis in the plot (eventually set by 'css.lab')
向量的3个字符的字符串。第1，第2和第3的值必须是粘土，粉土或沙子，确定的粒度关联的类的底部，左，右轴，分别。粘土，淤泥和沙子顺序的向量是免费的，但他们都应该使用一次。粘土，淤泥和沙子的名称必须出现在的“tri.data”（最终由“css.names”）和任何轴的图（最终由“css.lab”的标签对应的列名）
参数：blr.clock
Vector of logicals, eventually with NA values. Direction of increasing texture values on the BOTTOM, LEFT and RIGHT axis, respectively. A value of TRUE means that the axis direction is clockwise. A value of FALSE means that the axis direction is counterclockwise. A value of NA means that the axis direction is centripetal. Possible combinations are c(T,T,T); c(F,F,F); c(F,T,NA) and c(T,NA,F), for fully clockwise, fully counterclockwise, right centripetal and left centripetal orientations, respectively.
向量的逻辑，最终NA值。在底部，左，右轴，分别增加纹理值的方向。值TRUE表示轴的方向为顺时针方向。值FALSE表示轴的方向为逆时针的。 NA值意味着轴的方向是向心的。可能的组合是c（T，T，T），C（F，F，F）C（F，T，NA）和c（NA，T，F），完全按顺时针方向，逆时针方向完全，右心和左心的方向。
（作者）----------Author(s)----------
Julien MOEYS <jules_m78-soiltexture@yahoo.fr>, contributions from Wei Shangguan.
实例----------Examples----------
# Create a dummy data frame of soil textures:[土壤质地创建一个虚拟的数据框：]
my.text <- data.frame(
"CLAY" = c(05,60,15,05,25,05,25,45,65,75,13,47),
"SILT" = c(05,08,15,25,55,85,65,45,15,15,17,43),
"SAND" = c(90,32,70,70,20,10,10,10,20,10,70,10),
"OC" = c(20,14,15,05,12,15,07,21,25,30,05,28)
) #[]
# Display the table:[显示表：]
my.text
# Classify according to the FAO classification[根据联合国粮农组织的分类分类]
TT.points.in.classes(
tri.data = my.text[1:5,],
class.sys = "FAO50.TT"
) #[]
# Classify according to the USDA classification[根据美国农业部的分类分类]
TT.points.in.classes(
tri.data = my.text[1:5,],
class.sys = "USDA.TT"
) #[]
# Classify according to the FAO classification, returns logicals[根据联合国粮农组织的分类分类，则返回逻辑值]
TT.points.in.classes(
tri.data = my.text[1:5,],
class.sys = "FAO50.TT",
PiC.type = "l"
) #[]
# Classify according to the FAO classification, returns text[根据联合国粮农组织的分类分类，返回文本]
TT.points.in.classes(
tri.data = my.text[1:5,],
class.sys = "FAO50.TT",
PiC.type = "t"
) #[]
# Classify according to the FAO classification, returns text, [根据联合国粮农组织的分类分类，返回文本，]
# custom class separator in case of points belonging to [分离点的情况下自定义类]
# several classes.[几类。]
TT.points.in.classes(
tri.data = my.text[1:5,],
class.sys = "FAO50.TT",
PiC.type = "t",
collapse = ";"
转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。
注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。
|
发表于 2012-9-30 11:41:50
