quarry: Create a Quarry Object

In quarrint: Interaction Prediction Between Groundwater and Quarry Extension Using Discrete Choice Models and Artificial Neural Networks

Description

This function create a S3 object of type quarry characterizing a quarry and the groundwater in the quarry's area.

A quarry object has 6 attributes, each classified (by default) in 4 modalities coded as an integer in the range [1, 4]. These attributes are grouped in 2 distinct categories:

• the geological (geological.context), hydrological (hydrogeological.context) and piezometric (piezometric.context) contexts defining the hazard that a quarry represents;

• the relative position of the quarry and the water catchments (quarry.position), the production of the catchments (production.catchment) and the potential quality (quality.catchment)of the groundwater characterising the vulnerability of the groundwater ressources.

The possible values for each attribue are described in the Argument Section.

Usage

quarry(geological.context = 1, hydrogeological.context = 1,
       piezometric.context = 1, quarry.position = 1, production.catchment = 1,
       quality.catchment = 1, ...)

## S3 method for class 'quarry'
print(x, verbose = FALSE, ...)

Arguments

geological.context	The geological context of the quarry. Characterizes the lithology and extension of the geological formation exploited in the quarry and those of the neighbouring geological formations that will govern the groundwater flow directions. By default the possible values are: 1: completely isolated by other formations with low permeability (default); 2: limited extension and partly compartmentalized; 3: local extension; 4: regional extension.
hydrogeological.context	The hydrogeological context of the quarry. Refers to the combinations of geological formations according to their hydrodynamic characteristics. By default the possible values are: 1: aquiclude formation (default); 2: aquitard formation; 3: aquifer formation; 4: carbonate aquifer formation.
piezometric.context	The piezometric context of the quarry, i.e. the altimetric level of the quarry floor. Characterizes the relative position between the quarry pit bottom and the groundwater piezometric level. By default the possible values are: 1: higher than the piezometric level of the water table (default); 2: lower than the piezometric level of the water table but higher than the river thalweg which is the regional base level; 3: lower than the piezometric level of the water table and the altimetric level of the river thalweg which is the regional base level; 4: lower than the piezometric level of the water table and the altimetric level of the river thalweg which is not the regional level any more (the river is perched).
quarry.position	Relative position of the quarry and the water catchments. By default the possible values are: 1: outside the drainage zone of a catchment (default); 2: in the drainage zone of a catchment; 3: in the distant prevention area of a catchment; 4: in the close prevention area of a catchment.
production.catchment	Production of the catchments. Volume exploited in catchments for public distribution in the hydrogeological formation near the quarry. By default the possible values are: 1: lower than 2 m3/h (default); 2: between 2 and 10 m3/h; 3: between 10 and 30 m3/h; 4: greater than 30 m3/h.
quality.catchment	Potential quality of the catchments. Quality and the potability of the groundwater. By default the possible values are: 1: poor quality (default); 2: water potabilisable with minor treatment 3: good quality water; 4: water of exceptional quality (mineral water).
verbose	If set to TRUE, then the print method will print the description of parameters' values instead of the integer value. Default is FALSE. Note that this parameter is only meaningfull when the parameters have values in the default range [1, 4].
...	Further arguments passed to or from other methods. For instance if the values of the variables must be in the range [l, u] instead of [1, 4], then it can be achieved using low.bound = l and up.bound = u as the function relies on int.in.range.
x	An object of type quarry.

Value

A quarry object consisting of a list whose elements are

G	The geological context of the quarry.
H	The hydrogeological context of the quarry.
Z	The piezometric context of the quarry.
C	The relative position of the quarry and the water catchment.
T	The production of the water catchments.
L	The potential quality of the water catchments.
G.dummy	A vector of binary components for the dummy variable encoding of G.
H.dummy	A vector of binary components for the dummy variable encoding of H.
Z.dummy	A vector of binary components for the dummy variable encoding of Z.
C.dummy	A vector of binary components for the dummy variable encoding of C.
T.dummy	A vector of binary components for the dummy variable encoding of T.
L.dummy	A vector of binary components for the dummy variable encoding of L.

Note

By default, the modalities are integer in [1,4], but that can be changed to be an integer in any given range by passing in ... the arguments low.bound and up.bound of the function int.in.range.

Author(s)

Johan Barthelemy.

Maintainer: Johan Barthelemy [e-mail].

References

Barthelemy, J., Carletti, T., Collier L., Hallet, V., Moriame, M., Sartenaer, A. (2016) Interaction prediction between groundwater and quarry extension using discrete choice models and artificial neural networks Environmental Earth Sciences (sumbitted)

Collier, L., Barthelemy, J., Carletti, T., Moriame, M., Sartenaer, A., Hallet, V. (2015) Calculation of an Interaction Index between the Extractive Activity and Groundwater Resources Energy Procedia 76, 412-420

See Also

int.in.range to a use custom range for the values of the paramters.

print to print a quarry object.

as.data.frame to coerce a quarry to a data frame.

compute.interaction to predict the interaction between between the quarry and the groundwater.

Examples

# creating a quarry for which every parameter is within the default range
q1 <- quarry(geological.context = 2, hydrogeological.context = 4,
             piezometric.context = 1, quarry.position = 4,
             production.catchment = 4, quality.catchment = 3)
print(q1, verbose = TRUE)

# creating a quarry for which the parameters are within a custom range [0, 10]
q2 <- quarry(geological.context = 8, hydrogeological.context = 4,
             piezometric.context = 0, quarry.position = 4,
             production.catchment = 6, quality.catchment = 3,
             low.bound = 0, up.bound = 10)
print(q2)

quarrint documentation built on May 1, 2019, 10:10 p.m.