Transmissividade                package:unknown                R Documentation

CALCULA A TRANSMISSIVIDADE A PARTIR DE ENSAIOS HIDRAULICOS TIPO SLUG


Description:

     Função para calcular a transmissividade de aquíferos ou trechos discretos destes
	a partir de ensaios hidráulicos do tipo slug (Butler, 1998). A solução analítica 
	utilizada é Hvorslev (1951). A função abre o arquivo de dados brutos gerados em 
	campo pelos sensores e retorna o valor da transmissividae.


Usage:

     transmissividade (dados, diam, rinf, L)


Arguments:

	dados: tabela no formato txt contendo os dados do ensaio tipo slug para o calculo 
	da transmissividade. Os registros da tablea devem ser dados numéricos contendo os 
	registros do sensor de pressão (em PSI), temperatura (ºC) e data/hora.

	diam: número com intervalo de 25.4 < diam < 305 correspondente ao diâmetro do poço 
	onde foi realizado o ensaio (unidade considerada em mm).

	rinf: número inteiro no intervalo 1 < rinf < 1000 representando o raio de influência
	do ensaio (unidade considerada em m).

 	L: número maior que zero correspondente ao comprimento do intervalo ensaiado 
	(unidade considerada em m).


Details:

	Os “dados” de entrada podem ter diferentes campos e nomes desde que sejam respeitados
	os nomes das três colunas que são utilizadas para o calculo da transmissividade 
	(TIMESTAMP, Int_Temp, Int_Psi). O método de interpretação de Hvorslev contempla os
	casos de aquíferos confinados não drenantes e aquiferos livres ensaiados com poços
	afogados.


Value:

	Gráfico com todos os dados importados da tabela “dados” com a pressão já convertida de
	PSI para mH2O
	
	Gráfico com os dados após o início do ensaio

	Gráfico com os dados normalizados após o início do ensaio e a reta da regressão linear 
	de todo esse conjunto de dados

	Gráfico  com o melhor coeficiente de correlação no intervalo de 5 a 80% dos dados de 
	variação da pressão no ensaio e a reta da regressão linear cuja inclinação é utilizada
	para o cálculo da transmissividade

	Gráfico com os dados normalizados após o início do ensaio e as retas da regressão linear 
	de todo conjunto de dados e com o melhor coeficiente de correlação

	Tabela com o resultado do cálculo da transmissividade e os principais parâmetros utilizados
	e indicadores de qualidade da interpretação para o usuário:
	-Transmissividade em m2/s
	-coeficiente de correlação do conjunto de dados utilizado (R2)
	-raio de influencia fornecido pelo usuário (rinf)
	-diâmetro do poço
	-tempo do ensaio utilizado na interpretação da transmissividade (t.ensaio)
	-deslocamento máximo observado no ensaio (h.max)


Warning:

	Caso algum dos argumentos inserido esteja fora das especificações a função não é executada 
	e os seguintes avisos são gerados pela função:

		-valor não numérico ou diâmetro fora da faixa de 25.4 a 305 mm

		-rinf precisa ser numero inteiro entre 1 e 1000

		-L precisa ser numérico e > 0

		-campo data TIMESTAMP está fora do formato

		-coluna de dados Int_Psi não é um vetor numérico

		-coluna de dados Int_Temp não é um vetor numérico


	Na etapa de verificação e ajuste dos dados, uma mensagem automática é gerada dizendo o número
	de registros excluidos por apresentarem valor NA

	Ao final da função uma mensagem automática é gerada dizendo o número de registros utilizados
	na interpretação da transmissividade
	 

Author(s):

     Marcos Bolognini Barbosa
	e-mail: marbbar@usp.br


References:

     Butler, J.J., Jr., Duffield, G.M. and D.L. Kelleher, 2011. Field Guide for Slug Testing and 
	Data Analysis, Midwest Geosciences Group Press.

	Hvorslev, M.J., 1951. Time Lag and Soil Permeability in Ground-Water Observations, Bull. 
	No. 36, Waterways Exper. Sta. Corps of Engrs, U.S. Army, Vicksburg, Mississippi, pp. 1-50.


Examples:

transmissividade(dados="Slug_1503.txt",diam=152.24,rinf=30,L=2)

transmissividade(dados="Slug_Ergomat.txt",diam=50.8,rinf=30,L=2)

transmissividade(dados=“Pat.txt",diam=50.8,rinf=30,L=2)