Description Usage Arguments Details Value Note Author(s) References See Also Examples
Uses data from percentages of soil textures to generate ternary diagrams of Shepard (Shepard, 1954), Pejrup (Pejrup, 1988) and Flemming (Flemming, 2000)
1 2 3 4 5 6 7 8 | rysgran.ternary(x = NULL, method = "shepard", lang = "en-US",
main= NULL, z= NULL, show.labels=FALSE, label.points=FALSE,
labels = NULL, axis.labels = NULL, show.names = TRUE,
show.lines = TRUE, show.legend = TRUE, show.grid = FALSE,
z.cex.range= NULL, cex.labels= 1, cex.points=1, cex.axis=1,
cex.names = 0.8, col.names = "gray2", col = "black",
col.labels= "black", col.axis= "black", col.lines= "black",
col.grid = "gray", pos = 1, pch = 19, lty.grid = 3, ...)
|
x |
a 3 columns matrix with percentages of Sand, Silt and Clay (exactly in this order) which should be passed by |
method |
shape of ternary diagram to be created. Should be "shepard", "pejrup" or "flemming". Default is "shepard" |
lang |
language . Should be English ("en-US", "en-GR", "eng", "e"), or Portuguese ("pt-BR", "pt-PT", "port", "p"). The default is "en-US" |
main |
an overall title for the plot. If NULL it will be generated an automatic title according to language chosen. Default is NULL |
z |
vector with the same length of |
show.labels |
logical. If TRUE the points are replaced by text passed by |
label.points |
logical. if TRUE text is added, provided by the argument |
labels |
a character vector or expression specifying the text to be written. If NULL |
axis.labels |
vector of length 3 with the soil textures names. If NULL the names are taken from the matrix of percentages. Default is NULL |
show.names |
logical. If TRUE the textural classes names will show up in the ternary diagram according with the |
show.lines |
logical. If TRUE the lines that separate the textural classes are displayed. Default is TRUE |
show.legend |
logical. If TRUE the legend of textural classes are displayed in the top left according with the argument |
show.grid |
logical. If TRUE display grid lines in the ternary diagram. Default is FALSE |
z.cex.range |
Vector of length 2. Minimum and maximum 'cex' of the bubbles plotted if 'z' is not NULL. Replace the argument |
cex.labels |
character size of text provided by the argument |
cex.points |
character size of points provided by the argument |
cex.axis |
character expansion for axis labels. Default is "1" |
cex.names |
character size of text of textural classes text which composes the ternary diagram according to |
col.names |
text color of textural classes which composes the ternary diagram if the argument |
col |
symbol color used in |
col.labels |
text color of |
col.axis |
text color of axis labels. Default is "black" |
col.lines |
color of lines that separate the textural classes case the argument |
col.grid |
color of grid lines case the argument |
pos |
a position specifier for the text. Values of 1, 2, 3 and 4, respectively, indicate positions below, to the left of, above and to the right of the specified coordinates. Default is "1" |
pch |
either an integer specifying a symbol or a single character to be used as the default in plotting points. Default is "19" |
lty.grid |
type of grid line case the argument |
... |
further graphical parameters |
When z
argument is used to draw bubble plots the legend.bubbles
function should be used to draw the legend accordingly
Display a triangular plot
rysgran.ternary can only properly display one or more sets of three proportions (sand, silt and clay) that each sum to 1 (or percentages that sum to 100), otherwise they will not plot properly and the user will be notified. Samples with considerable amount of gravel are not properly plotted. rysgran.ternary is based on plotrix package and depends on soiltexture package
Eliandro R. Gilbert (eliandrogilbert@gmail.com)
- Flemming, B. W. (2000) A revised textural classification of gravel-free muddy sediments on the basis of ternary diagrams. Continental Shelf Research, 20:1125–1137.
- Pejrup, M. (1988) The triangular diagram used for classification of estuarine sediments: a new approach. in: Tide-influenced sedimentary environments and facies. BOER, P.L. ; GELDER, A. & NIO, S.D. (Eds). D. Reidel Publishing Company. Holland.
- Shepard, F. P. (1954) Nomenclature based on sand-silt-clay ratios. Journal Sedimentary Petrology, 24:151–158.
gran.stats
, class.percent
, rysgran.ternary
, rysgran.hist
, legend.bubbles
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 | library(rysgran)
data(camargo2001)
data(sed.phi)
#Shepard diagram
percent <- class.percent(camargo2001, mode="total")
x<-percent[2:4] #choosing only the 'sand', 'silt' and 'clay' columns
rysgran.ternary (x, method = "shepard")
#Pejrup diagram
percent <- class.percent(camargo2001, mode="total")
x<-percent[2:4] #choosing only the 'sand', 'silt' and 'clay' columns
rysgran.ternary (x, method = "pejrup")
#Flemming diagram
percent <- class.percent(camargo2001, mode="total")
x<-percent[2:4] #choosing only the 'sand', 'silt' and 'clay' columns
rysgran.ternary (x, method = "flemming")
#Shepard diagram with show.labels
percent <- class.percent(camargo2001, mode="total")
x<-percent[2:4]
rysgran.ternary (x, method="shepard", show.labels = TRUE)
#Pejrup diagram with Sorting as bubbles for different environments
#Calculating the percentage of weight in each textural class
percent <- class.percent(sed.phi, mode="total")
x<-percent[2:4]
# Calculating the grain size statistics
rys <- gran.stats(sed.phi , method="folk")
env<- as.factor(rep(c("River","Tidal Flat","Subtidal","Beach"),each=10))
# Plotting
rysgran.ternary (x, method = "pejrup",
z = rys$Sorting, z.cex.range = c(0.5,3),
col = c("red","blue","black","brown")[env], pch = 19)
# Plotting the legends
legend.bubbles ("right", z=rys$Sorting , nleg=4, pch=21, col="black",
cex=1, z.cex.range=c(0.5,3), x.intersp=1.2, y.intersp=1.2,
digits=1, title="Sorting")
legend ("topright", c("Beach","River","Subtidal","Tidal Flat"),
pch=15, col=c("red","blue","black","brown"))
|
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.