ventpy 0.2.0__tar.gz → 0.3.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (91) hide show
  1. {ventpy-0.2.0 → ventpy-0.3.0}/.github/workflows/tests.yml +1 -1
  2. ventpy-0.3.0/CHANGELOG.md +483 -0
  3. {ventpy-0.2.0 → ventpy-0.3.0}/CMakeLists.txt +2 -1
  4. {ventpy-0.2.0 → ventpy-0.3.0}/CONTRIBUTING.md +7 -6
  5. ventpy-0.3.0/PKG-INFO +245 -0
  6. ventpy-0.3.0/README.es.md +213 -0
  7. ventpy-0.3.0/README.md +213 -0
  8. ventpy-0.3.0/ROADMAP.md +102 -0
  9. {ventpy-0.2.0 → ventpy-0.3.0}/bindings/bindings.cpp +150 -41
  10. ventpy-0.3.0/examples/01-demanda-peru/README.md +113 -0
  11. {ventpy-0.2.0 → ventpy-0.3.0}/examples/01-demanda-peru/input.json +1 -8
  12. {ventpy-0.2.0 → ventpy-0.3.0}/examples/01-demanda-peru/run.py +27 -32
  13. {ventpy-0.2.0 → ventpy-0.3.0}/examples/02-preset-chile/README.md +28 -12
  14. {ventpy-0.2.0 → ventpy-0.3.0}/examples/02-preset-chile/run.py +15 -8
  15. {ventpy-0.2.0 → ventpy-0.3.0}/examples/03-cobertura-levantamiento/README.md +17 -7
  16. {ventpy-0.2.0 → ventpy-0.3.0}/examples/03-cobertura-levantamiento/input.json +2 -2
  17. {ventpy-0.2.0 → ventpy-0.3.0}/examples/03-cobertura-levantamiento/run.py +10 -8
  18. {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/atkinson.hpp +8 -7
  19. {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/atmosphere.hpp +3 -3
  20. {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/caudal_equipo.hpp +37 -19
  21. {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/caudal_explosivos.hpp +136 -71
  22. {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/caudal_fugas.hpp +6 -3
  23. {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/caudal_personal.hpp +60 -33
  24. ventpy-0.3.0/include/ventpy/caudal_polvo.hpp +160 -0
  25. {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/caudal_termico.hpp +28 -26
  26. {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/cobertura.hpp +101 -32
  27. {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/governor.hpp +206 -23
  28. ventpy-0.3.0/include/ventpy/limites_gases.hpp +275 -0
  29. ventpy-0.3.0/include/ventpy/normativa.hpp +787 -0
  30. {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/types.hpp +66 -44
  31. {ventpy-0.2.0 → ventpy-0.3.0}/pyproject.toml +8 -2
  32. {ventpy-0.2.0 → ventpy-0.3.0}/python/ventpy/__init__.py +9 -1
  33. {ventpy-0.2.0 → ventpy-0.3.0}/python/ventpy/cli.py +9 -3
  34. {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_atkinson.cpp +4 -3
  35. {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_caudal_equipo.cpp +38 -1
  36. ventpy-0.3.0/tests/cpp/test_caudal_explosivos.cpp +276 -0
  37. ventpy-0.3.0/tests/cpp/test_caudal_personal.cpp +209 -0
  38. ventpy-0.3.0/tests/cpp/test_caudal_polvo.cpp +247 -0
  39. ventpy-0.3.0/tests/cpp/test_citas_normativas.cpp +701 -0
  40. {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_cobertura.cpp +132 -26
  41. ventpy-0.3.0/tests/cpp/test_governor.cpp +773 -0
  42. ventpy-0.3.0/tests/cpp/test_limites_gases.cpp +324 -0
  43. ventpy-0.3.0/tests/cpp/test_normativa.cpp +357 -0
  44. ventpy-0.3.0/tests/python/test_citas_normativas.py +366 -0
  45. {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_cli.py +74 -12
  46. {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_cobertura.py +12 -10
  47. {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_examples.py +3 -3
  48. ventpy-0.3.0/tests/python/test_multinorma.py +254 -0
  49. {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_red_ventilacion.py +12 -0
  50. {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_ventpy.py +59 -12
  51. ventpy-0.2.0/CHANGELOG.md +0 -77
  52. ventpy-0.2.0/PKG-INFO +0 -288
  53. ventpy-0.2.0/README.es.md +0 -262
  54. ventpy-0.2.0/README.md +0 -262
  55. ventpy-0.2.0/ROADMAP.md +0 -65
  56. ventpy-0.2.0/examples/01-demanda-peru/README.md +0 -91
  57. ventpy-0.2.0/include/ventpy/caudal_polvo.hpp +0 -94
  58. ventpy-0.2.0/include/ventpy/limites_gases.hpp +0 -130
  59. ventpy-0.2.0/include/ventpy/normativa.hpp +0 -225
  60. ventpy-0.2.0/tests/cpp/test_caudal_explosivos.cpp +0 -123
  61. ventpy-0.2.0/tests/cpp/test_caudal_personal.cpp +0 -120
  62. ventpy-0.2.0/tests/cpp/test_caudal_polvo.cpp +0 -120
  63. ventpy-0.2.0/tests/cpp/test_governor.cpp +0 -379
  64. ventpy-0.2.0/tests/cpp/test_limites_gases.cpp +0 -151
  65. ventpy-0.2.0/tests/cpp/test_normativa.cpp +0 -161
  66. ventpy-0.2.0/tests/python/test_multinorma.py +0 -42
  67. {ventpy-0.2.0 → ventpy-0.3.0}/.github/ISSUE_TEMPLATE/norma-pais.md +0 -0
  68. {ventpy-0.2.0 → ventpy-0.3.0}/.github/ISSUE_TEMPLATE/numero-incorrecto.md +0 -0
  69. {ventpy-0.2.0 → ventpy-0.3.0}/.github/workflows/release.yml +0 -0
  70. {ventpy-0.2.0 → ventpy-0.3.0}/.gitignore +0 -0
  71. {ventpy-0.2.0 → ventpy-0.3.0}/LICENSE +0 -0
  72. {ventpy-0.2.0 → ventpy-0.3.0}/examples/02-preset-chile/input.json +0 -0
  73. {ventpy-0.2.0 → ventpy-0.3.0}/examples/04-red-ventilador/README.md +0 -0
  74. {ventpy-0.2.0 → ventpy-0.3.0}/examples/04-red-ventilador/input.json +0 -0
  75. {ventpy-0.2.0 → ventpy-0.3.0}/examples/04-red-ventilador/run.py +0 -0
  76. {ventpy-0.2.0 → ventpy-0.3.0}/examples/05-ducto-seleccion/README.md +0 -0
  77. {ventpy-0.2.0 → ventpy-0.3.0}/examples/05-ducto-seleccion/run.py +0 -0
  78. {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/ducto.hpp +0 -0
  79. {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/red.hpp +0 -0
  80. {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/validation.hpp +0 -0
  81. {ventpy-0.2.0 → ventpy-0.3.0}/include/ventpy/ventilador.hpp +0 -0
  82. {ventpy-0.2.0 → ventpy-0.3.0}/python/ventpy/visualization.py +0 -0
  83. {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_caudal_fugas.cpp +0 -0
  84. {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_caudal_termico.cpp +0 -0
  85. {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_ducto.cpp +0 -0
  86. {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_red.cpp +0 -0
  87. {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_validation.cpp +0 -0
  88. {ventpy-0.2.0 → ventpy-0.3.0}/tests/cpp/test_ventilador.cpp +0 -0
  89. {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_escala.py +0 -0
  90. {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_polvo_termico.py +0 -0
  91. {ventpy-0.2.0 → ventpy-0.3.0}/tests/python/test_properties.py +0 -0
@@ -81,7 +81,7 @@ jobs:
81
81
  - name: Medir y comprobar umbral
82
82
  run: |
83
83
  lcov --capture --directory build-cov --output-file cov.info \
84
- --rc branch_coverage=1 --ignore-errors mismatch,gcov,source
84
+ --rc branch_coverage=1 --ignore-errors mismatch,gcov,source,inconsistent
85
85
  lcov --extract cov.info "*/include/ventpy/*" --output-file cov-core.info \
86
86
  --rc branch_coverage=1 --ignore-errors unused
87
87
  lcov --list cov-core.info --rc branch_coverage=1
@@ -0,0 +1,483 @@
1
+ # Registro de cambios
2
+
3
+ Todas las versiones publicadas de VentPy. El formato sigue
4
+ [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y el versionado es
5
+ [semántico](https://semver.org/lang/es/).
6
+
7
+ ## [0.3.0] — 2026-11-15
8
+
9
+ ### El caudal de voladura cambia
10
+
11
+ Hasta la 0.2.1, declarar `gas_volume_per_kg` en `BlastingParams` desviaba el
12
+ cálculo a una fórmula que dividía el volumen total de gases entre el tiempo de
13
+ dilución. Ese cociente es el ritmo al que se generan los gases, no el caudal
14
+ que los diluye hasta un límite de exposición. Con 50 kg de explosivo,
15
+ 0,04 m³/kg y 30 min daba 0,067 m³/min, que el redondeo de seguridad subía a 1.
16
+ El defecto alcanzaba a `calculate_blasting_flow` y también a
17
+ `VentilationGovernor`, y estaba presente desde la 0.1.0.
18
+
19
+ Desde la 0.3.0 hay un solo modelo: dilución de CO y de NOx según el tipo de
20
+ explosivo, recambio volumétrico y velocidad mínima de barrido.
21
+ `gas_volume_per_kg` ya no cambia el caudal; solo fija el volumen total de
22
+ gases que se reporta en `total_gas_volume_m3`.
23
+
24
+ **A quién afecta:** a quien haya calculado una demanda con voladura declarando
25
+ `gas_volume_per_kg`. Conviene recalcular: el caudal de voladura sube varios
26
+ órdenes de magnitud y puede pasar a ser el criterio gobernante.
27
+
28
+ | Caso (50 kg de ANFO, 30 min, frente de 12 m²) | 0.2.1 | 0.3.0 |
29
+ |---|---|---|
30
+ | `calculate_blasting_flow`, nivel del mar | 1 m³/min | 6.667 m³/min (dilución de NOx a 3 ppm) |
31
+ | `VentilationGovernor`, 4.200 msnm, con un scoop de 150 HP | `Q_Exp` = 1; gobierna el diésel; total 981 | `Q_Exp` = 11.251; gobierna la voladura; total 12.939 |
32
+
33
+ Quien no declaraba `gas_volume_per_kg` ya obtenía en el Governor el modelo por
34
+ contaminante: sus resultados no cambian.
35
+
36
+ - `VentilationGovernor` exige ahora sección y longitud del frente para toda
37
+ voladura (las toma de `VentilationInput` si la voladura no las trae). Antes,
38
+ con `gas_volume_per_kg`, no las necesitaba.
39
+ - `calculate_blasting_flow` usa el mismo modelo sin corrección por altitud,
40
+ porque no recibe atmósfera, y omite los dos criterios de sección si no se
41
+ dan `face_area_m2` y `face_length_m`. Sin `gas_volume_per_kg` también
42
+ devolvía 1 m³/min.
43
+ - El ejemplo `01-demanda-peru` ya no incluye voladura, para seguir mostrando
44
+ el caso gobernado por el diésel. Su README explica el cambio.
45
+ - El modelo por contaminante es conservador: diluye todo el CO y todo el NOx
46
+ (como NO2) a su límite de 8 h en la norma configurada dentro del tiempo
47
+ declarado, con 20 % de margen (ver «Objetivo de dilución» más abajo). Con el
48
+ DS 024 es criterio de ingeniería para el frente, y la cita lo declara: el
49
+ reglamento fija el caudal de voladura solo en el total de mina.
50
+
51
+ ### Total de mina con el DS 024: voladura según el Anexo 38
52
+
53
+ Con el preajuste peruano, `ZoneType.GeneralMine` sigue el Anexo 38 del
54
+ DS 024-2016-EM (texto del DS 023-2017-EM):
55
+
56
+ - Con equipos diésel (num. 1), la voladura no entra en el total. El resultado
57
+ lo advierte y `q_blasting_m3min` queda en 0.
58
+ - Sin equipos diésel (num. 2 lit. e), rige el mayor entre el total con fugas y
59
+ `Q_Ex = A × V × N`: área promedio de labores, velocidad mínima del Art. 248
60
+ (25 m/min con ANFO u otros agentes de voladura, 20 m/min con dinamita) y
61
+ niveles en voladura, el campo nuevo `BlastingParams.blasting_levels`
62
+ (por defecto 1). `Q_Ex` no lleva fugas.
63
+
64
+ **A quién afecta:** a quien calcule el total de mina con voladura bajo el
65
+ DS 024. Hasta ahora se sumaba el caudal por dilución de contaminantes; con
66
+ 50 kg de ANFO a 2.500 msnm, sin diésel, eso agregaba 5.428 m³/min y ahora
67
+ agrega 300 (12 m² × 25 m/min × 1 nivel). Chile, Colombia y México no tienen
68
+ un equivalente al Anexo 38 y siguen sumando la dilución.
69
+
70
+ ### Advertencia de velocidad máxima
71
+
72
+ `VentilationGovernor` advierte cuando la velocidad en el frente, la rampa o el
73
+ tajeo supera la máxima de la norma: 250 m/min en Perú (DS 024, Art. 248),
74
+ 150 m/min en Chile (DS 132, Art. 138 inc. 3) y 6 m/s (360 m/min) en Colombia
75
+ (Decreto 1886, Art. 56 par. 1). México no fija máxima y no se advierte. Solo
76
+ es un aviso: el caudal requerido no cambia. La función `max_air_velocity_mpm`
77
+ devuelve esos topes.
78
+
79
+ ### Valores y citas revisados contra el texto oficial de cada norma
80
+
81
+ Cada valor que la librería atribuye a una norma se volvió a cotejar con el
82
+ texto vigente (DS 024-2016-EM consolidado y DS 023-2017-EM; DS 132 y DS 594;
83
+ Decreto 1886 de 2015 con el 944 de 2022; NOM-023-STPS-2012 y
84
+ NOM-010-STPS-2014). Varios valores compartidos entre normas seguían con
85
+ defaults peruanos, y algunos defaults peruanos no eran los de la norma. Los
86
+ cambios de resultados van primero, cada uno con a quién afecta.
87
+
88
+ #### El caudal por persona nunca baja del mínimo de la norma
89
+
90
+ `PersonnelFlowCalculator.calculate_full` multiplicaba el caudal por persona
91
+ por un factor de actividad (0,6 en reposo, 0,8 ligera). Ninguna norma
92
+ implementada reduce el mínimo por persona según la actividad: ahora la
93
+ actividad y la densidad pueden subirlo, nunca bajarlo.
94
+
95
+ **A quién afecta:** a quien calcule con `ActivityLevel.Rest` o `Light` en
96
+ `VentilationGovernor`. 20 trabajadores en reposo a 0 msnm daban 36 m³/min
97
+ (20 × 3 × 0,6); ahora dan 60 (DS 024, Art. 247). Con México, 100
98
+ trabajadores en reposo daban 90; ahora 150 (8.4.4 a) 1).
99
+
100
+ #### Bordes de altitud: rige la banda alta
101
+
102
+ El Art. 247 del DS 024 pone 1.500 y 3.000 msnm en dos bandas a la vez, y el
103
+ Art. 54 del Decreto 1886 hace lo mismo con 1.500. En el umbral exacto ahora
104
+ rige la banda de mayor caudal (antes la menor). La cita dice `(>=1500 msnm)`.
105
+
106
+ **A quién afecta:** a quien calcule exactamente a 1.500, 3.000 o 4.000 msnm
107
+ con Perú (3 → 4, 4 → 5 y 5 → 6 m³/min por persona) o a 1.500 msnm con
108
+ Colombia (3 → 6).
109
+
110
+ #### Velocidades mínimas según la norma
111
+
112
+ `get_min_velocity` tomaba 15 m/min en el frente, 18 en la rampa y 12 en el
113
+ tajeo para toda norma, por debajo de los 20 m/min del DS 024, Art. 248.
114
+ Ahora devuelve el mayor entre ese valor por tipo de labor (que queda como
115
+ criterio de ingeniería) y la mínima de la norma: Perú 20 m/min, 25 con ANFO
116
+ u otros agentes de voladura (Art. 248); Chile 15 (DS 132, Art. 138 inc. 3);
117
+ México 15,24 donde opere maquinaria diésel (8.4.4 b); Colombia no fija mínima
118
+ fuera del carbón y conserva los valores por labor. El barrido de la voladura
119
+ (`BlastingParams.min_velocity_mps`) tampoco baja de la mínima de la norma.
120
+
121
+ **A quién afecta:**
122
+ - Perú: el piso de velocidad de `Q_Per` en un frente de 12 m² sube de 180 a
123
+ 240 m³/min (12 × 20), y con voladura de ANFO a 300 (12 × 25). El barrido de
124
+ la voladura sube de 18 a 25 m/min con ANFO y a 20 con dinamita. Un frente
125
+ con 10 trabajadores sin flota pasa de 207 a 276 m³/min en el ventilador.
126
+ - Chile: el tajeo sube de 12 a 15 m/min.
127
+ - México con diésel: frente y tajeo suben a 15,24 m/min.
128
+
129
+ #### Cobertura: límites de velocidad de la norma configurada
130
+
131
+ `CoverageParams` traía 20 y 250 m/min (Perú) para todas las normas, y el
132
+ piso de 25 m/min con ANFO se aplicaba en cualquier país. Ahora
133
+ `min_velocity_mpm` y `max_velocity_mpm` valen 0 por defecto, que significa
134
+ «los de la norma», y un valor propio solo puede endurecerlos. Los límites
135
+ efectivos los da `CoverageCalculator.velocity_limits(params, config)`:
136
+
137
+ | Norma | Mínimo | Máximo |
138
+ |---|---|---|
139
+ | Perú (DS 024, Art. 248) | 20 m/min; 25 con ANFO | 250 m/min |
140
+ | Chile (DS 132, Art. 138 inc. 3) | 15 m/min | 150 m/min |
141
+ | Colombia (Decreto 1886, Art. 56 par. 1) | 15 m/min, criterio de ingeniería | 360 m/min |
142
+ | México (NOM-023, 8.4.4 b) | 15,24 m/min | sin máximo |
143
+
144
+ **A quién afecta:** a quien evalúe estaciones de aforo con Chile (una
145
+ estación a 160 m/min ahora no cumple), Colombia (300 m/min ahora cumple;
146
+ el ANFO ya no sube el mínimo) o México (la máxima ya no se aplica). Con
147
+ Perú no cambia nada. Quien leía `CoverageParams().min_velocity_mpm` esperando
148
+ 20 ahora lee 0.
149
+
150
+ #### Velocidad máxima de Chile
151
+
152
+ `max_air_velocity_mpm(DS132_Chile)` devuelve 150 m/min (Art. 138 inc. 3: «Las
153
+ velocidades, como promedio, no podrán ser mayores de ciento cincuenta metros
154
+ por minuto»). Antes no había máxima chilena.
155
+
156
+ **A quién afecta:** a quien calcule con Chile: el Governor advierte sobre
157
+ 150 m/min y la cobertura marca las estaciones por encima.
158
+
159
+ #### Objetivo de dilución: el límite de 8 h de la norma
160
+
161
+ La dilución de gases de voladura (`BlastingParams.target_co_ppm` y
162
+ `target_nox_ppm`) y de escape diésel usaba CO 25 ppm y NOx 5 ppm en toda
163
+ norma. Los 5 ppm son el STEL de NO2 del Anexo 15; su TWA es 3 ppm. Ahora el
164
+ objetivo es el TWA de la tabla de gases de la norma configurada
165
+ (`dilution_target_ppm`); si una norma no fija TWA para un gas, el más
166
+ estricto entre su STEL y su techo. El NOx se diluye como NO2. Los objetivos
167
+ de `BlastingParams` valen 0 por defecto («el de la norma») y el usuario
168
+ puede fijar el suyo; los resultados de voladura y de diésel muestran el
169
+ objetivo usado (`target_co_ppm`, `target_nox_ppm`). Las constantes de
170
+ referencia `TLV_NO2_PPM` y `TLV_SO2_PPM` pasan a 3 y 2 ppm (Anexo 15, TWA).
171
+
172
+ | Norma | CO | NO2 | Caudal por NOx frente a la 0.2.1 |
173
+ |---|---|---|---|
174
+ | Perú (Anexo 15) | 25 ppm | 3 ppm | × 5/3 (+67 %) |
175
+ | Chile (DS 594, Art. 66) | 44 ppm | 2,6 ppm | × 5/2,6 |
176
+ | Colombia (Art. 39) | 25 ppm | 0,2 ppm | × 25 |
177
+ | México (NOM-010, fila 320) | 25 ppm | 0,2 ppm | × 25 |
178
+
179
+ **A quién afecta:** a todo cálculo con voladura o con la dilución por
180
+ contaminante del diésel. Con Colombia y México los caudales por NOx suben
181
+ 25 veces y pasan a gobernar con frecuencia: es lo que exige su límite de
182
+ 0,2 ppm. Quien quiera conservar el criterio anterior debe fijar
183
+ `target_nox_ppm = 5.0` y asumirlo como criterio propio.
184
+
185
+ #### Simultaneidad del diésel: 1,0 por defecto
186
+
187
+ `VentilationInput.simultaneity_factor` valía 0,85. Ninguna norma prevé
188
+ simultaneidad; con el DS 024, `Q_Eq = 3 × HP × Dm × Fu` (Anexo 38) ya la
189
+ incluye en Dm × Fu. Ahora vale 1,0, y con un valor menor el resultado
190
+ advierte que `Q_Eq` queda bajo la norma. El factor por HP tampoco baja ya del
191
+ valor de la norma por la corrección volumétrica del nivel del mar (0,99999).
192
+
193
+ **A quién afecta:** a quien no fijaba la simultaneidad: `Q_Eq` por factor HP
194
+ sube 1/0,85 (+17,6 %). Con 100 HP a 0 msnm el Governor daba 255 m³/min;
195
+ ahora 300, el mínimo del Anexo 38.
196
+
197
+ #### Total de mina peruano: madera y temperatura del Anexo 38
198
+
199
+ El total de mina con el DS 024 (`ZoneType.GeneralMine`) suma ahora los dos
200
+ términos del Anexo 38 que faltaban, con entradas opcionales nuevas de
201
+ `VentilationInput`:
202
+
203
+ - `Q_Ma = T × u` (lit. b): `production_t_per_shift` (T, t métricas húmedas
204
+ por guardia) y `timber_consumption_pct`. u = 0 bajo 20 %; 0,60 de 20 a
205
+ 40 %; 1,00 de 41 a 70 %; 1,25 sobre 70 % (`timber_production_factor`). El
206
+ num. 2 del anexo escribe «> 71» en la última fila; el num. 1 y el Art. 252
207
+ dicen «> 70», que es lo que se usa. Entre 40 y 41 % rige 1,00.
208
+ - `Q_Te = Vm × A × N` (lit. c): `hot_levels` (N, niveles con temperatura
209
+ mayor a 23 °C), A = `face_area_m2` y Vm = 30 m/min.
210
+
211
+ Entran en `Q_T1 = Q_Tr + Q_Ma + Q_Te + Q_Eq`, con fugas del 15 % de `Q_T1`.
212
+ `Q_Te` y el balance térmico (`q_thermal`) responden al mismo concepto, el
213
+ aire para la temperatura de confort del Art. 252 lit. d: rige el mayor de
214
+ los dos, sin sumarlos. El polvo sigue sumando como criterio de ingeniería.
215
+ Sin sus datos cada término vale 0 y el resultado advierte que el total no lo
216
+ incluye. El resultado expone `q_timber_m3min` y `q_temperature_m3min`, y la
217
+ CLI acepta las tres entradas.
218
+
219
+ **A quién afecta:** a quien calcule el total de mina peruano. Sin las
220
+ entradas nuevas el número no cambia, pero aparecen dos advertencias. Con
221
+ ellas el total sube: 100 t por guardia con 30 % de madera agregan 60 m³/min;
222
+ dos niveles calientes con 12 m² agregan 720, o nada si el balance térmico ya
223
+ pedía más.
224
+
225
+ #### Polvo: límite de la norma y corrección Fa de Chile
226
+
227
+ `DustParams.target_concentration_mg_m3` vale 0 por defecto, que significa
228
+ «el límite de la norma»: Perú 3 mg/m³ (Art. 111); Chile 2,4 mg/m³ de polvos
229
+ no especificados, fracción respirable (DS 594, Art. 66), multiplicado sobre
230
+ 1.000 msnm por Fa = P/760 con dos decimales (Art. 63); México 3 mg/m³
231
+ (NOM-010, fila 609); Colombia 3 mg/m³ como criterio de ingeniería (el Art. 74
232
+ remite a la ACGIH). La advertencia de objetivo alto compara con ese límite y
233
+ no con 3 fijo. `calculate_dust_flow` acepta la atmósfera (`atm`) para la
234
+ corrección por altitud.
235
+
236
+ **A quién afecta:** a quien calcule polvo con Chile usando el objetivo por
237
+ defecto: el caudal sube 25 % al nivel del mar (3 → 2,4 mg/m³) y 81 % a
238
+ 3.000 msnm (2,4 × 0,69 = 1,656 mg/m³).
239
+
240
+ #### Chile: óxido nítrico en la tabla de gases
241
+
242
+ La tabla chilena incluye el NO con LPP de 22 ppm (DS 594, Art. 66).
243
+ `lmp_for(DS132_Chile, NO)` ya no lanza error.
244
+
245
+ **A quién afecta:** a quien consulte el NO con Chile (`ventpy lmp --norma
246
+ chile --gas NO` ahora responde) o cuente las filas de la tabla chilena (7 → 8).
247
+
248
+ #### Citas corregidas (sin cambio de números)
249
+
250
+ - Perú: el caudal por persona cita el Art. 247 (el Art. 236 vigente trata de
251
+ vibraciones por voladura); el factor diésel, el Art. 252 lit. e y el
252
+ Anexo 38 num. 1 lit. d (no el Art. 246); el reingreso tras la voladura, el
253
+ Art. 240 (no los Arts. 243-244); el O2 de 19,5 %, el Art. 246 lit. b; las
254
+ mangas a 15 m, el Art. 246 lit. f; el circuito de ventilación, el Art. 246
255
+ lit. c; los límites de gases, el Art. 110 y el Anexo 15 (no el Art. 108).
256
+ El tope de 30 min de dilución deja de llamarse «max normativo»: es criterio
257
+ de ingeniería, como el volumen de 0,04 m³/kg.
258
+ - Chile: polvo y sílice citan el DS 594, Art. 66 (cuarzo 0,08 mg/m³;
259
+ cristobalita y tridimita 0,04); la carga térmica, el Art. 143 que remite al
260
+ DS 594, Arts. 96 a 98 (TGBH); la cobertura de mina, el Art. 139; la
261
+ velocidad, el Art. 138 inc. 3. El metano del Art. 274 se aclara como del
262
+ Título V (carbón). El factor diésel declara que la pequeña minería
263
+ (Título XV, Art. 627: 3 m³/min por HP) no está cubierta por el preajuste.
264
+ - Colombia: la advertencia de velocidad máxima cita el Art. 56 par. 1 y
265
+ menciona los 4,5 m/s de los tajos de carbón (par. 2); ya no remite a
266
+ «límites configurados en CoverageParams».
267
+ - México: la corrección por altitud del factor diésel se declara criterio de
268
+ ingeniería; el objetivo térmico no alcanzable también (igual en las otras
269
+ tres normas).
270
+
271
+ #### API
272
+
273
+ - Nuevas en C++ y Python: `min_air_velocity_mpm`, `max_air_velocity_mpm`
274
+ (ahora también en Python), `dilution_target_ppm`,
275
+ `timber_production_factor` y `CoverageCalculator.velocity_limits`.
276
+ - `get_min_velocity(zone_type, standard=DS024_Peru, diesel=False,
277
+ blasting_agents=False)` depende de la norma; con un solo argumento devuelve
278
+ el valor peruano.
279
+ - Campos nuevos: `VentilationInput.production_t_per_shift`,
280
+ `timber_consumption_pct` y `hot_levels`;
281
+ `VentilationDemandResult.q_timber_m3min` y `q_temperature_m3min`;
282
+ `target_co_ppm` y `target_nox_ppm` en los resultados de voladura y diésel.
283
+
284
+ #### Ejemplos
285
+
286
+ `01-demanda-peru` pasa de 981 a 1.923 m³/min, `02-preset-chile` de 981 a
287
+ 2.219 y en `03-cobertura-levantamiento` cada zona requiere 276 m³/min en vez
288
+ de 207 (los aforos del ejemplo se ajustaron para conservar el caso). Cada
289
+ README explica la derivación.
290
+
291
+ ### Pequeña minería chilena, sílice y tajos de carbón
292
+
293
+ - **`RegulatoryConfig.chile_small_mining()`**: preajuste para faenas de hasta
294
+ 5.000 t/mes (DS 132, Título XV, ámbito del Art. 594). Igual a `chile()` salvo
295
+ 3 m³/min por HP (Art. 627); las citas de caudal por persona y por HP nombran
296
+ el Art. 627.
297
+ - **Sílice respirable**: con `DustParams.silica_content_percent` > 0, el
298
+ objetivo de polvo por defecto es el menor entre el límite respirable y el
299
+ límite de sílice dividido entre la fracción de sílice. Perú 0,05 mg/m³
300
+ (Anexo 15), Chile cuarzo 0,08 o, con `silica_cristobalite_or_tridymite`,
301
+ 0,04 mg/m³ (DS 594, Art. 66, con Fa), México 0,025 mg/m³ (NOM-010, fila 668).
302
+ Colombia remite a la ACGIH sin fijar el valor: solo se advierte.
303
+ - **`VentilationInput.coal_mine`**: con Colombia, el máximo en tajos baja a
304
+ 4,5 m/s = 270 m/min (Decreto 1886, Art. 56 par. 2). El resultado advierte que
305
+ las demás reglas de carbón no están implementadas.
306
+
307
+ **A quién afecta:** a quien declare contenido de sílice sin fijar un objetivo
308
+ propio: con 10 % de sílice en Perú el objetivo baja de 3 a 0,5 mg/m³ y el
309
+ caudal por polvo sube seis veces. Los otros dos cambios solo actúan si se
310
+ eligen.
311
+
312
+ ### Metadatos del paquete
313
+
314
+ - `pyproject.toml` declara los clasificadores de Python 3.9, 3.10, 3.11, 3.12 y 3.13, las
315
+ mismas versiones para las que `cibuildwheel` ya compila ruedas. Así PyPI las muestra en la
316
+ ficha del paquete. No cambia el código.
317
+ - Ya no se publican ruedas para Linux de 32 bits (`manylinux_i686`): su contenedor de
318
+ compilación no logra instalar `scikit-build-core`. En esa plataforma `pip` compila desde
319
+ el código fuente publicado.
320
+
321
+ ### Normas de Colombia y México
322
+
323
+ Dos preajustes nuevos, con el mismo patrón que el chileno: cada valor cita el
324
+ artículo o numeral leído en el texto vigente, y donde la norma no regula un
325
+ concepto la cita lo declara en vez de tomar prestado el artículo de otro país.
326
+
327
+ | Concepto | Colombia (Decreto 1886 de 2015) | México (NOM-023-STPS-2012) |
328
+ |---|---|---|
329
+ | Caudal por persona | 3 m³/min hasta 1.500 msnm y 6 de 1.500 en adelante (Art. 54, nums. 1 y 2) | 1,50 m³/min, sin escala por altitud (numeral 8.4.4 a) 1) |
330
+ | Caudal por HP diésel | 6 m³/min con CO en el escape ≤ 0,12 % (Art. 54, par. 2, num. 1) | 2,13 m³/min (numeral 8.4.4 a) 2) |
331
+ | Voladura | Sin tiempo de dilución; reingreso no antes de 15 min (Art. 157) | Sin tiempo de dilución; reconocimiento a los 30 min y sin humo (numeral 8.6.9 g) |
332
+ | Gases | Tabla del Art. 39; oxígeno en el Art. 38 y metano en el Art. 53 | NOM-010-STPS-2014, Tabla I.1, por remisión de la NOM-023 |
333
+ | Polvo | Remite a los VLP de la ACGIH (Art. 74) | NOM-010-STPS-2014, Tabla I.1 |
334
+ | Carga térmica | Temperatura efectiva (Arts. 217 y 218): el piso de 30 m/min queda como criterio de ingeniería | Índice TGBH de la NOM-015-STPS-2001: el piso de 30 m/min queda como criterio de ingeniería |
335
+
336
+ - `RegulatoryConfig.colombia()` y `RegulatoryConfig.mexico()`, los miembros
337
+ `RegulatoryStandard.D1886_Colombia` y `RegulatoryStandard.NOM023_Mexico`, y
338
+ `--norma colombia|mexico` en `ventpy demanda`, `ventpy lmp` y
339
+ `ventpy cobertura`.
340
+ - **Colombia, borde de 1.500 msnm.** Las dos bandas del Art. 54 incluyen el
341
+ 1.500 en su texto. Rige la regla común de la librería: a 1.500 msnm exactos
342
+ aplica la banda alta (6 m³/min).
343
+ - **Colombia, factor diésel.** El preajuste usa 6 m³/min por HP. Quien acredite
344
+ CO en el escape ≤ 0,08 % puede construir su configuración con 4 (Art. 54,
345
+ par. 2, num. 2). Con CO sobre 0,12 % el decreto no da valor.
346
+ - **México, oxígeno.** La NOM-023 no fija el mínimo de oxígeno en labores. La
347
+ tabla trae 19,5 % como criterio de ingeniería y la cita lo dice.
348
+ - **México, carbón.** La NOM-023 exceptúa las minas de carbón, que se rigen por
349
+ la NOM-032-STPS-2008. Este preajuste no las cubre.
350
+ - En las dos tablas de gases el SO2 solo tiene límite de corto tiempo: su
351
+ `twa_8h` es `None`, no cero.
352
+ - Colombia se verificó contra el texto consolidado con el Decreto 944 de 2022
353
+ y México contra el DOF del 11-oct-2012 y del 28-abr-2014.
354
+
355
+ ### Correcciones
356
+
357
+ - `shock_factors()` listaba `x = 0.0` en expansión, contracción, codos y unión,
358
+ donde el factor sale por fórmula o es manual. Un cero se lee como «sin
359
+ pérdida»: ahora `x` es `None` en esas filas.
360
+
361
+ ### Documentación de la API
362
+
363
+ - Los campos de `GasLimit` que la norma no fija valen `None`, y la ayuda lo
364
+ dice.
365
+ - `calculate_diesel_flow` aclara que solo aplica el factor por HP de la norma;
366
+ la dilución de CO y NOx por contaminante la calcula `VentilationGovernor`.
367
+
368
+ ## [0.2.1] — 2026-08-20
369
+
370
+ ### La cita normativa sigue a la norma configurada
371
+
372
+ Hasta 0.2.0 la referencia legal de cada resultado estaba escrita como literal
373
+ peruano dentro de cada calculador y no consultaba la norma de la
374
+ configuración. Con `RegulatoryConfig.chile()` los caudales eran correctos,
375
+ pero la cita que los acompañaba era el DS 024-2016-EM peruano.
376
+
377
+ **A quién afecta:** a quien haya emitido informes con el preajuste chileno. Los
378
+ números no cambian —ni uno solo—; lo que cambia es el respaldo legal impreso
379
+ junto a ellos. Conviene reemitir esos informes: citaban el reglamento peruano
380
+ en una faena chilena.
381
+
382
+ | Resultado | Perú (DS 024) | Chile (DS 132) |
383
+ |---|---|---|
384
+ | Caudal por persona | Art. 236, con la escala por altitud del Art. 247 | **Art. 138**, sin escala por altitud |
385
+ | Caudal por HP diésel | Art. 246 | **Art. 132** |
386
+ | Dilución tras voladura | Art. 243-244 | **Arts. 156, 571 y 585** (reingreso). El DS 132 no fija tiempo de dilución ni volumen de gases por kg: son criterio de ingeniería, y la cita lo dice |
387
+ | Polvo respirable | Art. 111 | Sin límite verificado: la cita declara el vacío y atribuye la concentración objetivo a criterio de ingeniería |
388
+ | Carga térmica | Art. 252 lit. d | Sin criterio verificado: el piso de 30 m/min se mantiene —el caudal es el mismo— pero la cita lo declara criterio de ingeniería |
389
+ | Cobertura y velocidad del aire | Art. 252 lit. f/g y Art. 248 | Sin régimen ni límites verificados: la cita declara el vacío y remite a los umbrales configurados |
390
+
391
+ Donde el DS 132 no regula un concepto, la cita lo dice explícitamente en vez de
392
+ trasladar el artículo peruano. Ningún artículo chileno se cita sin verificar
393
+ contra el texto vigente (LeyChile idNorma=221064, versión 09-abr-2024).
394
+
395
+ ### Cambios
396
+
397
+ - Nueva función `regulation_reference(topic, config)` en `normativa.hpp`: único
398
+ lugar del núcleo donde vive el texto de una cita. Cada calculador la consulta
399
+ en lugar de llevar su propio literal.
400
+ - `CoverageCalculator.compare_zone` acepta un cuarto argumento `config` que fija
401
+ la norma de la cita. Su valor por defecto es el preajuste peruano, igual que
402
+ el constructor por defecto de `RegulatoryConfig`; el código existente no
403
+ cambia de comportamiento. `analyze_survey` propaga la configuración que ya
404
+ recibía.
405
+ - Las advertencias de sílice, de concentración de polvo sobre el umbral, de
406
+ estrés térmico y de velocidad fuera de rango también siguen la norma activa.
407
+
408
+ ### Versiones
409
+
410
+ - `CMakeLists.txt` declaraba 0.1.0 mientras `pyproject.toml` y el paquete
411
+ Python declaraban 0.2.0. Las tres quedan en 0.2.1.
412
+
413
+ ## [0.2.0] — 2026-08-20
414
+
415
+ ### ⚠️ Los resultados cambian respecto de 0.1.0
416
+
417
+ Esta versión corrige tres citas normativas del núcleo. **Un cálculo hecho con
418
+ 0.1.0 puede quedar por debajo del mínimo legal**, así que conviene rehacer los
419
+ que se hayan emitido con esa versión.
420
+
421
+ | Corrección | 0.1.0 | 0.2.0 |
422
+ |---|---|---|
423
+ | Escala de caudal por persona (DS 024-2016-EM, **Art. 247**) | 3/4/5 m³/min con umbrales de 3.000 y 4.000 msnm | **3/4/5/6** m³/min con umbrales de **1.500, 3.000 y 4.000** msnm, que es el texto vigente del artículo |
424
+ | Polvo respirable | citado como "Art. 103-107" | **Art. 111**: límite de 3 mg/m³ para jornada de 8 h, con paralización de la labor si se supera |
425
+ | Temperatura efectiva máxima | citada como "Art. 240: 30 °C" | No existe en la norma vigente (proviene del derogado DS 055-2010-EM). El criterio normativo real es el **Art. 252 lit. d** (velocidad mínima de 30 m/min con temperatura seca entre 24 y 29 °C) y la remisión del **Art. 104 / Anexo 13** para estrés térmico |
426
+
427
+ El efecto práctico de la primera corrección: toda mina por encima de 1.500 msnm
428
+ exige más aire por persona del que 0.1.0 calculaba.
429
+
430
+ ### Cambio incompatible
431
+
432
+ - El constructor de `RegulatoryConfig` pasa de 10 a 12 parámetros por el tercer
433
+ umbral de altitud del Art. 247. Quien use los preajustes
434
+ (`RegulatoryConfig.peru()`, `.chile()`, `.for_standard()`) no necesita
435
+ cambiar nada; solo afecta a quien construya la configuración parámetro a
436
+ parámetro.
437
+
438
+ ### Nuevas capacidades
439
+
440
+ - **Multi-norma.** Preajustes por país mediante `peru()`, `chile()` y
441
+ `for_standard()`. El preajuste chileno implementa el DS 132 (Art. 138:
442
+ 3 m³/min por persona sin escalón por altitud; Art. 132: 2,83 m³/min por HP
443
+ efectivo al freno).
444
+ - **Límites máximos permisibles de gases** consultables por norma
445
+ (`gas_limits`, `lmp_for`): Perú (DS 024, Anexo 15) y Chile (DS 594 / DS 132),
446
+ con la cita de cada valor. Un gas no regulado por la norma lanza una
447
+ excepción en vez de devolver un valor por omisión.
448
+ - **Cobertura y déficit de ventilación** (Art. 252, literales f y g): compara
449
+ el caudal medido en campo, directo o por estaciones de aforo, contra el
450
+ requerido, por labor y para la mina completa, con verificación de la
451
+ velocidad del aire del Art. 248.
452
+ - **Red de ventilación**: resistencias de Atkinson con corrección por densidad
453
+ y pérdidas por choque, dimensionamiento de ducto con criterio técnico y
454
+ económico, balance de red por el método de Hardy Cross con detección
455
+ automática de mallas, y curva de ventilador con punto de operación y margen
456
+ de entrada en pérdida.
457
+ - **Polvo respirable y carga térmica** integrados al cálculo consolidado.
458
+ - **Interfaz de línea de comandos** `ventpy` con cinco subcomandos sobre
459
+ archivos JSON y códigos de salida pensados para automatización: 0 correcto,
460
+ 1 error de entrada y 2 resultado no confiable.
461
+ - **Ejemplos resueltos** en `examples/`, cada uno con su comando, la salida
462
+ esperada y el artículo que lo sustenta.
463
+
464
+ ### Correcciones
465
+
466
+ - El solver de red rechaza resistencias no finitas. Un valor infinito se
467
+ aceptaba y el balance devolvía caudales inválidos marcados como convergidos.
468
+ - Las funciones de validación rechazan NaN e infinito en todos sus parámetros.
469
+ - El cálculo simplificado de gases de voladura recupera la advertencia por
470
+ exceder el tiempo máximo de dilución del Art. 243.
471
+
472
+ ### Interno
473
+
474
+ - La suite pasó de 55 a 197 pruebas en C++ y 151 en Python, incluidas pruebas
475
+ basadas en propiedades y de escala hasta 500 ramales.
476
+ - Integración continua en Linux, macOS y Windows, con analizadores dinámicos
477
+ de memoria y comportamiento indefinido, y medición de cobertura.
478
+
479
+ ## [0.1.0] — 2026-08-16
480
+
481
+ - Primera versión publicada: cálculo de demanda de ventilación según
482
+ DS 024-2016-EM (personal, equipos diésel, explosivos y fugas), correcciones
483
+ atmosféricas por altitud y visualización opcional.
@@ -1,6 +1,6 @@
1
1
  cmake_minimum_required(VERSION 3.20)
2
2
  project(ventpy
3
- VERSION 0.1.0
3
+ VERSION 0.3.0
4
4
  DESCRIPTION "High-performance mine ventilation calculation library"
5
5
  LANGUAGES CXX
6
6
  )
@@ -98,6 +98,7 @@ if(VENTPY_BUILD_TESTS)
98
98
  tests/cpp/test_caudal_termico.cpp
99
99
  tests/cpp/test_governor.cpp
100
100
  tests/cpp/test_normativa.cpp
101
+ tests/cpp/test_citas_normativas.cpp
101
102
  tests/cpp/test_limites_gases.cpp
102
103
  tests/cpp/test_cobertura.cpp
103
104
  tests/cpp/test_atkinson.cpp
@@ -1,8 +1,9 @@
1
1
  # Contributing to VentPy · Cómo contribuir a VentPy
2
2
 
3
3
  VentPy is an open-source library for **mine ventilation calculations**. It started with the
4
- Peruvian standard (DS 024-2016-EM) and is growing toward **multi-standard support across Latin
5
- America**: Chile, Colombia and Mexico.
4
+ Peruvian standard (DS 024-2016-EM), now also covers Chile (DS 132), Colombia (Decreto 1886)
5
+ and Mexico (NOM-023-STPS-2012), and is growing toward **multi-standard support across Latin
6
+ America**.
6
7
 
7
8
  > 🇪🇸 **Este documento está en inglés y español.** Baja para la versión en español.
8
9
  > **No necesitas ser programador experto.** Si eres ingeniero de minas y conoces la norma de tu
@@ -38,7 +39,7 @@ pip install -e ".[test,viz]"
38
39
  pytest tests/python -q
39
40
 
40
41
  # 4. Create a branch, make your change, run tests again
41
- git checkout -b add-chile-standard
42
+ git checkout -b add-bolivia-standard
42
43
  pytest tests/python -q
43
44
 
44
45
  # 5. Commit and open a Pull Request
@@ -65,8 +66,8 @@ clear to you, it wasn't clear enough.
65
66
 
66
67
  **No necesitas escribir C++.** En orden de lo que más falta:
67
68
 
68
- 1. **Agregar la norma de tu país.** ¿Conoces el reglamento de ventilación de Chile, Colombia o
69
- México? Esa es la contribución que más necesitamos. Mira `ROADMAP.md`.
69
+ 1. **Agregar la norma de tu país.** ¿Conoces el reglamento de ventilación de Bolivia, Ecuador,
70
+ Argentina u otro país? Esa es la contribución que más necesitamos. Mira `ROADMAP.md`.
70
71
  2. **Casos resueltos.** Un caso real de ventilación (anonimizado) con sus números, como test.
71
72
  3. **Documentación.** Corregir un párrafo confuso, traducir, agregar un diagrama.
72
73
  4. **Reportar un número equivocado.** Si un resultado no calza con tu experiencia en campo,
@@ -87,7 +88,7 @@ pip install -e ".[test,viz]"
87
88
  pytest tests/python -q
88
89
 
89
90
  # 4. Crea una rama, haz tu cambio, corre los tests otra vez
90
- git checkout -b agregar-norma-chile
91
+ git checkout -b agregar-norma-bolivia
91
92
  pytest tests/python -q
92
93
 
93
94
  # 5. Commitea y abre un Pull Request