Initial commit — QGIS S-57 Converter

This commit is contained in:
2026-05-04 23:03:19 -04:00
commit eb12a58cb7
41 changed files with 8896 additions and 0 deletions
+211
View File
@@ -0,0 +1,211 @@
# 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=10
- `Q.(6)+LFl.W 15s` → LITCHR=4, LITCHR_TXT=Q, SIGGRP=(6)+, COLOUR=1, SIGPER=15
- `Iso. 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 (0360), 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:
1. Lee este archivo SCHEMA_REFERENCIA.md primero
2. Extrae cada ayuda a la navegación del PDF
3. Convierte coordenadas a decimal WGS84
4. Mapea característica de luz a LITCHR + COLOUR + SIGPER + SIGGRP
5. Asigna feat_type según el tipo de estructura
6. Asigna CATCAM si es cardinal, ORIENT si es enfilación
7. Genera el CSV con exactamente las columnas de este schema, en el mismo orden
8. Nombra el archivo: `dimar_ayudas_<puerto>.csv`