1 Configuración y Carga de Datos

Se carga el archivo de producción de petróleo y gas natural por pozo en tierra de Brasil, publicado por la ANP (Agência Nacional do Petróleo, Gás Natural e Biocombustíveis), correspondiente a enero de 2023. El archivo debe estar en la misma carpeta que este documento; si no se encuentra, se abre una ventana para elegirlo.

library(readr)
library(dplyr)
library(gt)

autor <- "Grupo Brasil"   # cambia aquí el nombre del autor o del grupo

ruta_archivo <- "2023_01_producao_Terra.csv"
if (!file.exists(ruta_archivo)) ruta_archivo <- file.choose()

datos_brasil <- read_delim(
  ruta_archivo,
  delim     = ";",
  col_names = FALSE,
  col_types = cols(.default = col_character()),
  locale    = locale(encoding = "UTF-8")
)

cat("Base de datos cargada correctamente.\n")
## Base de datos cargada correctamente.

Las tres primeras filas del archivo son encabezados (el nombre de la columna y dos subencabezados), por eso se leen las columnas por posición y se conservan solo las filas del período 2023/01. Los números usan coma decimal y punto de miles.

a_numero <- function(x) as.numeric(gsub(",", ".", gsub(".", "", x, fixed = TRUE), fixed = TRUE))

registros <- datos_brasil %>%
  filter(X8 == "2023/01") %>%
  transmute(
    estado          = X1,
    cuenca          = X2,
    pozo            = X3,
    campo           = X5,
    operador        = X6,
    instalacion     = X18,
    oleo            = a_numero(X9),
    condensado      = a_numero(X10),
    gas_asociado    = a_numero(X12),
    gas_no_asociado = a_numero(X13),
    gas_total       = a_numero(X14),
    agua            = a_numero(X16),
    horas           = a_numero(X19),
    api             = a_numero(X22)
  ) %>%
  mutate(orden = row_number())

cat("Total de registros (filas):", nrow(registros), "\n")
## Total de registros (filas): 5471
cat("Total de pozos distintos:", n_distinct(registros$pozo), "\n")
## Total de pozos distintos: 5308

Un mismo pozo puede aparecer en varias filas (una por cada campo al que entrega producción). Se consolida un registro por pozo: los volúmenes se suman, las horas toman el máximo, y los datos cualitativos y el grado API se toman de la fila con más óleo (en caso de empate, la primera del archivo).

suma_na   <- function(x) if (all(is.na(x))) NA_real_ else sum(x, na.rm = TRUE)
maximo_na <- function(x) if (all(is.na(x))) NA_real_ else max(x, na.rm = TRUE)

pozos <- registros %>%
  arrange(desc(oleo), orden) %>%
  group_by(pozo) %>%
  summarise(
    estado          = first(estado),
    cuenca          = first(cuenca),
    campo           = first(campo),
    operador        = first(operador),
    instalacion     = first(instalacion),
    api             = first(api[!is.na(api)]),
    oleo            = suma_na(oleo),
    condensado      = suma_na(condensado),
    gas_asociado    = suma_na(gas_asociado),
    gas_no_asociado = suma_na(gas_no_asociado),
    gas_total       = suma_na(gas_total),
    agua            = suma_na(agua),
    horas           = maximo_na(horas),
    .groups = "drop"
  )

cat("Pozos consolidados:", nrow(pozos), "\n")
## Pozos consolidados: 5308

Esta variable no está en el archivo de producción: viene de la Tabela de Poços de la ANP (catastro de pozos, coordenadas en SIRGAS2000). Se usa el archivo pozos_brasil_coordenadas_ANP.csv, que tiene una fila por pozo, y se une por el nombre del pozo.

ruta_pozos <- "pozos_brasil_coordenadas_ANP.csv"
if (!file.exists(ruta_pozos)) ruta_pozos <- file.choose()

tabla_pozos <- read_csv(ruta_pozos, show_col_types = FALSE)

pozos <- pozos %>%
  left_join(
    tabla_pozos %>% select(pozo, latitud, longitud, altitud_m,
                           profundidad_perforada_m, direccion, categoria),
    by = "pozo"
  )

cat("Pozos con dato en la Tabela de Poços:", sum(!is.na(pozos$latitud)), "de", nrow(pozos), "\n")
## Pozos con dato en la Tabela de Poços: 5308 de 5308

2 Extracción y Limpieza de la Variable

Se realiza el aislamiento y limpieza de la variable Clase de profundidad (derivada de la profundidad perforada de la Tabela de Poços: Somero hasta 1.000 m, Intermedio de más de 1.000 a 3.000 m y Profundo a más de 3.000 m). Se descartan los pozos sin dato (NA).

# Somero: hasta 1.000 m; Intermedio: más de 1.000 y hasta 3.000 m; Profundo: más de 3.000 m
pozos <- pozos %>%
  mutate(clase_profundidad = case_when(
    profundidad_perforada_m <= 1000 ~ "Somero",
    profundidad_perforada_m <= 3000 ~ "Intermedio",
    profundidad_perforada_m >  3000 ~ "Profundo"
  ))

cat("Valores únicos originales en clase_profundidad:\n")
## Valores únicos originales en clase_profundidad:
print(head(sort(unique(pozos$clase_profundidad)), 20))
## [1] "Intermedio" "Profundo"   "Somero"
x_raw <- pozos %>%
  filter(!is.na(clase_profundidad)) %>%
  pull(clase_profundidad)

n <- length(x_raw)

if (n == 0) {
  stop("No se encontraron valores en clase_profundidad. Revisa los valores únicos impresos arriba.")
}

orden_logico <- c("Somero", "Intermedio", "Profundo")
x_raw <- factor(x_raw, levels = orden_logico)

cat("Observaciones válidas:", n, "\n")
## Observaciones válidas: 4806
cat("Pozos sin dato:", sum(is.na(pozos$clase_profundidad)), "\n")
## Pozos sin dato: 502
cat("Valores únicos:", length(unique(x_raw)), "\n")
## Valores únicos: 3

3 Identificación de la Variable

Se presenta la ficha técnica de identificación de la variable, especificando su naturaleza estadística y su fuente de origen.

tabla_id <- data.frame(
  Criterio = c(
    "Nombre", "Nombre técnico", "Tipo", "Subtipo",
    "Dominio", "Rango", "Unidad", "Escala", "Fuente"
  ),
  Clasificacion = c(
    "Clase de profundidad",
    "Derivada de PROFUNDIDADE_SONDADOR_M",
    "Cualitativa",
    "Ordinal",
    "{Somero < Intermedio < Profundo}",
    paste(levels(x_raw), collapse = " < "),
    "No aplica",
    "Ordinal",
    "Cálculo propio a partir de la profundidad perforada (Tabela de Poços)"
  )
)

tabla_id %>%
  gt() %>%
  tab_header(
    title = md("**Identificación de la Variable**")
  ) %>%
  cols_label(
    Criterio      = md("**Criterio**"),
    Clasificacion = md("**Clasificación**")
  ) %>%
  tab_style(
    style = list(
      cell_fill(color = "#F2C14E"),
      cell_text(color = "#0B221E", weight = "bold")
    ),
    locations = cells_column_labels()
  ) %>%
  tab_style(
    style = cell_text(color = "#0d2b24"),
    locations = cells_title(groups = "title")
  ) %>%
  tab_style(
    style = cell_fill(color = "#EDEAE4"),
    locations = cells_body(rows = seq(1, nrow(tabla_id), by = 2))
  ) %>%
  tab_source_note(source_note = md(paste0("*Autor: ", autor, "*"))) %>%
  tab_style(
    style = cell_text(color = "#8C6D46"),
    locations = cells_source_notes()
  ) %>%
  tab_options(
    table.width                = pct(70),
    heading.title.font.size    = px(16),
    heading.subtitle.font.size = px(12),
    table.font.size            = px(13),
    data_row.padding           = px(6)
  )
Identificación de la Variable
Criterio Clasificación
Nombre Clase de profundidad
Nombre técnico Derivada de PROFUNDIDADE_SONDADOR_M
Tipo Cualitativa
Subtipo Ordinal
Dominio {Somero < Intermedio < Profundo}
Rango Somero < Intermedio < Profundo
Unidad No aplica
Escala Ordinal
Fuente Cálculo propio a partir de la profundidad perforada (Tabela de Poços)
Autor: Grupo Brasil

Justificación: Las clases de profundidad están ordenadas de menor a mayor profundidad. Corresponde a una variable cualitativa ordinal.

4 Tabla de Distribución de Frecuencias

Se calcula la distribución de frecuencias absolutas (ni), porcentuales (hi%) y, por tratarse de una variable con orden natural (Somero < Intermedio < Profundo), también las frecuencias acumuladas absolutas (Ni) y porcentuales (Hi%).

# 1. Frecuencias absolutas en el orden lógico de la variable
frecuencias_base <- data.frame(
  Categoria     = levels(x_raw),
  Frecuencia_ni = as.integer(table(x_raw))
)

# 2. Porcentaje y frecuencias acumuladas
tabla_final <- frecuencias_base %>%
  mutate(
    Porcentaje_hi = (Frecuencia_ni / sum(Frecuencia_ni)) * 100,
    Frecuencia_Ni = cumsum(Frecuencia_ni),
    Porcentaje_Hi = cumsum(Porcentaje_hi)
  )

# 3. Fila TOTAL
total_fila <- data.frame(
  Categoria     = "TOTAL",
  Frecuencia_ni = sum(tabla_final$Frecuencia_ni),
  Porcentaje_hi = sum(tabla_final$Porcentaje_hi)
)

# 4. Formateo
resultado <- bind_rows(
  tabla_final %>% mutate(
    Porcentaje_hi = sprintf("%.2f", Porcentaje_hi),
    Frecuencia_Ni = as.character(Frecuencia_Ni),
    Porcentaje_Hi = sprintf("%.2f", Porcentaje_Hi)
  ),
  total_fila %>% mutate(
    Porcentaje_hi = sprintf("%.2f", Porcentaje_hi),
    Frecuencia_Ni = "—",
    Porcentaje_Hi = "—"
  )
)

# 5. Tabla GT
resultado %>%
  gt() %>%
  tab_header(
    title    = md("**Tabla N°1: Distribución de Frecuencias**"),
    subtitle = md("*Variable Cualitativa Ordinal: Clase de profundidad*")
  ) %>%
  cols_label(
    Categoria     = md("**Clase de profundidad**"),
    Frecuencia_ni = md("**Frecuencia (ni)**"),
    Porcentaje_hi = md("**Porcentaje (hi%)**"),
    Frecuencia_Ni = md("**Frec. acumulada (Ni)**"),
    Porcentaje_Hi = md("**Porc. acumulado (Hi%)**")
  ) %>%
  tab_style(
    style = list(
      cell_fill(color = "#F2C14E"),
      cell_text(color = "#0B221E", weight = "bold")
    ),
    locations = cells_column_labels()
  ) %>%
  tab_style(
    style = cell_text(color = "#0d2b24"),
    locations = cells_title(groups = "title")
  ) %>%
  tab_style(
    style = cell_fill(color = "#EDEAE4"),
    locations = cells_body(rows = seq(1, nrow(resultado), by = 2))
  ) %>%
  tab_style(
    style = list(
      cell_fill(color = "#FBEFC8"),
      cell_text(weight = "bold")
    ),
    locations = cells_body(
      rows    = Categoria == "TOTAL",
      columns = everything()
    )
  ) %>%
  tab_source_note(source_note = md(paste0("*Autor: ", autor, "*"))) %>%
  tab_style(
    style = cell_text(color = "#8C6D46"),
    locations = cells_source_notes()
  ) %>%
  tab_options(
    table.width                = pct(75),
    heading.title.font.size    = px(16),
    heading.subtitle.font.size = px(12),
    table.font.size            = px(13),
    data_row.padding           = px(6)
  )
Tabla N°1: Distribución de Frecuencias
Variable Cualitativa Ordinal: Clase de profundidad
Clase de profundidad Frecuencia (ni) Porcentaje (hi%) Frec. acumulada (Ni) Porc. acumulado (Hi%)
Somero 3306 68.79 3306 68.79
Intermedio 1380 28.71 4686 97.50
Profundo 120 2.50 4806 100.00
TOTAL 4806 100.00 — —
Autor: Grupo Brasil

5 Representación Gráfica

Se presentan cuatro gráficas en tonos amarillo y verde claro. Las categorías se dibujan siempre en su orden lógico: Somero < Intermedio < Profundo.

colores <- colorRampPalette(c("#FBEFC8", "#EDEAE4", "#0d2b24"))(nrow(tabla_final))

5.1 Gráfica N°1 — Barras de frecuencia absoluta

par(mar = c(6, 6, 5, 2))
bp1 <- barplot(tabla_final$Frecuencia_ni,
        main      = "",
        xlab      = "",
        ylab      = "",
        col       = colores,
        border    = "#8C6D46",
        ylim      = c(0, max(tabla_final$Frecuencia_ni) * 1.15),
        names.arg = as.character(tabla_final$Categoria),
        cex.names = 0.95,
        las       = 1)

mtext("Frecuencia (ni)", side = 2, line = 4.5, cex = 1, font = 1)
mtext("Clase de profundidad",      side = 1, line = 3.5, cex = 1)
mtext("Gráfica N°1: Distribución de Frecuencias Absolutas de la Variable Clase de profundidad",
      side = 3, line = 2, adj = 0.5, cex = 0.9, font = 2, col = "#0d2b24")

text(x      = bp1,
     y      = tabla_final$Frecuencia_ni,
     labels = format(tabla_final$Frecuencia_ni, big.mark = ","),
     pos    = 3, cex = 0.9, col = "#C9930A")

5.2 Gráfica N°2 — Barras de porcentaje

par(mar = c(6, 6, 5, 2))
bp2 <- barplot(tabla_final$Porcentaje_hi,
               main      = "",
               xlab      = "",
               ylab      = "Porcentaje %",
               col       = colores,
               border    = "#8C6D46",
               ylim      = c(0, max(tabla_final$Porcentaje_hi) * 1.2),
               names.arg = as.character(tabla_final$Categoria),
               cex.names = 0.95,
               las       = 1)

mtext("Clase de profundidad", side = 1, line = 3.5, cex = 1)
mtext("Gráfica N°2: Distribución Porcentual de la Variable Clase de profundidad",
      side = 3, line = 2, adj = 0.5, cex = 0.9, font = 2, col = "#0d2b24")

text(x      = bp2,
     y      = tabla_final$Porcentaje_hi,
     labels = paste0(round(tabla_final$Porcentaje_hi, 2), "%"),
     pos    = 3, cex = 0.9, col = "#C9930A")

5.3 Gráfica N°3 — Gráfico circular porcentual

par(mar = c(5, 2, 4, 10), xpd = TRUE)

pie(tabla_final$Porcentaje_hi,
    main   = "",
    radius = 1,
    labels = paste0(round(tabla_final$Porcentaje_hi, 2), "%"),
    col    = colores,
    border = "#8C6D46",
    cex    = 0.9)

mtext("Gráfica N°3: Distribución Porcentual de la Variable Clase de profundidad",
      side = 3, line = 2, adj = 0.5, cex = 0.9, font = 2, col = "#0d2b24")

legend(x      = 1.2,
       y      = 1,
       legend = as.character(tabla_final$Categoria),
       fill   = colores,
       cex    = 0.85,
       title  = "Clase de profundidad",
       bty    = "n")

5.4 Gráfica N°4 — Frecuencia porcentual acumulada (ojiva)

par(mar = c(6, 6, 5, 2))
bp4 <- barplot(tabla_final$Porcentaje_Hi,
               main      = "",
               xlab      = "",
               ylab      = "Porcentaje acumulado (Hi%)",
               col       = colores,
               border    = "#8C6D46",
               ylim      = c(0, 115),
               names.arg = as.character(tabla_final$Categoria),
               cex.names = 0.95,
               las       = 1)

lines(bp4, tabla_final$Porcentaje_Hi, type = "b", pch = 19, lwd = 2, col = "#8C6D46")
abline(h = 50, lty = 2, col = "#0d2b24")

mtext("Clase de profundidad", side = 1, line = 3.5, cex = 1)
mtext("Gráfica N°4: Distribución Porcentual Acumulada de la Variable Clase de profundidad",
      side = 3, line = 2, adj = 0.5, cex = 0.9, font = 2, col = "#0d2b24")

text(x      = bp4,
     y      = tabla_final$Porcentaje_Hi,
     labels = paste0(round(tabla_final$Porcentaje_Hi, 2), "%"),
     pos    = 3, cex = 0.9, col = "#C9930A")

6 Tabla de Indicadores

Para la variable cualitativa ordinal Clase de profundidad se informan la moda y la mediana categórica (la primera categoría cuyo porcentaje acumulado alcanza el 50 %). La media, la varianza y las demás medidas numéricas no aplican: promediar categorías ordenadas no tiene sentido.

# Moda: categoría con mayor frecuencia
moda_variable   <- as.character(tabla_final$Categoria[which.max(tabla_final$Frecuencia_ni)])
porcentaje_moda <- max(tabla_final$Porcentaje_hi)

# Mediana categórica: primera categoría con Hi% >= 50
mediana_variable <- as.character(tabla_final$Categoria[which(tabla_final$Porcentaje_Hi >= 50)[1]])

# Tabla de indicadores en formato largo
tabla_indicadores <- data.frame(
  Indicador = c(
    "Variable",
    "Tipo de variable",
    "Categorías (Rango)",
    "Moda (Mo)",
    "Mediana (Me)",
    "Media (X̄)",
    "Varianza (V)",
    "Desv. Estándar (Sd)",
    "Coef. Variación (CV%)",
    "Asimetría (As)",
    "Curtosis (K)"
  ),
  Valor = c(
    "Clase de profundidad",
    "Cualitativa Ordinal",
    paste(levels(x_raw), collapse = " < "),
    moda_variable,
    mediana_variable,
    "—",
    "—",
    "—",
    "—",
    "—",
    "—"
  )
)

# Tabla GT de indicadores
tabla_indicadores %>%
  gt() %>%
  tab_header(
    title    = md("**Tabla N°2: Indicadores Estadísticos**"),
    subtitle = md("*Variable Cualitativa Ordinal: Clase de profundidad*")
  ) %>%
  cols_label(
    Indicador = md("**Indicador**"),
    Valor     = md("**Valor**")
  ) %>%
  tab_style(
    style = list(
      cell_fill(color = "#F2C14E"),
      cell_text(color = "#0B221E", weight = "bold")
    ),
    locations = cells_column_labels()
  ) %>%
  tab_style(
    style = cell_text(color = "#0d2b24"),
    locations = cells_title(groups = "title")
  ) %>%
  tab_style(
    style = cell_fill(color = "#EDEAE4"),
    locations = cells_body(rows = seq(1, nrow(tabla_indicadores), by = 2))
  ) %>%
  tab_style(
    style = list(
      cell_fill(color = "#FBEFC8"),
      cell_text(weight = "bold")
    ),
    locations = cells_body(
      rows    = Indicador %in% c("Moda (Mo)", "Mediana (Me)"),
      columns = everything()
    )
  ) %>%
  tab_style(
    style = cell_text(style = "italic", color = "#2C3531"),
    locations = cells_body(
      rows    = Valor == "—",
      columns = Valor
    )
  ) %>%
  tab_source_note(source_note = md(paste0("*Autor: ", autor, "*"))) %>%
  tab_style(
    style = cell_text(color = "#8C6D46"),
    locations = cells_source_notes()
  ) %>%
  tab_options(
    table.width                = pct(60),
    heading.title.font.size    = px(16),
    heading.subtitle.font.size = px(12),
    table.font.size            = px(13),
    data_row.padding           = px(6)
  )
Tabla N°2: Indicadores Estadísticos
Variable Cualitativa Ordinal: Clase de profundidad
Indicador Valor
Variable Clase de profundidad
Tipo de variable Cualitativa Ordinal
Categorías (Rango) Somero < Intermedio < Profundo
Moda (Mo) Somero
Mediana (Me) Somero
Media (X̄) —
Varianza (V) —
Desv. Estándar (Sd) —
Coef. Variación (CV%) —
Asimetría (As) —
Curtosis (K) —
Autor: Grupo Brasil

7 Conclusión

La variable Clase de profundidad es una variable cualitativa ordinal con 3 categorías ordenadas (Somero < Intermedio < Profundo), observada en 4,806 pozos con dato. Su moda es Somero, con el 68.79% de los pozos, y su mediana categórica es Somero: al menos la mitad de los pozos está en esa categoría o en las anteriores. La mayoría de los pozos terrestres de Brasil son someros.

Autor: Grupo Brasil