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
## 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
Se realiza el aislamiento y limpieza de la variable Clase de
crudo por API (derivada del grado API: Pesado
por debajo de 22,3 °API, Mediano de 22,3 a 31,1 °API
inclusive y Ligero por encima de 31,1 °API). Se
descartan los pozos sin dato (NA). Los pozos sin grado API
declarado quedan sin clase.
# Pesado < 22,3 °API; Mediano de 22,3 a 31,1 °API (inclusive); Ligero > 31,1 °API
pozos <- pozos %>%
mutate(clase_api = case_when(
api < 22.3 ~ "Pesado",
api <= 31.1 ~ "Mediano",
api > 31.1 ~ "Ligero"
))
cat("Valores únicos originales en clase_api:\n")## Valores únicos originales en clase_api:
## [1] "Ligero" "Mediano" "Pesado"
x_raw <- pozos %>%
filter(!is.na(clase_api)) %>%
pull(clase_api)
n <- length(x_raw)
if (n == 0) {
stop("No se encontraron valores en clase_api. Revisa los valores únicos impresos arriba.")
}
orden_logico <- c("Pesado", "Mediano", "Ligero")
x_raw <- factor(x_raw, levels = orden_logico)
cat("Observaciones válidas:", n, "\n")## Observaciones válidas: 4435
## Pozos sin dato: 873
## Valores únicos: 3
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 crudo por API",
"Derivada de Grau API",
"Cualitativa",
"Ordinal",
"{Pesado < Mediano < Ligero}",
paste(levels(x_raw), collapse = " < "),
"No aplica",
"Ordinal",
"Cálculo propio a partir del grado API (ANP)"
)
)
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 crudo por API |
| Nombre técnico | Derivada de Grau API |
| Tipo | Cualitativa |
| Subtipo | Ordinal |
| Dominio | {Pesado < Mediano < Ligero} |
| Rango | Pesado < Mediano < Ligero |
| Unidad | No aplica |
| Escala | Ordinal |
| Fuente | Cálculo propio a partir del grado API (ANP) |
| Autor: Grupo Brasil | |
Justificación: Las clases de crudo tienen un orden natural (de más denso a más liviano), pero la distancia entre ellas no es medible. Corresponde a una variable cualitativa ordinal; se añaden las frecuencias acumuladas.
Se calcula la distribución de frecuencias absolutas (ni), porcentuales (hi%) y, por tratarse de una variable con orden natural (Pesado < Mediano < Ligero), 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 crudo por API*")
) %>%
cols_label(
Categoria = md("**Clase de crudo por API**"),
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 crudo por API | ||||
| Clase de crudo por API | Frecuencia (ni) | Porcentaje (hi%) | Frec. acumulada (Ni) | Porc. acumulado (Hi%) |
|---|---|---|---|---|
| Pesado | 468 | 10.55 | 468 | 10.55 |
| Mediano | 3296 | 74.32 | 3764 | 84.87 |
| Ligero | 671 | 15.13 | 4435 | 100.00 |
| TOTAL | 4435 | 100.00 | — | — |
| Autor: Grupo Brasil | ||||
Se presentan cuatro gráficas en tonos amarillo y verde claro. Las categorías se dibujan siempre en su orden lógico: Pesado < Mediano < Ligero.
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 crudo por API", side = 1, line = 3.5, cex = 1)
mtext("Gráfica N°1: Distribución de Frecuencias Absolutas de la Variable Clase de crudo por API",
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")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 crudo por API", side = 1, line = 3.5, cex = 1)
mtext("Gráfica N°2: Distribución Porcentual de la Variable Clase de crudo por API",
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")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 crudo por API",
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 crudo por API",
bty = "n")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 crudo por API", side = 1, line = 3.5, cex = 1)
mtext("Gráfica N°4: Distribución Porcentual Acumulada de la Variable Clase de crudo por API",
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")Para la variable cualitativa ordinal Clase de crudo por API 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 crudo por API",
"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 crudo por API*")
) %>%
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 crudo por API | |
| Indicador | Valor |
|---|---|
| Variable | Clase de crudo por API |
| Tipo de variable | Cualitativa Ordinal |
| Categorías (Rango) | Pesado < Mediano < Ligero |
| Moda (Mo) | Mediano |
| Mediana (Me) | Mediano |
| Media (X̄) | — |
| Varianza (V) | — |
| Desv. Estándar (Sd) | — |
| Coef. Variación (CV%) | — |
| Asimetría (As) | — |
| Curtosis (K) | — |
| Autor: Grupo Brasil | |
La variable Clase de crudo por API es una variable cualitativa ordinal con 3 categorías ordenadas (Pesado < Mediano < Ligero), observada en 4,435 pozos con dato. Su moda es Mediano, con el 74.32% de los pozos, y su mediana categórica es Mediano: al menos la mitad de los pozos está en esa categoría o en las anteriores. Predomina el crudo mediano en los pozos terrestres de Brasil.
Autor: Grupo Brasil