consulta_muestras: Consultar muestras de parámetros de infambiental
In jumanbar/manoSIAR: Datos y Funciones Para Trabajar con el SIA

consulta_muestras

R Documentation

Consultar muestras de parámetros de infambiental

Description

Trae datos de infambiental a través de una PostgreSQLConnection. Es el método utilizado por las aplicaciones shiny. Normalmente en vez de usar esta función, se usa el set datos_sia, que ya tiene datos extraidos y preparados para ensayar ejemplos.

Usage

consulta_muestras(
  con,
  id_matriz = 6L,
  id_programa = NULL,
  id_cuenca = NULL,
  id_sub_cuenca = NULL,
  id_estacion = NULL,
  id_tipo_punto = NULL,
  id_depto = NULL,
  id_parametro = NULL,
  id_institucion = NULL,
  usuario = NULL,
  anios = NULL,
  meses = NULL,
  fecha_ini = "1900-01-01",
  fecha_fin = Sys.Date()
)

Arguments

`con`	`PostgreSQLConnection`: objeto utilizado para conectarse con la base de datos. Ver details.
`id_matriz`	integer. Valor único. Número de matriz.
`id_programa`	integer. Vector con números id de programas. Si es `NULL` (valor por defecto), selecciona todos los programas.
`id_cuenca`	integer. Vector con números de cuenca.
`id_sub_cuenca`	integer. Vector con números de subcuenca.
`id_estacion`	Integer. Vector con números id de estaciones. Si es `NULL` (valor por defecto), selecciona todas las estaciones.
`id_tipo_punto`	integer. Vector con números que identifican el tipo de punto (1. SUPERFICIE, 2. FONDO).
`id_depto`	Integer. Vector con números id de departamentos. Si es `NULL` (valor por defecto), selecciona todos los departamentos.
`id_parametro`	integer. Vector con números id de parámetros. Si es `NULL` (valor por defecto), selecciona todos los parámetros.
`id_institucion`	integer. Vector con números id de instituciones. Si es `NULL` (valor por defecto), selecciona todas las instituciones.
`usuario`	character. Vector con nombres de usuarios encontrados en los datos. Ej.: 'jmartinez'.
`anios`	integer. Vector con los años para los que se quiere filtrar el conjunto de datos. Ej.: 2017:2019.
`meses`	integer. Vector con los números de meses para los que se quiere filtrar el conjunto de datos. Ej.: 6:12.
`fecha_ini`	`character`. Fecha en formato `AAAA-MM-DD`.
`fecha_fin`	`character`. Fecha en formato `AAAA-MM-DD`.

Details

El parámetro con es un objeto utilizado para realizar la conexión con la base de datos. Específicamente, es llamado por la función DBI::dbGetQuery. La creación del objeto normalmente se hace al iniciar el servidor shiny de una aplicación (en el archivo global.R correspondiente), cuyo código está basado en este ejemplo.

Los parámetros con el prefijo id_ refieren al número de id presente en la base de datos del SIA infambientalbd.

Eliminación de datos repetidos:

En la base de datos original, hay algunos datos que se pueden encontrar repetidos, debido a que cuando se hacen sucesivos cambios, se mantienen los valores originales.

Una de estas situaciones es cuando cambia el id_estado: 1. pendiente, 2. original, 3. aprobado. En caso de encontrar un par id_muestra x id_parametro repetidos, la función elije aquel que tenga id_estado mayor.

En caso de que lo anterior no sea suficiente para desambigüar, se usa el id más reciente de la tabla datos_muestra_parametros y se descarta el resto.

Value

Una tibble, en formato largo, con las columnas:

id_muestra: integer id único de cada muestra
nro_muestra: integer nro único de para muestra provenientes del SILAD
id_estado: integer id que identifica el "estado" del dato: 1. pendiente, 2. original, 3. aprobado
nombre_programa character nombre de cada programa
id_programa: integer id único de cada programa
cue_nombre: character nombre de la cuenca
id_cuenca: integer id único de la cuenca
sub_cue_nombre: character nombre de la subcuenca
id_sub_cuenca: integer id único de la subcuenca
codigo_pto: character nombre de cada estación
id_estacion: integer id único de cada estación
tipo_punto_id: integer id único del tipo de punto
tip_pun_est_descripcion: character descripción del tipo de punto
id_depto: integer id único del departamento
departamento: character nombre del departamento
id_institucion: integer id único de la institución
institucion: character nombre de la institución que cargó el dato en el SIA
usuario: character nombre de usuario que cargó el dato en el SIA
periodo: character asignación de mes y año para cada campaña de muestreo.
anio: character año en que fue tomada la muestra
mes: character mes en que fue tomada la muestra
anio_mes: character año+mes en que fue tomada la muestra
fecha_muestra: Date fecha en que fue tomada la muestra
fecha_hora: character fecha y hora en que fue tomada la muestra, en formato "yyyy-mm-dd HH:MM:SS"
observaciones: character observaciones para el dato
id_matriz: integer id único de la matriz
id_parametro: integer id único de cada parámetro
parametro: character nombre extendido del parámetro
nombre_clave: character código único del parámetro
id_unidad: integer id único de las unidades de medida
uni_nombre: character notación de las unidades de medida
valor_minimo_str: character con el valor ingresado para el parámetro
limite_deteccion: character con el valor del límite de detección ingresado para el parámetro
limite_cuantificacion: character con el valor del límite de cuantificación ingresado para el parámetro

Examples

## Not run: 
# ConexiÃ³n con la base de datos:
con <- DBI::dbConnect(RPostgres::Postgres(), dbname = "infambientalbd",
                      host = "172.20.0.34", port = 5432,
                      user = "shiny_usr", password = "shiny_passwd")

# Todas las muestras de todos los programas en el aÃ±o 2019:
consulta_muestras(con, fecha_ini = "2019-12-24", fecha_fin = "2019-12-31")
consulta_muestras(con, id_programa = 1L,
                  id_estacion = c(100054L, 100061L, 100063L, 100172L),
                  id_parametro = c(2009L, 2020L),
                  fecha_ini = "2017-10-31", fecha_fin = "2019-10-31")

## End(Not run)

jumanbar/manoSIAR documentation built on April 25, 2022, 1:35 p.m.