Manual de uso
Esta herramienta estima el plazo, el CAPEX, la producción y el VPN de un desarrollo de campo, y señala qué equipo limita el avance. Los valores iniciales son de referencia: reemplácelos por los datos de su proyecto antes de tomar decisiones.
Flujo de trabajo recomendado
- Elija una opción en Parámetros base o edite los valores del panel izquierdo (los grupos se abren y se cierran).
- Indique el número de Réplicas y pulse Simular.
- Lea los indicadores, el diagnóstico de cuellos de botella y los gráficos.
- Pruebe escenarios y barridos de flota para decidir cuánto equipo conviene.
- Con la obra en marcha, cargue el avance real (Aplicar datos, Cargar ejemplo o Importar Excel) y pulse Simular. Cargar datos nunca simula por sí solo.
1. Panel de parámetros
- Simular: corre las réplicas con los parámetros actuales. Tras cambiar un valor, pulse de nuevo para actualizar los resultados.
- Réplicas (1 a 200): cada una usa una secuencia distinta de lluvia y de tiempos aleatorios. Con más réplicas, los rangos P10/P50/P90 son más estables y la corrida tarda más. Con 20 suele alcanzar para explorar.
- Restablecer: vuelve a los valores de referencia. Sus cambios se guardan en el navegador y reaparecen al volver a abrir la página.
- Rangos (mín / moda / máx): tiempos como carga, perforación o completación se sortean con distribución triangular. Si pone los tres valores iguales, ese tiempo deja de variar.
- Tarifas (operativa / stand-by): la operativa se cobra en horas productivas; la stand-by, en horas asignadas sin producir y en horas de turno sin frente.
- Unidades (métrico / petrolero): el selector del encabezado cambia lo que usted ve y escribe: km→mi, m→ft, m³→yd³ (movimiento de tierras), km/h→mph y los rendimientos asociados, y para el crudo m³/d→BPD, m³→bbl, USD/m³→USD/bbl y kPa→psi. Los dólares y días no cambian. Es solo una capa de visualización: el motor, los parámetros guardados, los CSV y la API trabajan siempre en métrico, de modo que cambiar de sistema no altera ningún resultado. Los datos que importe por CSV o Excel (distancias, volúmenes) deben seguir en métrico; la excepción son las pruebas de pozo con el encabezado del original (BPD/psi), que se convierten solas, y los proyectos y escenarios guardados en barriles antes de esta versión, que se convierten al abrirlos. Al cambiar de sistema la página se recarga; sus parámetros se conservan.
Límites que valida el programa
Cada equipo necesita al menos 1 unidad; días hábiles entre 1 y 7; horas de turno entre 1 y 24; probabilidad de lluvia menor que 1; eficiencia y disponibilidad entre 0 y 1; b de Arps entre 0 y 1; horizonte de al menos 1 año; macollas, pozos por macolla y equipos: enteros de 1 o más; largo de troncal y de tramo, capacidad de volquete, velocidades, rendimientos y anchos de vía mayores que 0. Si algo no cumple, el mensaje de estado debajo de la barra de progreso lo indica y no se simula.
Política de despacho
Avance por macolla termina cada macolla con su tramo de troncal para que los taladros arranquen pronto. Troncal completa primero prioriza la vía. Priorizar macollas más productivas usa el caudal del well testing para atender primero las mejores.
Temporada de lluvias
Con "Sí", de mayo a noviembre se usa la probabilidad de la temporada de lluvias y el resto del año la de la seca. Un día de lluvia detiene la obra civil, pero no la perforación.
2. Cómo leer los resultados
- Indicadores (KPI): plazo de obra civil y del último pozo, CAPEX, primer petróleo, producción pico, VPN, TIR y recuperación de la inversión. Los rangos P10/P50/P90 salen de las réplicas: P50 es el valor central y P90 es un resultado alto (en plazo y costo, un escenario desfavorable). TIR, mes de recuperación, producción pico y barriles acumulados también son P50 entre réplicas. El VPN muestra además la media, que suele superar al P50 porque el caudal de cada macolla es asimétrico; para decidir conviene mirar ambos. En modo gemelo, el costo civil por km y por macolla cubre solo la obra pendiente al corte.
- Diagnóstico de cuellos de botella: lectura automática de la réplica representativa (la más cercana a la mediana del plazo). Avisa de equipos que limitan, taladros esperando macolla o materiales, y posible sobredimensionamiento. Un equipo limitante se marca como crítico solo si los taladros esperan macolla (la obra civil está en la ruta crítica); si la perforación marca el plazo, es un aviso: una unidad más adelanta macollas pero no necesariamente el último pozo, y conviene confirmarlo con el barrido de flota.
- Programa simulado: diagrama de Gantt por tramo, acceso, macolla y pozos. Pase el cursor sobre una barra para ver fechas y duración.
- Pozos completados, curva S, producción y flujo de caja: muestran la evolución en el tiempo; el flujo de caja cruza cero cuando se recupera la inversión.
- Uso de flota y frentes en espera: la barra más larga de espera indica el recurso que más frena la obra.
- Incertidumbre del plazo: histograma del plazo total entre réplicas.
- Cantidades y rendimiento por recurso: tabla de apoyo con lo que usó cada equipo.
Si aparece "Simulación incompleta", falta capacidad para terminar el programa: revise que cada equipo tenga al menos una unidad y que los parámetros sean coherentes.
3. Modo gemelo: cargar el avance real
- Indique la fecha de corte y el costo real a la fecha (USD).
- Pegue el CSV de avance (o pulse Cargar ejemplo para ver el formato).
- Pulse Aplicar datos (activa el modo gemelo) y luego Simular, en el panel izquierdo.
El modelo fija lo ejecutado, toma el porcentaje de avance de lo que está en curso y simula lo que falta. Al final compara el pronóstico con la línea base (plazo, CAPEX y VPN). El CAPEX pasa a ser un estimado a término: costo real más pronóstico. Las facilidades de una macolla que ya está perforando al corte se cobran solo por la parte que falta; un pozo a medio perforar se rehace completo, porque el CSV solo informa pozos terminados.
Formato del CSV
Columnas: elemento;fase;inicio;fin;avance_pct, separadas por ; o tabulación (puede pegar desde Excel). Fechas como 2026-10-05 o 05/10/2026. Decimales con punto o coma.
| Elemento | Significado |
|---|
T01 | Tramo de troncal |
A1 | Acceso a la macolla 1 |
M1 | Plataforma de la macolla 1 |
M1-P03 | Pozo 3 de la macolla 1 (fase Pozo; solo cuentan los terminados, con fecha de fin) |
Fases válidas: Desbroce, Saneamiento, Relleno, Conformación y Pozo. Si deja el fin vacío, la fase está en curso y se toma el avance_pct. La fecha de corte debe ser posterior a la fecha de inicio.
elemento;fase;inicio;fin;avance_pct
T01;Desbroce;2026-10-05;2026-10-09;100
T08;Relleno;2027-06-02;;45
M1-P03;Pozo;2027-05-01;2027-05-14;100
Las líneas con error se informan en el mensaje bajo el botón (fecha no válida, fase no reconocida, elemento desconocido, o un código fuera del programa, como T99, M9 o M1-P20 cuando hay menos tramos, macollas o pozos). El resto de las líneas sí se usa.
Carga desde Excel
Descargar planilla Excel entrega un libro de ejemplo con tres hojas: Corte (fecha de corte y costo real), Avance (las mismas columnas del CSV) e Instrucciones. Complete la hoja Avance y pulse Importar Excel: el programa carga los datos y activa el modo gemelo; después pulse Simular. Las fechas pueden ser de Excel o texto AAAA-MM-DD. Si el libro no tiene hoja Corte, se conservan la fecha de corte y el costo que ya estén en pantalla.
4. Well testing → producción
- Pegue una línea por macolla:
macolla;ip_m3d_kpa;drawdown_kpa;incert_pct;k_md;skin (IP en m³/d por kPa, drawdown en kPa), por ejemplo M1;0.03689;1930;12;4200;1.5. Un archivo con el encabezado del original (ip_bpd_psi;drawdown_psi) se lee en BPD/psi y se convierte.
- Pulse Aplicar datos (activa el well testing) y luego Simular, en el panel izquierdo.
El caudal inicial de la macolla es IP × drawdown, y incert_pct es la incertidumbre (P10–P90) de esa prueba. Las macollas sin prueba usan el caudal supuesto de Producción y economía, con su incertidumbre más amplia. Las líneas con números no válidos o con una macolla que no existe se cuentan como no válidas en el mensaje.
Excel: Descargar planilla Excel entrega un libro con la hoja Pruebas (una fila por macolla) y una hoja de instrucciones. Importar Excel lee la hoja Pruebas y activa el well testing; después pulse Simular.
Validación al importar: cada línea de well testing y de avance real se acepta o se rechaza, y el panel indica la línea, el texto y el motivo (macolla inexistente, IP o drawdown no numéricos, fase desconocida, etc.). Las macollas sin prueba válida usan el caudal supuesto y se listan. Los avisos (por ejemplo, incertidumbre fuera de 1–90 %) no rechazan la línea pero quedan visibles.
Proyectos y escenarios: en el panel izquierdo cree un proyecto, indique el analista y use Guardar escenario para conservar un juego de parámetros con nombre. Cada vez que pulsa Simular con un proyecto activo queda registrada una corrida con fecha, analista, versión y huella del modelo, huella de los datos cargados (avance y pruebas, con cuántas líneas se aceptaron y rechazaron), réplicas y resumen P10/P50/P90 de plazo, CAPEX y VPN, más una copia de los parámetros. Marque dos corridas y Comparar muestra qué parámetros cambiaron y cuánto cambiaron los resultados; Restaurar parámetros recupera los de una corrida. Todo se guarda en este navegador: use Exportar para llevar el proyecto a otro computador o respaldarlo e Importar para abrirlo (siempre entra como proyecto nuevo, nunca sobrescribe). Esto es trazabilidad local; no reemplaza un servidor con usuarios y permisos.
Informes: tras simular, Informe PDF abre el diálogo de impresión con un informe de unas 7 páginas (resumen P10/P50/P90, diagnóstico, Gantt y gráficos, recursos, calidad de los datos cargados, parámetros utilizados, y proyecto, analista y versión del modelo); elija «Guardar como PDF» como destino. Informe Excel descarga un libro con las hojas Resumen, Parámetros, Costos, Cronograma, Pozos, Producción, Recursos, Diagnóstico y Calidad de datos. P10 y P90 salen de todas las réplicas; el cronograma, los costos y la producción mensual son los de la réplica representativa (la más cercana a la mediana de plazo). Ambos funcionan sin conexión.
Optimización reproducible: la búsqueda bayesiana usa una semilla de búsqueda (campo junto a las iteraciones). Con la misma semilla, los mismos datos y los mismos parámetros se evalúan exactamente las mismas configuraciones y se llega al mismo resultado, lo que permite auditar o repetir una optimización. Cambie la semilla para explorar otra secuencia de puntos iniciales; si dos semillas llegan a la misma flota, el resultado es más confiable.
Calibración: con el avance real cargado, Calibrar con el avance real compara, elemento por elemento, la duración observada de las fases y pozos terminados al corte con la que simula el modelo para esos mismos elementos, y ajusta por iteración los rendimientos de desbroce, relleno y conformación y los tiempos de perforación y completación hasta que el modelo reproduzca lo observado. La tabla muestra cuántas observaciones respaldan cada ajuste (se exigen al menos 3), el intervalo del 90 % y un estado: calibrado, indicativo (fases de menos de 4 días con fechas al día: no hay resolución suficiente) o no converge (el parámetro no explica la diferencia porque la fase la limita otro recurso). Por defecto solo se marcan los grupos fiables; usted decide cuáles aplicar, y la aplicación queda anotada en el proyecto. Límites: el ajuste absorbe en el rendimiento todo lo que alarga una fase (lluvia, esperas, fallas) sin separar causas, ignora las fases en curso y no calibra el caudal de los pozos (eso viene del well testing). La calibración rinde sobre todo cuando queda mucho por pronosticar: en las pruebas, con un corte temprano reduce el error del plazo pronosticado a menos de la mitad.
Las columnas k_md y skin se leen pero no cambian el cálculo de producción. El gráfico muestra, por macolla, el caudal P50 y su rango P10–P90, y distingue las macollas con prueba de las que usan el caudal supuesto.
5. Escenarios y dimensionamiento de flota
Escenarios: ¿qué pasa si…?
Cada ficha cambia una palanca (por ejemplo, más lluvia o más equipos) sobre los parámetros actuales y corre 6 réplicas. El caso actual se recalcula en cada corrida con los parámetros vigentes y las mismas semillas, así que las diferencias se deben solo a la palanca. Si el modo gemelo está activo, el escenario parte del avance real.
Dimensionamiento de flota
Elija un equipo, el rango (Desde, Hasta, Paso) y las réplicas por punto, y pulse Barrer. Cada punto es la mediana de las réplicas con el resto de la flota fija. Se muestran como máximo 25 valores.
- Busque el punto donde el plazo deja de bajar: más equipo ya no ayuda porque otro recurso limita.
- El VPN (P50) más alto señala el mejor equilibrio entre plazo y costo.
- Si un valor del barrido tuvo corridas incompletas, el mensaje de estado lo advierte y sus plazos no deben usarse.
5b. Optimización bayesiana
Busca la mejor combinación de flota con pocas simulaciones. Primero evalúa la configuración actual y varias configuraciones al azar (puntos iniciales); después, en cada iteración bayesiana, un modelo estadístico aprende de lo ya simulado y propone la configuración con mayor mejora esperada.
- Elija el objetivo: maximizar VPN (P50), minimizar el plazo del último pozo o minimizar el CAPEX. Para minimizar el CAPEX conviene fijar un plazo máximo.
- Marque las variables a optimizar y su rango (equipos y, si quiere, la política de despacho). Las demás quedan en el valor actual.
- Pulse Optimizar. Cada punto se evalúa con las réplicas indicadas y usa la mediana. Puede detener el proceso con Detener.
- Revise el gráfico de convergencia y la tabla con las mejores configuraciones. Aplicar mejor configuración copia los valores a los parámetros; luego pulse Simular para ver el detalle.
Una configuración con corridas incompletas, o que supera el plazo máximo, se descarta. Con pocas réplicas el resultado tiene ruido: confirme el óptimo con 20 réplicas o más. La optimización respeta el modo gemelo si está activo y no cambia sus parámetros hasta que usted aplique la mejor configuración.
6. Vista animada y modo expo
La Vista animada reproduce la réplica representativa en planta: avance de la troncal por fases, volquetes circulando y macollas llenándose de pozos. Use Reproducir, cambie la velocidad (5 a 60 días por segundo) o arrastre el control deslizante para ir a un día. Modo expo pasa a pantalla completa con solo la animación y los escenarios, para presentar. Se sale con la tecla Esc o con el botón de salida.
7. Buenas prácticas y límites
- Calibre rendimientos y tiempos de ciclo con partes diarios de una macolla ya construida antes de usar el modelo para decidir.
- Use varias réplicas (20 o más) para comparar escenarios; con pocas, la diferencia puede ser ruido.
- El horizonte económico se cuenta desde el inicio de la obra, no desde el primer petróleo. Si es corto, parte del CAPEX o de la producción queda fuera del VPN.
- El préstamo se supone ilimitado, la lluvia detiene solo la obra civil y las macollas se reparten a distancias iguales sobre la troncal (ver Modelo conceptual).
- Los precios, costos y caudales por defecto son de ejemplo, no cotizaciones ni mediciones.
- Los botones de Excel necesitan conexión a internet la primera vez, porque cargan la librería de lectura y escritura de planillas. Sin ella, use los campos CSV.
Problemas frecuentes
| Síntoma | Qué revisar |
|---|
| No se simula y aparece un mensaje de estado | Alguno de los límites de la sección 1 no se cumple, o un campo quedó vacío (se toma como 0). |
| "Simulación incompleta" | Falta capacidad de algún equipo para terminar el programa. |
| VPN muy negativo | Horizonte corto, precio bajo o producción por pozo insuficiente frente al CAPEX. |
| El CSV da "no reconocido" | Códigos T01, A1, M1 o M1-P01 y fases escritas como en la sección 3. |