9.7 KiB
SCHEMA CSV — DIMAR → S-57 ENC
Referencia para extracción de datos de PDFs DIMAR
Cuando Claude recibe un PDF de DIMAR (Lista de Luces, AAN, carta), lee este archivo y genera el CSV con exactamente estas columnas y códigos.
COLUMNAS DEL CSV (en este orden)
no_dimar, OBJNAM, lon, lat, feat_type, LITCHR, LITCHR_TXT, SIGGRP, COLOUR, COLOUR_TXT, SIGPER, VALNMR, HEIGHT, ORIENT, CATCAM, INFORM, _dimar_char_raw, _source
| Columna | Descripción | Ejemplo |
|---|---|---|
| no_dimar | Número en Lista de Luces DIMAR | 257 |
| OBJNAM | Nombre oficial de la ayuda | Faro Castillogrande |
| lon | Longitud decimal WGS84 (negativo = oeste) | -75.545000 |
| lat | Latitud decimal WGS84 | 10.391000 |
| feat_type | Tipo S-57 (ver tabla abajo) | BOYCAR |
| LITCHR | Código numérico de característica de luz | 2 |
| LITCHR_TXT | Texto legible de la característica | Fl |
| SIGGRP | Grupo de destellos entre paréntesis | 3 o (6)+ |
| COLOUR | Código numérico de color (ver tabla) | 3 |
| COLOUR_TXT | Texto del color | red |
| SIGPER | Período en segundos | 10 |
| VALNMR | Alcance nominal en millas náuticas | 12 |
| HEIGHT | Altura de la luz sobre MLLW en metros | 24 |
| ORIENT | Rumbo de enfilación en grados (solo enfilaciones) | 135.7 |
| CATCAM | Dirección cardinal (solo boyas cardinales) | 1 |
| INFORM | Descripción física de la estructura | Torre concreto beige |
| _dimar_char_raw | Característica de luz tal como aparece en DIMAR | Fl. W 10 s |
| _source | Fuente del dato | DIMAR Lista de Luces 2015 |
Regla: columnas vacías se dejan en blanco (no NULL, no 0, solo vacío).
Regla: columnas que empiezan con _ son privadas, el converter las ignora.
Regla: coordenadas siempre en decimal WGS84. Convertir grados-minutos así:
DD°MM.mmm' = DD + MM.mmm/60
Ejemplo: 10°23.45'N = 10 + 23.45/60 = 10.390833
TABLA feat_type — TIPO DE AYUDA
| feat_type | Descripción | Cuándo usarlo |
|---|---|---|
| BOYCAR | Boya cardinal | Boya con topmark en forma de cono/cono invertido que indica N/S/E/W |
| BCNCAR | Baliza cardinal (fija) | Estructura fija cardinal |
| BOYLAT | Boya lateral | Boya roja o verde que marca bordes de canal |
| BCNLAT | Baliza lateral (fija) | Estructura fija lateral, también enfilaciones |
| BOYISD | Boya de peligro aislado | Boya negra-roja sobre peligro aislado |
| BOYSAW | Boya de aguas seguras | Boya roja-blanca, marca agua navegable |
| BOYSPP | Boya especial | Boya amarilla, uso especial |
| LIGHTS | Luz / Faro / Enfilación | Faros, luces de puerto, enfilaciones |
| LNDMRK | Punto de referencia terrestre | Torres, edificios notables, chimeneas |
TABLA LITCHR — CARACTERÍSTICA DE LUZ
| Código | LITCHR_TXT | DIMAR escribe | Descripción |
|---|---|---|---|
| 1 | F | F. | Fija (Fixed) |
| 2 | Fl | Fl. | Destello (Flashing) |
| 3 | LFl | LFl. | Destello largo |
| 4 | Q | Q. | Rápida (Quick) |
| 5 | VQ | VQ. | Muy rápida |
| 6 | UQ | UQ. | Ultra rápida |
| 7 | Iso | Iso. | Isofase |
| 8 | Oc | Oc. | Ocultante |
| 9 | IQ | IQ. | Interrumpida rápida |
| 12 | Mo | Mo. | Morse |
| 13 | FFl | FFl. | Fija y destellante |
Grupos: el número entre paréntesis va en SIGGRP. Ejemplos:
Fl.(3) W 10 s→ LITCHR=2, LITCHR_TXT=Fl, SIGGRP=3, COLOUR=1, SIGPER=10Q.(6)+LFl.W 15s→ LITCHR=4, LITCHR_TXT=Q, SIGGRP=(6)+, COLOUR=1, SIGPER=15Iso. Bu 4 s→ LITCHR=7, LITCHR_TXT=Iso, SIGGRP=, COLOUR=5, SIGPER=4
TABLA COLOUR — COLOR DE LA LUZ
| Código | COLOUR_TXT | DIMAR escribe |
|---|---|---|
| 1 | white | W |
| 2 | black | — |
| 3 | red | R |
| 4 | green | G |
| 5 | blue | Bu |
| 6 | yellow | Y |
| 11 | orange | Or |
Colores múltiples (sectores): separar con coma. Ejemplo "1,3,4" = white/red/green.
COLOUR_TXT correspondiente: "white/red/green"
TABLA CATCAM — DIRECCIÓN CARDINAL (solo BOYCAR / BCNCAR)
| Código | Dirección | Cuándo |
|---|---|---|
| 1 | N | Boya Norte — pasa al norte de la boya |
| 2 | E | Boya Este — pasa al este |
| 3 | S | Boya Sur — pasa al sur |
| 4 | W | Boya Oeste — pasa al oeste |
Inferencia por nombre cuando CATCAM no está explícito:
- Contiene " SN", " VN", "Norte", " NN" → 1 (N)
- Contiene " SE", "Este" → 2 (E)
- Contiene " SS", " VS", "Sur" → 3 (S)
- Contiene " SO", " BB", "Oeste", " SW" → 4 (W)
TABLA ORIENT — RUMBO DE ENFILACIÓN (solo LIGHTS con enfilación)
- Solo se rellena cuando la ayuda es una enfilación (leading light / range mark)
- Valor en grados verdaderos (0–360), con un decimal
- Es el rumbo que sigue el buque cuando está alineado con las luces
- Si el PDF no especifica rumbo → dejar ORIENT vacío
- Ejemplos:
135.7,167.3,347.5
EJEMPLOS COMPLETOS POR TIPO DE AYUDA
Faro (LIGHTS)
35,Faro Castillogrande,-75.545000,10.391000,LIGHTS,2,Fl,,1,white,15,12,24,,,Torre en concreto color beige,Fl. W 15 s,DIMAR Lista de Luces 2015
Faro con grupos (LIGHTS)
34,Faro Punta Canoas,-75.499167,10.573000,LIGHTS,2,Fl,2,1,white,20,12,96,,,Torre roja bandas blancas. Giratorio,Fl.(2) W 20 s,DIMAR Lista de Luces 2015
Enfilación (LIGHTS con ORIENT)
196,Enfilacion E1,-74.848333,11.103667,LIGHTS,6,Iso,,6,white,5,13,10,135.7,,Baliza enrejado naranja y blanco,Iso Bu 5s,DIMAR Lista de Luces 2015
Boya cardinal Norte (BOYCAR)
250,Boya SN,-75.521000,10.366000,BOYCAR,4,Q,,1,white,15,4,4,,1,Castillete cardinal N negro,Q.W 15s,DIMAR Lista de Luces 2015
Boya cardinal Sur (BOYCAR)
256,Boya SS,-75.527500,10.331833,BOYCAR,3,4,Q,(6)+,1,white,15,4,4,,3,Castillete cardinal S negros,Q.(6)+LFl.W 15s,AAN-DIMAR-2024-770
Boya cardinal Este (BOYCAR)
253,Boya SE,-75.512000,10.365000,BOYCAR,4,Q,3,1,white,10,4,4,,2,Castillete cardinal E negros,Q.(3)W 10s,DIMAR Lista de Luces 2015
Boya cardinal Oeste (BOYCAR)
252,Boya SO,-75.534000,10.372000,BOYCAR,2,Fl,9,1,white,15,4,4,,4,Castillete cardinal W negros,Fl.(9)W 15s,DIMAR Lista de Luces 2015
Boya lateral verde (BOYLAT)
240,Boya No. 1,-75.563000,10.345000,BOYLAT,2,Fl,,4,green,3,3,4,,,Castillete verde,Fl. G 3 s,DIMAR Lista de Luces 2015
Boya lateral roja (BOYLAT)
241,Boya No. 2,-75.560000,10.347000,BOYLAT,2,Fl,,3,red,3,3,4,,,Castillete roja,Fl. R 3 s,DIMAR Lista de Luces 2015
Boya de peligro aislado (BOYISD)
258,Boya Peligro Aislado Polvorines,-75.536000,10.351167,BOYISD,2,Fl,2,1,white,5,4,2.5,,,Castillete roja bandas negras,Fl.(2) W 5 s,DIMAR Lista de Luces 2015
Baliza lateral con enfilación (BCNLAT)
257,Enfilacion de Bocachica B,-75.508833,10.320833,BCNLAT,7,Iso,,5,blue,4,12,33,,,Torre enrejada rojo bandas blancas,Iso. Bu 4 s,DIMAR Lista de Luces 2015
Luz de aproximación (LIGHTS color especial)
296,Luz de Aproximacion,-75.549500,10.409000,LIGHTS,2,Fl,,5,blue,2.5,11,37,,,Torre metalica roja y blanca,Fl. Bu 2.5 s,DIMAR Lista de Luces 2015
CONVERSIÓN DE COORDENADAS DIMAR
DIMAR publica en grados y minutos decimales: 10°23.45'N 75°32.67'W
Fórmula: grados + minutos/60
- Latitud: 10 + 23.45/60 = 10.390833 (positivo = Norte)
- Longitud: 75 + 32.67/60 = 75.544500 → con signo negativo = -75.544500 (Oeste)
INSTRUCCIÓN PARA CLAUDE
Cuando el usuario pase un PDF de DIMAR:
- Lee este archivo SCHEMA_REFERENCIA.md primero
- Extrae cada ayuda a la navegación del PDF
- Convierte coordenadas a decimal WGS84
- Mapea característica de luz a LITCHR + COLOUR + SIGPER + SIGGRP
- Asigna feat_type según el tipo de estructura
- Asigna CATCAM si es cardinal, ORIENT si es enfilación
- Genera el CSV con exactamente las columnas de este schema, en el mismo orden
- Nombra el archivo:
dimar_ayudas_<puerto>.csv