Helpfile VanWirdum-package

0. Description
1. VanWirdum-package
2. function vanwirdum()
3. data LAT-framework
4. data RHdata
5. contact



0. Description

Package: VanWirdum
Type: Package
Title: Framework for creating the Van Wirdum LATdiagram
Version: 1.0
Date: 2012-11-06
Author: M.P. Weeber; J. Rozemeijer; J. Klein
Maintainer: M.P. Weeber <marc Dot weeber At deltares Dot nl>

Description: 		The Van Wirdum package was issued on the symposium of Van Wirdum 		
			at 22 november 2012. The package contain the famous Van Wirdum LAT 			
			Diagramm, an diagramm which makes it possible to plot the electric 			
			conductivity (EC25 = measured at 25 degrees Celsius)on a logaritmic 			
			scale (LOG10) against the ionizing radiation (IR). The IR consists of the 			
			balance between Calcium and Chloride according to the formula IR =  (   			
			(Ca / 20) / (  (Ca / 20) + (Cl / 35.5)  )   ) * 100 . The plot indicates whether 			
			the measured water shows more comparison in IR and EC25 to 				
			atmotrophic rainwater(At), lithotropic high IR groundwater(Li) or 				
			thalassotrophic sea water (Th). The borderframework around these 				 
			referencepoints origins from fieldmeasurements by Van Wirdum. 				 
			Rhine(Rh) water has been an important comparison factor in his research.  
			License: Free distribution



1. Helpfile VanWirdum-package

Name = VanWirdum-package
Alias = VanWirdum-package
Title = The package supports the function vanwirdum

Description  = 		The function vanwirdum()is a graph containing the EC at a logaritmic scale 	
			plotted against the IR. The graph is supported by the LAT framework, designed 	
			by Van Wirdum from multiple measurements, which indicates whether the plotted 	
			value shows simularities to atmotrophic rainwater(At), lithotropic high IR 	
			groundwater(Li) or thalassotrophic sea water(Th). For an extra comparison the		 
			Rhine water at Lobith in 1975 has been added to the plot (Rh). This package was		 
			realeshed in honor of G. Van Wirdum during his retirement symposium on 22 	
			november 2012. }  

Details = 
		Package: \tab VanWirdum\cr
		Type: \tab Package\cr
		Version: \tab 1.0\cr
		Date: \tab 2012-11-06\cr
		License: \tab Free distribution 

Author = M.P. Weeber <marc Dot weeber At deltares Dot nl>}
References =	VanWirdum 1990, Vegetation and hydrology of rich fens, Datawyse, Maastricht, 310 p. (ISBN 90-5291-045-6)



2. function vanwirdum()

name = vanwirdum
alias = vanwirdum
title = Van Wirdum LAT diagram

description = 	Creates a Van Wirdum LAT diagram on the electric conductivity (EC25) 	
	      	and ionization ratio (IR)}

usage = vanwirdum(EC, IR, group, pointcolor , pointsize, add2plot)}

arguments =
  EC   		= 	electric conductivity measured at 25 degrees Celsius (EC25)in surface or 	
		  	aquifer. Allowed range is 0 to 10.000 . Default = 0 . }
  IR 		= 	ionization ratio (IR) calculated from the Calcium and Chloride concentration 	
		  	in the water with the formula IR =  (   (Ca / 20) / (  (Ca / 20) + (Cl / 35.5)  )   ) * 	
		  	100. Allowed range is 0 to 100. Default = 0 . }
  group 	= 	indicates groups and gives them a different color."group" class should be 	
		  	factor, character or numeric. "group" should be set per row of the dataset. "group" 	
	          	is limited to 44 different groups. Does not indicate which color is appointed to 	
		  	which group. Default = no groups}
  pointcolor 	= 	sets col. Indicates the color appointed to the plotted point."pointcolor" 
		  	class should be character or numeric. "pointcolor" should be set 	
		  	per row of the dataset. "pointcolor" can be used to indicate groups with a self set 	
		  	color. Default = "red" .}
  pointsize 	= 	sets cex. Indicates the size appointed to the plotted point. "pointsize" 	
		  	should be set per row of the dataset. Pointsize can be used to differentiate among 	
		  	the plotted points. Default = 0.5 .} 
  add2plot 	= 	indicates whether a new plot should overwrite the previous plot. Set by 	
		  	TRUE or FALSE. Default = FALSE .}  

value = a graph containing the EC at a logaritmic scale plotted against the IR. 
	The graph is supported by the LAT framework, designed by Van Wirdum from multiple 	
	measurements, which indicates whether the plotted value shows simularities to atmotrophic rainwater(At), 
	lithotropic high IR groundwater(Li) or thalassotrophic sea water(Th). For an extra comparison the Rhine water at Lobith in 1975 has 	
	been added to the plot (Rh).} 

references = VanWirdum 1990, Vegetation and hydrology of rich fens, Datawyse, 	Maastricht, 310 p. (ISBN 90-5291-045-6); http://publicwiki.deltares.nl/display/VWD/Home 
author = M.P. Weeber, J. Rozemeijer, J. Klein
note = This package was produced in honor of the retirement symposium of G. Van Wirdum

example =	
		data(RHdata, package = "VanWirdum"

		#Plot all data
		vanwirdum(EC = RHdata$EC, IR = RHdata$IR)
		#Plot the different groups
		vanwirdum(EC = RHdata$EC, IR = RHdata$IR, group = RHdata$Period)
		#Plot the periods according to a self set color and add legend and title
		opar <- par(mar = c(5, 5, 3, 8))
		{
		vanwirdum(EC[Period=="Summer"],IR[Period=="Summer"],pointcolor="red",add2plot=FALSE)
		vanwirdum(EC[Period=="Winter"],IR[Period=="Winter"],pointcolor="blue",add2plot=TRUE)
		vanwirdum(EC[Period=="Autumn"],IR[Period=="Autumn"],pointcolor="brown",add2plot=TRUE)
		vanwirdum(EC[Period=="Spring"],IR[Period=="Spring"],pointcolor="green",add2plot=TRUE)
		}
		par(xpd = TRUE)
		legend(x = log10(30000),y = 100, legend = c("Summer","Winter","Autumn","Spring"),col = c("red","blue","brown","green"), pch = 15)
		mtext("Data of 'Ronde Hoep',The Netherlands", side = 3, line = 1)
		par(opar)



3. data LAT framework

name = LAT.framework
alias = LAT.framework
title = LAT framework
description = LAT framework originating from Van Wirdum 1990
usage = data(LAT.framework)

format = 
  	A data frame with 42 observations on the following 2 variables.
  	
   		item = EC25 = a numeric vector
   		item = IR = a numeric vector
 		   
details = 	This LAT framework have been derived by Van Wirdum from multiple 	
		experiments and gives an overview of the quality border of natural water to its 	
		origin based on the electric conductivity (EC25) and ionization ratio (IR) .

source = VanWirdum 1990, Vegetation and hydrology of rich fens, Datawyse, Maastricht, 	310 p. (ISBN 90-5291-045-6)}
references = VanWirdum 1990, Vegetation and hydrology of rich fens, Datawyse, 	Maastricht, 310 p. (ISBN 90-5291-045-6)}

examples =
		data(LAT.framework)
		lines(x =log10(LAT.framework$EC25),y = LAT.framework$IR)



4. data RHdata

name = RHdata
title = Data 'Ronde Hoep' 2010-2012
description = 	Data collected in 2010-2012 in the polder Ronde Hoep, the Netherlands. 	
		This polder experiences periodic influence of brakish water.
usage = data(RHdata)

format = 
  	A data frame with 92 observations on the following 6 variables.
  		item = datum 		= a factor indicating the date of measurement
   		item = jaargetijde 	= a factor indicating the period of the year
    		item = maand 		= a numeric indicating the month of the year
 		item = locatienummer 	= a factor indicating the locations of measurement
    		item = EC 		= a numeric indicating the electric conductivity (EC25)
   		item = IR		= a numeric indicating the ionization ratio (IR)
  		

details = 	A dataset collected in polder De Ronde Hoep in 2010. De Ronde Hoep is a polder in the Netherlands 
		which is in 2006 appointed as nature reserve and a birds resting area. This dataset gives the input 
		data for making VanWirdum-diagrams of surface water quality data from 7 monitoring locations. De Ronde Hoep 
		is known for the inlet of brackisch (thalassocline) water during dry periods, which causes a seasonal shift 
		in the position in the van Wirdum diagrams. Therefore, month numbers and seasons are added to the dataset. 

source = 	The measurements were done by Johan Loermans and Fons Smolders of BWare. The measurements were part of a study 
		on flexible water level management.

references = 	STOWA, 2012, Hoofdrapport Flexibel peilbeheer

examples = 
		data(RHdata)
		str(RHdata)



5. contact

For further questions about this function contact J. Rozemeijer <joachim Dot rozemeijer At deltares Dot nl> or M.P. Weeber (Deltares) <marc Dot weeber At deltares Dot nl>