This is a work in progress, please see the in-line comments for a description of what is going on here.

# load required libraries
library(soilDB)
library(aqp)
library(sharpshootR)
library(sp)

# sample data from soilDB packaeg
data("loafercreek")

# keep first 10 profiles
x <- loafercreek[1:10, ]

# default margins are too wide, make smaller
par(mar=c(1,1,2,1))

# profile sketches
plot(x, label='pedon_id')

# group profiles by hillslope position
groupedProfilePlot(x, 'hillslopeprof', label='pedon_id')

# extract site data so that we can annotate wit PSCS depths
s <- site(x)

# reminder of ID used by SPC
idname(x)
## [1] "peiid"
# subset site data into ID and PSCS top / bottom 
s <- s[, c('peiid', 'psctopdepth', 'pscbotdepth')]

# re-name for addBrackets() function
names(s)[2:3] <- c('top', 'bottom') 

# plot sketches and annotate with PSCS
par(mar=c(1,1,1,1))
# ommit pedon IDs for now
plot(x, print.id=FALSE)
# add PSCS brackets as vertical var
addBracket(s, tick.length = 0, lwd=10, col=rgb(red=0, green=0, blue=1, alpha=0.25))

# check structure of diagnostic horizon data
head(diagnostic_hz(x))
##    peiid           featkind featdept featdepb
## 1  64505    ochric epipedon        1        5
## 2  64505   argillic horizon       15       79
## 3  64505 paralithic contact       79      107
## 4  64505     lithic contact      107       NA
## 5 115595    ochric epipedon        0       10
## 6 115595   argillic horizon       10       74
# tabulate and sort
sort(table(diagnostic_hz(x)$featkind))
## 
##                       anthropic epipedon                   abrupt textural change 
##                                        0                                        0 
##                    andic soil properties                           cambic horizon 
##                                        0                                        0 
##                           calcic horizon                                durinodes 
##                                        0                                        0 
##                      petrocalcic horizon                                 fragipan 
##                                        0                                        0 
##                           gypsic horizon                                   gilgai 
##                                        0                                        0 
##                          glossic horizon                         aquic conditions 
##                                        0                                        0 
##                          histic epipedon                          sombric horizon 
##                                        0                                        0 
##                      petrogypsic horizon                           placic horizon 
##                                        0                                        0 
##                           kandic horizon                     secondary carbonates 
##                                        0                                        0 
##                          mollic epipedon                         melanic epipedon 
##                                        0                                        0 
##                           natric horizon                         plaggen epipedon 
##                                        0                                        0 
##                      petroferric contact                               permafrost 
##                                        0                                        0 
##                                plinthite                            albic horizon 
##                                        0                                        0 
##                            agric horizon                           spodic horizon 
##                                        0                                        0 
##                             slickensides                          umbric epipedon 
##                                        0                                        0 
##                         sulfuric horizon                             oxic horizon 
##                                        0                                        0 
##                            salic horizon                                  duripan 
##                                        0                                        0 
##                       sulfidic materials        interfingering of albic materials 
##                                        0                                        0 
##                    fibric soil materials                     hemic soil materials 
##                                        0                                        0 
##                    sapric soil materials                      humilluvic material 
##                                        0                                        0 
##                         limnic materials                        coprogenous earth 
##                                        0                                        0 
##                       diatomaceous earth                                     marl 
##                                        0                                        0 
##                          albic materials            mottles with chroma 2 or less 
##                                        0                                        0 
##                                 lamellae                                 ortstein 
##                                        0                                        0 
##                   fragic soil properties                           densic contact 
##                                        0                                        0 
##                         densic materials                     paralithic materials 
##                                        0                                        0 
##                     anhydrous conditions                            cryoturbation 
##                                        0                                        0 
##                          gelic materials                             glacic layer 
##                                        0                                        0 
##                        folistic epipedon                     redox concentrations 
##                                        0                                        0 
##   redox depletions with chroma 2 or less                           reduced matrix 
##                                        0                                        0 
##                           endosaturation                            episaturation 
##                                        0                                        0 
##                       anthric saturation                 lithologic discontinuity 
##                                        0                                        0 
## strongly contrasting particle size class                     gypsum accumulations 
##                                        0                                        0 
##                       salt accumulations                           volcanic glass 
##                                        0                                        0 
##                            n value > 0.7                         spodic materials 
##                                        0                                        0 
##                                artifacts                                   fibers 
##                                        0                                        0 
##                          free carbonates                       resistant minerals 
##                                        0                                        0 
##                     weatherable minerals                       anhydritic horizon 
##                                        0                                        0 
##                   human-altered material               human-transported material 
##                                        0                                        0 
##                       manufactured layer               manufactured layer contact 
##                                        0                                        0 
##                           lithic contact                          ochric epipedon 
##                                        2                                        9 
##                         argillic horizon                       paralithic contact 
##                                        9                                        9
# add brackets for some diagnostic features
addDiagnosticBracket(x, kind='argillic horizon', col='red')
addDiagnosticBracket(x, kind='paralithic contact', col='black')

# experiment with re-ordering sketches
# order according to elevation as described in the field
new.order <- order(x$elev_field)
new.order
##  [1]  9  2  3 10  8  1  4  5  7  6
# plot profiles in the new order
par(mar=c(4.5,1,1,1))
plot(x, plot.order=new.order, print.id=FALSE)

# the "brackets" will automatically follow the new ordering
addBracket(s, tick.length = 0, lwd=10, col=rgb(red=0, green=0, blue=1, alpha=0.25))
addDiagnosticBracket(x, kind='argillic horizon', col='red')
addDiagnosticBracket(x, kind='paralithic contact', col='black')

# add an axis with elevation associated with each profile
axis(side=1, at = 1:length(x), labels = x$elev_field[new.order], line = 1)
mtext('Elevation (m)', side = 1, line = 3.25)

## plot data as a transect, using coordinates and elevation

# initialize spatial object in SPC
coordinates(x) <- ~ x_std + y_std
# set coordinate reference system (CRS)
proj4string(x) <- '+proj=longlat +datum=WGS84'

# this example requires projected coordinates, units of meters
# we provide a local, projected CRS: UTM z10 NAD83
par(mar=c(4.5,4,1,1))
plotTransect(x, grad.var.name = 'elev_field', crs = CRS('+proj=utm +zone=10 +datum=NAD83'))

## better example from CA792
# this requires the latest soilDB from github
# devtools::install_github("ncss-tech/soilDB", dependencies=FALSE, upgrade_dependencies=FALSE)
data("mineralKing")

# init coordinates
coordinates(mineralKing) <- ~ x_std + y_std
proj4string(mineralKing) <- '+proj=longlat +datum=NAD83'

# local CRS
crs.utm <- CRS('+proj=utm +zone=11 +datum=NAD83')

par(mar=c(4.5,4,4,1))
plotTransect(mineralKing, grad.var.name='elev_field', crs=crs.utm, grad.axis.title='Elevation (m)', label='pedon_id')

plotTransect(mineralKing, grad.var.name='elev_field', crs=crs.utm, grad.axis.title='Elevation (m)', label='pedon_id', color='clay')

# load example dataset
data(gopheridge)

# randomly select 20 profiles
gopheridge <- sample(gopheridge, 20)

# define a new function
# get hz mid-point of hz with max clay content
f.max.clay.depth <- function(x) {
  h <- horizons(x)
  max.clay <- which.max(h$clay)
  res <- with(h[max.clay, ], (hzdept+hzdepb) / 2)
  return(res)
}

# apply function to each profile
# results are put into @site
gopheridge$max.clay.depth <- profileApply(gopheridge, f.max.clay.depth)


# plot and annotate with max clay depths
par(mar=c(0,0,0,0))
plot(gopheridge, name='hzname', print.id=FALSE)
x.pos <- 1:length(gopheridge)
points(x.pos, gopheridge$max.clay.depth, col='white', pch=21, cex=0.75, bg='black')

##
# see ?sp5 examples

This document is based on aqp version 1.15.4 and soilDB version 2.0-2.