disdrodb 0.2.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

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 (315) hide show
  1. disdrodb/__init__.py +1 -1
  2. disdrodb/_config.py +1 -3
  3. disdrodb/_version.py +2 -2
  4. disdrodb/accessor/__init__.py +1 -1
  5. disdrodb/accessor/methods.py +18 -11
  6. disdrodb/api/checks.py +2 -4
  7. disdrodb/api/configs.py +1 -3
  8. disdrodb/api/create_directories.py +4 -6
  9. disdrodb/api/info.py +1 -3
  10. disdrodb/api/io.py +15 -9
  11. disdrodb/api/path.py +1 -3
  12. disdrodb/cli/disdrodb_check_metadata_archive.py +2 -2
  13. disdrodb/cli/disdrodb_check_products_options.py +44 -0
  14. disdrodb/cli/disdrodb_create_summary.py +48 -22
  15. disdrodb/cli/disdrodb_create_summary_station.py +39 -18
  16. disdrodb/cli/disdrodb_data_archive_directory.py +1 -3
  17. disdrodb/cli/disdrodb_download_archive.py +45 -24
  18. disdrodb/cli/disdrodb_download_metadata_archive.py +27 -16
  19. disdrodb/cli/disdrodb_download_station.py +56 -26
  20. disdrodb/cli/disdrodb_initialize_station.py +40 -20
  21. disdrodb/cli/disdrodb_metadata_archive_directory.py +1 -3
  22. disdrodb/cli/disdrodb_open_data_archive.py +16 -11
  23. disdrodb/cli/disdrodb_open_logs_directory.py +29 -18
  24. disdrodb/cli/disdrodb_open_metadata_archive.py +25 -11
  25. disdrodb/cli/disdrodb_open_metadata_directory.py +32 -20
  26. disdrodb/cli/disdrodb_open_product_directory.py +38 -21
  27. disdrodb/cli/disdrodb_open_readers_directory.py +1 -3
  28. disdrodb/cli/disdrodb_run.py +189 -0
  29. disdrodb/cli/disdrodb_run_l0.py +55 -64
  30. disdrodb/cli/disdrodb_run_l0_station.py +47 -52
  31. disdrodb/cli/disdrodb_run_l0a.py +47 -45
  32. disdrodb/cli/disdrodb_run_l0a_station.py +38 -37
  33. disdrodb/cli/disdrodb_run_l0b.py +45 -45
  34. disdrodb/cli/disdrodb_run_l0b_station.py +37 -36
  35. disdrodb/cli/disdrodb_run_l0c.py +50 -47
  36. disdrodb/cli/disdrodb_run_l0c_station.py +41 -38
  37. disdrodb/cli/disdrodb_run_l1.py +49 -45
  38. disdrodb/cli/disdrodb_run_l1_station.py +40 -37
  39. disdrodb/cli/disdrodb_run_l2e.py +50 -45
  40. disdrodb/cli/disdrodb_run_l2e_station.py +41 -37
  41. disdrodb/cli/disdrodb_run_l2m.py +49 -45
  42. disdrodb/cli/disdrodb_run_l2m_station.py +40 -37
  43. disdrodb/cli/disdrodb_run_station.py +184 -0
  44. disdrodb/cli/disdrodb_upload_archive.py +45 -35
  45. disdrodb/cli/disdrodb_upload_station.py +39 -32
  46. disdrodb/configs.py +13 -8
  47. disdrodb/constants.py +4 -2
  48. disdrodb/data_transfer/__init__.py +1 -3
  49. disdrodb/data_transfer/download_data.py +38 -54
  50. disdrodb/data_transfer/upload_data.py +1 -3
  51. disdrodb/data_transfer/zenodo.py +1 -3
  52. disdrodb/docs.py +1 -3
  53. disdrodb/etc/configs/attributes.yaml +52 -2
  54. disdrodb/etc/configs/encodings.yaml +45 -1
  55. disdrodb/etc/products/L0C/ODM470/global.yaml +5 -0
  56. disdrodb/etc/products/L0C/global.yaml +5 -0
  57. disdrodb/etc/products/L1/ODM470/global.yaml +6 -0
  58. disdrodb/etc/products/L1/global.yaml +1 -14
  59. disdrodb/etc/products/L2E/LPM/1MIN.yaml +1 -0
  60. disdrodb/etc/products/L2E/LPM/global.yaml +36 -0
  61. disdrodb/etc/products/L2E/LPM_V0/1MIN.yaml +1 -0
  62. disdrodb/etc/products/L2E/LPM_V0/global.yaml +36 -0
  63. disdrodb/etc/products/L2E/ODM470/1MIN.yaml +1 -0
  64. disdrodb/etc/products/L2E/ODM470/global.yaml +36 -0
  65. disdrodb/etc/products/L2E/PARSIVEL/1MIN.yaml +1 -0
  66. disdrodb/etc/products/L2E/PARSIVEL/global.yaml +36 -0
  67. disdrodb/etc/products/L2E/PARSIVEL2/1MIN.yaml +1 -0
  68. disdrodb/etc/products/L2E/PARSIVEL2/global.yaml +36 -0
  69. disdrodb/etc/products/L2E/PWS100/1MIN.yaml +1 -0
  70. disdrodb/etc/products/L2E/PWS100/global.yaml +36 -0
  71. disdrodb/etc/products/L2E/RD80/1MIN.yaml +19 -0
  72. disdrodb/etc/products/L2E/SWS250/1MIN.yaml +19 -0
  73. disdrodb/etc/products/L2E/global.yaml +17 -3
  74. disdrodb/etc/products/L2M/global.yaml +1 -1
  75. disdrodb/fall_velocity/__init__.py +46 -0
  76. disdrodb/fall_velocity/graupel.py +483 -0
  77. disdrodb/fall_velocity/hail.py +287 -0
  78. disdrodb/{l1/fall_velocity.py → fall_velocity/rain.py} +265 -50
  79. disdrodb/issue/__init__.py +1 -3
  80. disdrodb/issue/checks.py +3 -5
  81. disdrodb/issue/reader.py +1 -3
  82. disdrodb/issue/writer.py +1 -3
  83. disdrodb/l0/__init__.py +1 -1
  84. disdrodb/l0/check_configs.py +26 -17
  85. disdrodb/l0/check_standards.py +1 -3
  86. disdrodb/l0/configs/LPM/l0a_encodings.yml +0 -1
  87. disdrodb/l0/configs/LPM/l0b_cf_attrs.yml +0 -4
  88. disdrodb/l0/configs/LPM/l0b_encodings.yml +9 -9
  89. disdrodb/l0/configs/LPM/raw_data_format.yml +11 -11
  90. disdrodb/l0/configs/LPM_V0/bins_diameter.yml +103 -0
  91. disdrodb/l0/configs/LPM_V0/bins_velocity.yml +103 -0
  92. disdrodb/l0/configs/LPM_V0/l0a_encodings.yml +45 -0
  93. disdrodb/l0/configs/LPM_V0/l0b_cf_attrs.yml +180 -0
  94. disdrodb/l0/configs/LPM_V0/l0b_encodings.yml +410 -0
  95. disdrodb/l0/configs/LPM_V0/raw_data_format.yml +474 -0
  96. disdrodb/l0/configs/ODM470/bins_diameter.yml +643 -0
  97. disdrodb/l0/configs/ODM470/bins_velocity.yml +0 -0
  98. disdrodb/l0/configs/ODM470/l0a_encodings.yml +11 -0
  99. disdrodb/l0/configs/ODM470/l0b_cf_attrs.yml +46 -0
  100. disdrodb/l0/configs/ODM470/l0b_encodings.yml +106 -0
  101. disdrodb/l0/configs/ODM470/raw_data_format.yml +111 -0
  102. disdrodb/l0/configs/PARSIVEL/l0b_cf_attrs.yml +1 -1
  103. disdrodb/l0/configs/PARSIVEL/raw_data_format.yml +8 -8
  104. disdrodb/l0/configs/PARSIVEL2/raw_data_format.yml +9 -9
  105. disdrodb/l0/l0_reader.py +1 -3
  106. disdrodb/l0/l0a_processing.py +7 -5
  107. disdrodb/l0/l0b_nc_processing.py +2 -4
  108. disdrodb/l0/l0b_processing.py +27 -22
  109. disdrodb/l0/l0c_processing.py +37 -11
  110. disdrodb/l0/manuals/LPM_V0.pdf +0 -0
  111. disdrodb/l0/readers/LPM/ARM/ARM_LPM.py +1 -1
  112. disdrodb/l0/readers/LPM/AUSTRALIA/MELBOURNE_2007_LPM.py +1 -1
  113. disdrodb/l0/readers/LPM/BRAZIL/CHUVA_LPM.py +1 -1
  114. disdrodb/l0/readers/LPM/BRAZIL/GOAMAZON_LPM.py +1 -1
  115. disdrodb/l0/readers/LPM/GERMANY/DWD.py +190 -12
  116. disdrodb/l0/readers/LPM/ITALY/GID_LPM.py +63 -14
  117. disdrodb/l0/readers/LPM/ITALY/GID_LPM_PI.py +279 -0
  118. disdrodb/l0/readers/LPM/ITALY/GID_LPM_T.py +279 -0
  119. disdrodb/l0/readers/LPM/ITALY/GID_LPM_W.py +3 -5
  120. disdrodb/l0/readers/LPM/KIT/CHWALA.py +1 -3
  121. disdrodb/l0/readers/LPM/NETHERLANDS/DELFT_LPM_NC.py +1 -1
  122. disdrodb/l0/readers/LPM/NETHERLANDS/DELFT_RWANDA_LPM_NC.py +103 -0
  123. disdrodb/l0/readers/LPM/NORWAY/HAUKELISETER_LPM.py +214 -0
  124. disdrodb/l0/readers/LPM/NORWAY/NMBU_LPM.py +206 -0
  125. disdrodb/l0/readers/LPM/SLOVENIA/ARSO.py +1 -3
  126. disdrodb/l0/readers/LPM/SLOVENIA/UL.py +1 -3
  127. disdrodb/l0/readers/LPM/SWITZERLAND/INNERERIZ_LPM.py +1 -3
  128. disdrodb/l0/readers/LPM/UK/DIVEN.py +1 -1
  129. disdrodb/l0/readers/LPM/UK/WITHWORTH_LPM.py +217 -0
  130. disdrodb/l0/readers/LPM/USA/CHARLESTON.py +227 -0
  131. disdrodb/l0/readers/{LPM → LPM_V0}/BELGIUM/ULIEGE.py +34 -52
  132. disdrodb/l0/readers/LPM_V0/ITALY/GID_LPM_V0.py +240 -0
  133. disdrodb/l0/readers/ODM470/OCEAN/OCEANRAIN.py +123 -0
  134. disdrodb/l0/readers/PARSIVEL/AUSTRALIA/MELBOURNE_2007_PARSIVEL.py +1 -1
  135. disdrodb/l0/readers/PARSIVEL/BASQUECOUNTRY/EUSKALMET_OTT.py +1 -1
  136. disdrodb/l0/readers/PARSIVEL/CHINA/CHONGQING.py +1 -3
  137. disdrodb/l0/readers/PARSIVEL/EPFL/ARCTIC_2021.py +1 -1
  138. disdrodb/l0/readers/PARSIVEL/EPFL/COMMON_2011.py +1 -1
  139. disdrodb/l0/readers/PARSIVEL/EPFL/DAVOS_2009_2011.py +1 -1
  140. disdrodb/l0/readers/PARSIVEL/EPFL/EPFL_2009.py +1 -1
  141. disdrodb/l0/readers/PARSIVEL/EPFL/EPFL_ROOF_2008.py +1 -1
  142. disdrodb/l0/readers/PARSIVEL/EPFL/EPFL_ROOF_2010.py +1 -1
  143. disdrodb/l0/readers/PARSIVEL/EPFL/EPFL_ROOF_2011.py +1 -1
  144. disdrodb/l0/readers/PARSIVEL/EPFL/EPFL_ROOF_2012.py +1 -1
  145. disdrodb/l0/readers/PARSIVEL/EPFL/GENEPI_2007.py +1 -1
  146. disdrodb/l0/readers/PARSIVEL/EPFL/GRAND_ST_BERNARD_2007.py +1 -1
  147. disdrodb/l0/readers/PARSIVEL/EPFL/GRAND_ST_BERNARD_2007_2.py +1 -1
  148. disdrodb/l0/readers/PARSIVEL/EPFL/HPICONET_2010.py +1 -1
  149. disdrodb/l0/readers/PARSIVEL/EPFL/HYMEX_LTE_SOP2.py +1 -1
  150. disdrodb/l0/readers/PARSIVEL/EPFL/HYMEX_LTE_SOP3.py +1 -1
  151. disdrodb/l0/readers/PARSIVEL/EPFL/HYMEX_LTE_SOP4.py +1 -1
  152. disdrodb/l0/readers/PARSIVEL/EPFL/LOCARNO_2018.py +1 -1
  153. disdrodb/l0/readers/PARSIVEL/EPFL/LOCARNO_2019.py +1 -1
  154. disdrodb/l0/readers/PARSIVEL/EPFL/PARADISO_2014.py +1 -1
  155. disdrodb/l0/readers/PARSIVEL/EPFL/PARSIVEL_2007.py +1 -1
  156. disdrodb/l0/readers/PARSIVEL/EPFL/PLATO_2019.py +1 -1
  157. disdrodb/l0/readers/PARSIVEL/EPFL/RACLETS_2019.py +1 -1
  158. disdrodb/l0/readers/PARSIVEL/EPFL/RACLETS_2019_WJF.py +1 -1
  159. disdrodb/l0/readers/PARSIVEL/EPFL/RIETHOLZBACH_2011.py +1 -1
  160. disdrodb/l0/readers/PARSIVEL/EPFL/SAMOYLOV_2017.py +1 -1
  161. disdrodb/l0/readers/PARSIVEL/EPFL/SAMOYLOV_2019.py +1 -1
  162. disdrodb/l0/readers/PARSIVEL/EPFL/UNIL_2022.py +1 -1
  163. disdrodb/l0/readers/PARSIVEL/JAPAN/JMA.py +1 -1
  164. disdrodb/l0/readers/PARSIVEL/KOREA/ICEPOP_MSC.py +159 -0
  165. disdrodb/l0/readers/PARSIVEL/NASA/LPVEX.py +26 -14
  166. disdrodb/l0/readers/PARSIVEL/NASA/MC3E.py +2 -2
  167. disdrodb/l0/readers/PARSIVEL/NCAR/CCOPE_2015.py +1 -1
  168. disdrodb/l0/readers/PARSIVEL/NCAR/OWLES_MIPS.py +1 -1
  169. disdrodb/l0/readers/PARSIVEL/NCAR/PECAN_MOBILE.py +1 -1
  170. disdrodb/l0/readers/PARSIVEL/NCAR/PLOWS_MIPS.py +1 -1
  171. disdrodb/l0/readers/PARSIVEL/NCAR/VORTEX2_2009.py +1 -1
  172. disdrodb/l0/readers/PARSIVEL/NCAR/VORTEX2_2010.py +1 -3
  173. disdrodb/l0/readers/PARSIVEL/NCAR/VORTEX2_2010_UF.py +1 -3
  174. disdrodb/l0/readers/PARSIVEL/SLOVENIA/UL.py +1 -1
  175. disdrodb/l0/readers/PARSIVEL2/ARM/ARM_PARSIVEL2.py +1 -1
  176. disdrodb/l0/readers/PARSIVEL2/BASQUECOUNTRY/EUSKALMET_OTT2.py +2 -2
  177. disdrodb/l0/readers/PARSIVEL2/BELGIUM/ILVO.py +1 -3
  178. disdrodb/l0/readers/PARSIVEL2/BRAZIL/CHUVA_PARSIVEL2.py +1 -1
  179. disdrodb/l0/readers/PARSIVEL2/BRAZIL/GOAMAZON_PARSIVEL2.py +1 -1
  180. disdrodb/l0/readers/PARSIVEL2/CANADA/UQAM_NC.py +1 -1
  181. disdrodb/l0/readers/PARSIVEL2/DENMARK/DTU.py +1 -1
  182. disdrodb/l0/readers/PARSIVEL2/DENMARK/EROSION_nc.py +1 -1
  183. disdrodb/l0/readers/PARSIVEL2/DENMARK/EROSION_raw.py +1 -1
  184. disdrodb/l0/readers/PARSIVEL2/FINLAND/FMI_PARSIVEL2.py +1 -1
  185. disdrodb/l0/readers/PARSIVEL2/FRANCE/ENPC_PARSIVEL2.py +1 -3
  186. disdrodb/l0/readers/PARSIVEL2/FRANCE/OSUG.py +1 -1
  187. disdrodb/l0/readers/PARSIVEL2/FRANCE/SIRTA_PARSIVEL2.py +1 -3
  188. disdrodb/l0/readers/PARSIVEL2/GREECE/NOA.py +4 -3
  189. disdrodb/l0/readers/PARSIVEL2/ITALY/GID_PARSIVEL2.py +1 -3
  190. disdrodb/l0/readers/PARSIVEL2/ITALY/HYDROX.py +5 -3
  191. disdrodb/l0/readers/PARSIVEL2/JAPAN/PRECIP.py +155 -0
  192. disdrodb/l0/readers/PARSIVEL2/KIT/BURKINA_FASO.py +1 -1
  193. disdrodb/l0/readers/PARSIVEL2/KIT/TEAMX.py +1 -1
  194. disdrodb/l0/readers/PARSIVEL2/KOREA/ICEPOP_MSC.py +161 -0
  195. disdrodb/l0/readers/PARSIVEL2/{NASA/GCPEX.py → KOREA/ICEPOP_UCLM.py} +51 -31
  196. disdrodb/l0/readers/PARSIVEL2/MEXICO/OH_IIUNAM_nc.py +1 -1
  197. disdrodb/l0/readers/PARSIVEL2/MPI/BCO_PARSIVEL2.py +15 -8
  198. disdrodb/l0/readers/PARSIVEL2/MPI/BOWTIE.py +9 -4
  199. disdrodb/l0/readers/PARSIVEL2/NASA/APU.py +31 -6
  200. disdrodb/l0/readers/PARSIVEL2/NASA/NSSTC.py +1 -1
  201. disdrodb/l0/readers/PARSIVEL2/NCAR/FARM_PARSIVEL2.py +1 -1
  202. disdrodb/l0/readers/PARSIVEL2/NCAR/PECAN_FP3.py +1 -1
  203. disdrodb/l0/readers/PARSIVEL2/NCAR/PECAN_MIPS.py +1 -1
  204. disdrodb/l0/readers/PARSIVEL2/NCAR/PERILS_MIPS.py +1 -1
  205. disdrodb/l0/readers/PARSIVEL2/NCAR/PERILS_PIPS.py +1 -1
  206. disdrodb/l0/readers/PARSIVEL2/NCAR/RELAMPAGO_PARSIVEL2.py +2 -2
  207. disdrodb/l0/readers/PARSIVEL2/NCAR/SNOWIE_PJ.py +1 -1
  208. disdrodb/l0/readers/PARSIVEL2/NCAR/SNOWIE_SB.py +1 -1
  209. disdrodb/l0/readers/PARSIVEL2/NCAR/VORTEX_SE_2016_P1.py +1 -3
  210. disdrodb/l0/readers/PARSIVEL2/NCAR/VORTEX_SE_2016_P2.py +1 -1
  211. disdrodb/l0/readers/PARSIVEL2/NCAR/VORTEX_SE_2016_PIPS.py +1 -1
  212. disdrodb/l0/readers/PARSIVEL2/NETHERLANDS/DELFT_NC.py +1 -1
  213. disdrodb/l0/readers/{PARSIVEL/NASA/PIERS.py → PARSIVEL2/NORWAY/UIB.py} +65 -31
  214. disdrodb/l0/readers/PARSIVEL2/PHILIPPINES/PAGASA.py +7 -6
  215. disdrodb/l0/readers/PARSIVEL2/SPAIN/CENER.py +1 -1
  216. disdrodb/l0/readers/PARSIVEL2/SPAIN/CR1000DL.py +1 -1
  217. disdrodb/l0/readers/PARSIVEL2/SPAIN/GRANADA.py +1 -3
  218. disdrodb/l0/readers/PARSIVEL2/SPAIN/LIAISE.py +1 -1
  219. disdrodb/l0/readers/PARSIVEL2/SWEDEN/SMHI.py +1 -1
  220. disdrodb/l0/readers/PARSIVEL2/USA/CSU.py +138 -0
  221. disdrodb/l0/readers/PARSIVEL2/USA/CW3E.py +49 -22
  222. disdrodb/l0/readers/PWS100/AUSTRIA/HOAL.py +1 -3
  223. disdrodb/l0/readers/PWS100/FRANCE/ENPC_PWS100.py +1 -3
  224. disdrodb/l0/readers/PWS100/FRANCE/ENPC_PWS100_SIRTA.py +1 -1
  225. disdrodb/l0/readers/{PARSIVEL/NASA/IFLOODS.py → RD80/BRAZIL/ATTO_RD80.py} +50 -36
  226. disdrodb/l0/readers/RD80/BRAZIL/CHUVA_RD80.py +1 -3
  227. disdrodb/l0/readers/RD80/BRAZIL/GOAMAZON_RD80.py +1 -3
  228. disdrodb/l0/readers/RD80/NCAR/CINDY_2011_RD80.py +1 -3
  229. disdrodb/l0/readers/RD80/NCAR/RELAMPAGO_RD80.py +1 -3
  230. disdrodb/l0/readers/RD80/NOAA/PSL_RD80.py +1 -3
  231. disdrodb/l0/readers/{SW250 → SWS250}/BELGIUM/KMI.py +2 -4
  232. disdrodb/l0/readers/template_reader_raw_netcdf_data.py +1 -3
  233. disdrodb/l0/readers/template_reader_raw_text_data.py +1 -3
  234. disdrodb/l0/standards.py +4 -5
  235. disdrodb/l0/template_tools.py +1 -3
  236. disdrodb/l1/__init__.py +1 -1
  237. disdrodb/l1/classification.py +913 -0
  238. disdrodb/l1/processing.py +36 -106
  239. disdrodb/l1/resampling.py +8 -3
  240. disdrodb/l1_env/__init__.py +1 -1
  241. disdrodb/l1_env/routines.py +6 -6
  242. disdrodb/l2/__init__.py +1 -1
  243. disdrodb/l2/empirical_dsd.py +61 -31
  244. disdrodb/l2/processing.py +327 -62
  245. disdrodb/metadata/checks.py +1 -3
  246. disdrodb/metadata/download.py +4 -4
  247. disdrodb/metadata/geolocation.py +1 -3
  248. disdrodb/metadata/info.py +1 -3
  249. disdrodb/metadata/manipulation.py +1 -3
  250. disdrodb/metadata/reader.py +1 -3
  251. disdrodb/metadata/search.py +1 -3
  252. disdrodb/metadata/standards.py +1 -3
  253. disdrodb/metadata/writer.py +1 -3
  254. disdrodb/physics/__init__.py +17 -0
  255. disdrodb/physics/atmosphere.py +272 -0
  256. disdrodb/physics/water.py +130 -0
  257. disdrodb/physics/wrappers.py +62 -0
  258. disdrodb/psd/__init__.py +1 -1
  259. disdrodb/psd/fitting.py +22 -9
  260. disdrodb/psd/models.py +1 -1
  261. disdrodb/routines/__init__.py +5 -1
  262. disdrodb/routines/l0.py +28 -18
  263. disdrodb/routines/l1.py +8 -6
  264. disdrodb/routines/l2.py +8 -4
  265. disdrodb/routines/options.py +116 -71
  266. disdrodb/routines/options_validation.py +728 -0
  267. disdrodb/routines/wrappers.py +431 -11
  268. disdrodb/scattering/__init__.py +1 -1
  269. disdrodb/scattering/axis_ratio.py +9 -6
  270. disdrodb/scattering/permittivity.py +8 -8
  271. disdrodb/scattering/routines.py +32 -14
  272. disdrodb/summary/__init__.py +1 -1
  273. disdrodb/summary/routines.py +146 -86
  274. disdrodb/utils/__init__.py +1 -1
  275. disdrodb/utils/archiving.py +16 -9
  276. disdrodb/utils/attrs.py +4 -3
  277. disdrodb/utils/cli.py +8 -10
  278. disdrodb/utils/compression.py +13 -13
  279. disdrodb/utils/dask.py +33 -14
  280. disdrodb/utils/dataframe.py +1 -3
  281. disdrodb/utils/decorators.py +1 -3
  282. disdrodb/utils/dict.py +1 -1
  283. disdrodb/utils/directories.py +3 -5
  284. disdrodb/utils/encoding.py +2 -4
  285. disdrodb/utils/event.py +1 -1
  286. disdrodb/utils/list.py +1 -3
  287. disdrodb/utils/logger.py +1 -3
  288. disdrodb/utils/manipulations.py +182 -6
  289. disdrodb/utils/pydantic.py +80 -0
  290. disdrodb/utils/routines.py +1 -3
  291. disdrodb/utils/subsetting.py +1 -1
  292. disdrodb/utils/time.py +3 -2
  293. disdrodb/utils/warnings.py +1 -3
  294. disdrodb/utils/writer.py +1 -3
  295. disdrodb/utils/xarray.py +30 -3
  296. disdrodb/utils/yaml.py +1 -3
  297. disdrodb/viz/__init__.py +1 -1
  298. disdrodb/viz/plots.py +197 -21
  299. {disdrodb-0.2.0.dist-info → disdrodb-0.3.0.dist-info}/METADATA +2 -2
  300. disdrodb-0.3.0.dist-info/RECORD +358 -0
  301. {disdrodb-0.2.0.dist-info → disdrodb-0.3.0.dist-info}/entry_points.txt +3 -0
  302. disdrodb/etc/products/L1/1MIN.yaml +0 -13
  303. disdrodb/etc/products/L1/LPM/1MIN.yaml +0 -13
  304. disdrodb/etc/products/L1/PARSIVEL/1MIN.yaml +0 -13
  305. disdrodb/etc/products/L1/PARSIVEL2/1MIN.yaml +0 -13
  306. disdrodb/etc/products/L1/PWS100/1MIN.yaml +0 -13
  307. disdrodb/etc/products/L1/RD80/1MIN.yaml +0 -13
  308. disdrodb/etc/products/L1/SWS250/1MIN.yaml +0 -13
  309. disdrodb/etc/products/L2M/10MIN.yaml +0 -12
  310. disdrodb/l1/beard_model.py +0 -618
  311. disdrodb/l1/filters.py +0 -203
  312. disdrodb-0.2.0.dist-info/RECORD +0 -312
  313. {disdrodb-0.2.0.dist-info → disdrodb-0.3.0.dist-info}/WHEEL +0 -0
  314. {disdrodb-0.2.0.dist-info → disdrodb-0.3.0.dist-info}/licenses/LICENSE +0 -0
  315. {disdrodb-0.2.0.dist-info → disdrodb-0.3.0.dist-info}/top_level.txt +0 -0
@@ -0,0 +1,279 @@
1
+ # -----------------------------------------------------------------------------.
2
+ # Copyright (c) 2021-2026 DISDRODB developers
3
+ #
4
+ # This program is free software: you can redistribute it and/or modify
5
+ # it under the terms of the GNU General Public License as published by
6
+ # the Free Software Foundation, either version 3 of the License, or
7
+ # (at your option) any later version.
8
+ #
9
+ # This program is distributed in the hope that it will be useful,
10
+ # but WITHOUT ANY WARRANTY; without even the implied warranty of
11
+ # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12
+ # GNU General Public License for more details.
13
+ #
14
+ # You should have received a copy of the GNU General Public License
15
+ # along with this program. If not, see <http://www.gnu.org/licenses/>.
16
+ # -----------------------------------------------------------------------------.
17
+ """DISDRODB reader for GID LPM sensors not reporting time (TC-MI2, TC-MI3, TC-ER e TC-FI)."""
18
+ import numpy as np
19
+ import pandas as pd
20
+
21
+ from disdrodb.l0.l0_reader import is_documented_by, reader_generic_docstring
22
+ from disdrodb.l0.l0a_processing import read_raw_text_file
23
+ from disdrodb.utils.logger import log_error, log_warning
24
+
25
+
26
+ def read_txt_file(file, filename, logger):
27
+ """Parse for LPM hourly file."""
28
+ #### - Define raw data headers
29
+ column_names = ["TO_PARSE"]
30
+
31
+ ##------------------------------------------------------------------------.
32
+ #### Define reader options
33
+ # - For more info: https://pandas.pydata.org/docs/reference/api/pandas.read_csv.html
34
+ reader_kwargs = {}
35
+
36
+ # - Define delimiter
37
+ reader_kwargs["delimiter"] = "\\n"
38
+
39
+ # - Avoid first column to become df index !!!
40
+ reader_kwargs["index_col"] = False
41
+
42
+ # Since column names are expected to be passed explicitly, header is set to None
43
+ reader_kwargs["header"] = None
44
+
45
+ # - Number of rows to be skipped at the beginning of the file
46
+ reader_kwargs["skiprows"] = None
47
+
48
+ # - Define behaviour when encountering bad lines
49
+ reader_kwargs["on_bad_lines"] = "skip"
50
+
51
+ # - Define reader engine
52
+ # - C engine is faster
53
+ # - Python engine is more feature-complete
54
+ reader_kwargs["engine"] = "python"
55
+
56
+ # - Define on-the-fly decompression of on-disk data
57
+ # - Available: gzip, bz2, zip
58
+ reader_kwargs["compression"] = "infer"
59
+
60
+ # - Strings to recognize as NA/NaN and replace with standard NA flags
61
+ # - Already included: '#N/A', '#N/A N/A', '#NA', '-1.#IND', '-1.#QNAN',
62
+ # '-NaN', '-nan', '1.#IND', '1.#QNAN', '<NA>', 'N/A',
63
+ # 'NA', 'NULL', 'NaN', 'n/a', 'nan', 'null'
64
+ reader_kwargs["na_values"] = ["na", "", "error"]
65
+
66
+ ##------------------------------------------------------------------------.
67
+ #### Read the data
68
+ df = read_raw_text_file(
69
+ filepath=file,
70
+ column_names=column_names,
71
+ reader_kwargs=reader_kwargs,
72
+ logger=logger,
73
+ )
74
+
75
+ ##------------------------------------------------------------------------.
76
+ #### Adapt the dataframe to adhere to DISDRODB L0 standards
77
+ # Count number of delimiters to identify valid rows
78
+ df = df[df["TO_PARSE"].str.count(";") == 520]
79
+
80
+ # Check there are still valid rows
81
+ if len(df) == 0:
82
+ raise ValueError(f"No valid rows in {filename}.")
83
+
84
+ # Split by ; delimiter (before raw drop number)
85
+ df = df["TO_PARSE"].str.split(";", expand=True, n=79)
86
+
87
+ # Assign column names
88
+ column_names = [
89
+ "start_identifier",
90
+ "device_address",
91
+ "sensor_serial_number",
92
+ "sensor_date",
93
+ "sensor_time",
94
+ "weather_code_synop_4677_5min",
95
+ "weather_code_synop_4680_5min",
96
+ "weather_code_metar_4678_5min",
97
+ "precipitation_rate_5min",
98
+ "weather_code_synop_4677",
99
+ "weather_code_synop_4680",
100
+ "weather_code_metar_4678",
101
+ "precipitation_rate",
102
+ "rainfall_rate",
103
+ "snowfall_rate",
104
+ "precipitation_accumulated",
105
+ "mor_visibility",
106
+ "reflectivity",
107
+ "quality_index",
108
+ "max_hail_diameter",
109
+ "laser_status",
110
+ "static_signal_status",
111
+ "laser_temperature_analog_status",
112
+ "laser_temperature_digital_status",
113
+ "laser_current_analog_status",
114
+ "laser_current_digital_status",
115
+ "sensor_voltage_supply_status",
116
+ "current_heating_pane_transmitter_head_status",
117
+ "current_heating_pane_receiver_head_status",
118
+ "temperature_sensor_status",
119
+ "current_heating_voltage_supply_status",
120
+ "current_heating_house_status",
121
+ "current_heating_heads_status",
122
+ "current_heating_carriers_status",
123
+ "control_output_laser_power_status",
124
+ "reserved_status",
125
+ "temperature_interior",
126
+ "laser_temperature",
127
+ "laser_current_average",
128
+ "control_voltage",
129
+ "optical_control_voltage_output",
130
+ "sensor_voltage_supply",
131
+ "current_heating_pane_transmitter_head",
132
+ "current_heating_pane_receiver_head",
133
+ "temperature_ambient",
134
+ "current_heating_voltage_supply",
135
+ "current_heating_house",
136
+ "current_heating_heads",
137
+ "current_heating_carriers",
138
+ "number_particles",
139
+ "number_particles_internal_data",
140
+ "number_particles_min_speed",
141
+ "number_particles_min_speed_internal_data",
142
+ "number_particles_max_speed",
143
+ "number_particles_max_speed_internal_data",
144
+ "number_particles_min_diameter",
145
+ "number_particles_min_diameter_internal_data",
146
+ "number_particles_no_hydrometeor",
147
+ "number_particles_no_hydrometeor_internal_data",
148
+ "number_particles_unknown_classification",
149
+ "number_particles_unknown_classification_internal_data",
150
+ "number_particles_class_1",
151
+ "number_particles_class_1_internal_data",
152
+ "number_particles_class_2",
153
+ "number_particles_class_2_internal_data",
154
+ "number_particles_class_3",
155
+ "number_particles_class_3_internal_data",
156
+ "number_particles_class_4",
157
+ "number_particles_class_4_internal_data",
158
+ "number_particles_class_5",
159
+ "number_particles_class_5_internal_data",
160
+ "number_particles_class_6",
161
+ "number_particles_class_6_internal_data",
162
+ "number_particles_class_7",
163
+ "number_particles_class_7_internal_data",
164
+ "number_particles_class_8",
165
+ "number_particles_class_8_internal_data",
166
+ "number_particles_class_9",
167
+ "number_particles_class_9_internal_data",
168
+ "raw_drop_number",
169
+ ]
170
+ df.columns = column_names
171
+
172
+ # Deal with case if there are 61 timesteps
173
+ # - Occurs sometimes when previous hourly file miss timesteps
174
+ if len(df) == 61:
175
+ log_warning(logger=logger, msg=f"{filename} contains 61 timesteps. Dropping the first.")
176
+ df = df.iloc[1:]
177
+
178
+ # Raise error if more than 60 timesteps/rows
179
+ n_rows = len(df)
180
+ if n_rows > 60:
181
+ raise ValueError(f"The hourly file contains {n_rows} timesteps.")
182
+
183
+ # Infer and define "time" column
184
+ start_time_str = filename.split(".")[0] # '2024020200.txt'
185
+ start_time = pd.to_datetime(start_time_str, format="%Y%m%d%H")
186
+
187
+ # - Define timedelta based on sensor_time
188
+ # --> Add +24h to subsequent times when time resets
189
+ dt = pd.to_timedelta(df["sensor_time"]).to_numpy().astype("m8[s]")
190
+ rollover_indices = np.where(np.diff(dt) < np.timedelta64(0, "s"))[0]
191
+ if rollover_indices.size > 0:
192
+ for idx in rollover_indices:
193
+ dt[idx + 1 :] += np.timedelta64(24, "h")
194
+ dt = dt - dt[0]
195
+
196
+ # - Define approximate time
197
+ df["time"] = start_time + dt
198
+
199
+ # - Keep rows where time increment is between 00 and 59 minutes
200
+ valid_rows = dt <= np.timedelta64(3540, "s")
201
+ df = df[valid_rows]
202
+
203
+ # Remove checksum from raw_drop_number
204
+ df["raw_drop_number"] = df["raw_drop_number"].str.strip(";").str.rsplit(";", n=1, expand=True)[0]
205
+
206
+ # Drop rows with invalid raw_drop_number
207
+ # --> 440 value # 22x20
208
+ # --> 400 here # 20x20
209
+ df = df[df["raw_drop_number"].astype(str).str.len() == 1759]
210
+
211
+ # Drop columns not agreeing with DISDRODB L0 standards
212
+ columns_to_drop = [
213
+ "start_identifier",
214
+ "device_address",
215
+ "sensor_serial_number",
216
+ "sensor_date",
217
+ "sensor_time",
218
+ ]
219
+ df = df.drop(columns=columns_to_drop)
220
+ return df
221
+
222
+
223
+ @is_documented_by(reader_generic_docstring)
224
+ def reader(
225
+ filepath,
226
+ logger=None,
227
+ ):
228
+ """Reader."""
229
+ import zipfile
230
+
231
+ ##------------------------------------------------------------------------.
232
+ # filename = os.path.basename(filepath)
233
+ # return read_txt_file(file=filepath, filename=filename, logger=logger)
234
+
235
+ # ---------------------------------------------------------------------.
236
+ #### Iterate over all files (aka timesteps) in the daily zip archive
237
+ # - Each file contain a single timestep !
238
+ # list_df = []
239
+ # with tempfile.TemporaryDirectory() as temp_dir:
240
+ # # Extract all files
241
+ # unzip_file_on_terminal(filepath, temp_dir)
242
+
243
+ # # Walk through extracted files
244
+ # for root, _, files in os.walk(temp_dir):
245
+ # for filename in sorted(files):
246
+ # if filename.endswith(".txt"):
247
+ # full_path = os.path.join(root, filename)
248
+ # try:
249
+ # df = read_txt_file(file=full_path, filename=filename, logger=logger)
250
+ # if df is not None:
251
+ # list_df.append(df)
252
+ # except Exception as e:
253
+ # msg = f"An error occurred while reading {filename}: {e}"
254
+ # log_error(logger=logger, msg=msg, verbose=True)
255
+
256
+ list_df = []
257
+ with zipfile.ZipFile(filepath, "r") as zip_ref:
258
+ filenames = sorted(zip_ref.namelist())
259
+ for filename in filenames:
260
+ if filename.endswith(".txt"):
261
+ # Open file
262
+ with zip_ref.open(filename) as file:
263
+ try:
264
+ df = read_txt_file(file=file, filename=filename, logger=logger)
265
+ if df is not None:
266
+ list_df.append(df)
267
+ except Exception as e:
268
+ msg = f"An error occurred while reading {filename}. The error is: {e}"
269
+ log_error(logger=logger, msg=msg, verbose=True)
270
+
271
+ # Check the zip file contains at least some non.empty files
272
+ if len(list_df) == 0:
273
+ raise ValueError(f"{filepath} contains only empty files!")
274
+
275
+ # Concatenate all dataframes into a single one
276
+ df = pd.concat(list_df)
277
+
278
+ # ---------------------------------------------------------------------.
279
+ return df
@@ -1,7 +1,5 @@
1
- #!/usr/bin/env python3
2
-
3
1
  # -----------------------------------------------------------------------------.
4
- # Copyright (c) 2021-2023 DISDRODB developers
2
+ # Copyright (c) 2021-2026 DISDRODB developers
5
3
  #
6
4
  # This program is free software: you can redistribute it and/or modify
7
5
  # it under the terms of the GNU General Public License as published by
@@ -86,7 +84,7 @@ def reader(
86
84
  df = df["TO_BE_SPLITTED"].str.split(";", expand=True, n=79)
87
85
 
88
86
  # Assign column names
89
- column_names = [
87
+ names = [
90
88
  "start_identifier",
91
89
  "device_address",
92
90
  "sensor_serial_number",
@@ -168,7 +166,7 @@ def reader(
168
166
  "number_particles_class_9_internal_data",
169
167
  "TO_BE_FURTHER_PROCESSED",
170
168
  ]
171
- df.columns = column_names
169
+ df.columns = names
172
170
 
173
171
  # Extract the last variables remained in raw_drop_number
174
172
  df_parsed = df["TO_BE_FURTHER_PROCESSED"].str.rsplit(";", n=5, expand=True)
@@ -1,7 +1,5 @@
1
- #!/usr/bin/env python3
2
-
3
1
  # -----------------------------------------------------------------------------.
4
- # Copyright (c) 2021-2023 DISDRODB developers
2
+ # Copyright (c) 2021-2026 DISDRODB developers
5
3
  #
6
4
  # This program is free software: you can redistribute it and/or modify
7
5
  # it under the terms of the GNU General Public License as published by
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env python3
2
2
  # -----------------------------------------------------------------------------.
3
- # Copyright (c) 2021-2023 DISDRODB developers
3
+ # Copyright (c) 2021-2026 DISDRODB developers
4
4
  #
5
5
  # This program is free software: you can redistribute it and/or modify
6
6
  # it under the terms of the GNU General Public License as published by
@@ -0,0 +1,103 @@
1
+ # -----------------------------------------------------------------------------.
2
+ # Copyright (c) 2021-2026 DISDRODB developers
3
+ #
4
+ # This program is free software: you can redistribute it and/or modify
5
+ # it under the terms of the GNU General Public License as published by
6
+ # the Free Software Foundation, either version 3 of the License, or
7
+ # (at your option) any later version.
8
+ #
9
+ # This program is distributed in the hope that it will be useful,
10
+ # but WITHOUT ANY WARRANTY; without even the implied warranty of
11
+ # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12
+ # GNU General Public License for more details.
13
+ #
14
+ # You should have received a copy of the GNU General Public License
15
+ # along with this program. If not, see <http://www.gnu.org/licenses/>.
16
+ # -----------------------------------------------------------------------------.
17
+ """Reader for RWANDA DELFT Thies LPM sensor in netCDF format."""
18
+
19
+ from disdrodb.l0.l0_reader import is_documented_by, reader_generic_docstring
20
+ from disdrodb.l0.l0b_nc_processing import open_raw_netcdf_file, standardize_raw_dataset
21
+
22
+
23
+ @is_documented_by(reader_generic_docstring)
24
+ def reader(
25
+ filepath,
26
+ logger=None,
27
+ ):
28
+ """Reader."""
29
+ ##------------------------------------------------------------------------.
30
+ #### Open the netCDF
31
+ ds = open_raw_netcdf_file(filepath=filepath, logger=logger)
32
+
33
+ ##------------------------------------------------------------------------.
34
+ #### Adapt the dataframe to adhere to DISDRODB L0 standards
35
+ # Add time coordinate
36
+ ds["time"] = ds["time"].astype("M8[s]")
37
+ ds["time"].attrs.pop("comment", None)
38
+ ds["time"].attrs.pop("units", None)
39
+ ds = ds.set_coords("time")
40
+
41
+ # Define dictionary mapping dataset variables to select and rename
42
+ dict_names = {
43
+ ### Dimensions
44
+ "diameter_classes": "diameter_bin_center",
45
+ "velocity_classes": "velocity_bin_center",
46
+ ### Variables
47
+ "weather_code_synop_4680": "weather_code_synop_4680",
48
+ "weather_code_synop_4677": "weather_code_synop_4677",
49
+ "weather_code_metar_4678": "weather_code_metar_4678",
50
+ "liquid_precip_intensity": "rainfall_rate",
51
+ "solid_precip_intensity": "snowfall_rate",
52
+ "all_precip_intensity": "precipitation_rate",
53
+ "reflectivity": "reflectivity",
54
+ "visibility": "mor_visibility",
55
+ "measurement_quality": "quality_index",
56
+ "maximum_diameter_hail": "max_hail_diameter",
57
+ "status_laser": "laser_status",
58
+ "status_output_laser_power": "control_output_laser_power_status",
59
+ "interior_temperature": "temperature_interior",
60
+ "temperature_of_laser_driver": "laser_temperature",
61
+ "mean_value_laser_current": "laser_current_average",
62
+ "control_voltage": "control_voltage",
63
+ "optical_control_output": "optical_control_voltage_output",
64
+ "voltage_sensor_supply": "sensor_voltage_supply",
65
+ "current_heating_laser_head": "current_heating_pane_transmitter_head",
66
+ "current_heating_receiver_head": "current_heating_pane_receiver_head",
67
+ "ambient_temperature": "temperature_ambient",
68
+ "voltage_heating_supply": "current_heating_voltage_supply",
69
+ "current_heating_housing": "current_heating_house",
70
+ "current_heating_heads": "current_heating_heads",
71
+ "current_heating_carriers": "current_heating_carriers",
72
+ "number_of_all_measured_particles": "number_particles",
73
+ "number_of_particles_slower_than_0.15": "number_particles_min_speed",
74
+ "number_of_particles_faster_than_20": "number_particles_max_speed",
75
+ "number_of_particles_smaller_than_0.15": "number_particles_min_diameter",
76
+ "number_of_particles_with_unknown_classification": "number_particles_unknown_classification",
77
+ "total_volume_gross_particles_unknown_classification": "number_particles_unknown_classification_internal_data",
78
+ "number_of_particles_class_1": "number_particles_class_1",
79
+ "total_volume_gross_of_class_1": "number_particles_class_1_internal_data",
80
+ "number_of_particles_class_2": "number_particles_class_2",
81
+ "total_volume_gross_of_class_2": "number_particles_class_2_internal_data",
82
+ "number_of_particles_class_3": "number_particles_class_3",
83
+ "total_volume_gross_of_class_3": "number_particles_class_3_internal_data",
84
+ "number_of_particles_class_4": "number_particles_class_4",
85
+ "total_volume_gross_of_class_4": "number_particles_class_4_internal_data",
86
+ "number_of_particles_class_5": "number_particles_class_5",
87
+ "total_volume_gross_of_class_5": "number_particles_class_5_internal_data",
88
+ "number_of_particles_class_6": "number_particles_class_6",
89
+ "total_volume_gross_of_class_6": "number_particles_class_6_internal_data",
90
+ "number_of_particles_class_7": "number_particles_class_7",
91
+ "total_volume_gross_of_class_7": "number_particles_class_7_internal_data",
92
+ "number_of_particles_class_8": "number_particles_class_8",
93
+ "total_volume_gross_of_class_8": "number_particles_class_8_internal_data",
94
+ "number_of_particles_class_9": "number_particles_class_9",
95
+ "total_volume_gross_of_class_9": "number_particles_class_9_internal_data",
96
+ "raw_data": "raw_drop_number",
97
+ }
98
+
99
+ # Rename dataset variables and columns and infill missing variables
100
+ ds = standardize_raw_dataset(ds=ds, dict_names=dict_names, sensor_name="LPM")
101
+
102
+ # Return the dataset adhering to DISDRODB L0B standards
103
+ return ds
@@ -0,0 +1,214 @@
1
+ # -----------------------------------------------------------------------------.
2
+ # Copyright (c) 2021-2026 DISDRODB developers
3
+ #
4
+ # This program is free software: you can redistribute it and/or modify
5
+ # it under the terms of the GNU General Public License as published by
6
+ # the Free Software Foundation, either version 3 of the License, or
7
+ # (at your option) any later version.
8
+ #
9
+ # This program is distributed in the hope that it will be useful,
10
+ # but WITHOUT ANY WARRANTY; without even the implied warranty of
11
+ # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12
+ # GNU General Public License for more details.
13
+ #
14
+ # You should have received a copy of the GNU General Public License
15
+ # along with this program. If not, see <http://www.gnu.org/licenses/>.
16
+ # -----------------------------------------------------------------------------.
17
+ """DISDRODB reader for Haukeliseter Test Site LPM sensors."""
18
+ import numpy as np
19
+ import pandas as pd
20
+
21
+ from disdrodb.l0.l0_reader import is_documented_by, reader_generic_docstring
22
+ from disdrodb.l0.l0a_processing import read_raw_text_file
23
+
24
+
25
+ @is_documented_by(reader_generic_docstring)
26
+ def reader(
27
+ filepath,
28
+ logger=None,
29
+ ):
30
+ """Reader."""
31
+ ##------------------------------------------------------------------------.
32
+ #### - Define raw data headers
33
+ column_names = ["TO_PARSE"]
34
+
35
+ ##------------------------------------------------------------------------.
36
+ #### Define reader options
37
+ # - For more info: https://pandas.pydata.org/docs/reference/api/pandas.read_csv.html
38
+ reader_kwargs = {}
39
+
40
+ # - Define delimiter
41
+ reader_kwargs["delimiter"] = "\\n"
42
+
43
+ # - Avoid first column to become df index !!!
44
+ reader_kwargs["index_col"] = False
45
+
46
+ # - Define encoding
47
+ reader_kwargs["encoding"] = "ISO-8859-1"
48
+
49
+ # - Since column names are expected to be passed explicitly, header is set to None
50
+ reader_kwargs["header"] = None
51
+
52
+ # - Number of rows to be skipped at the beginning of the file
53
+ reader_kwargs["skiprows"] = None
54
+
55
+ # - Define behaviour when encountering bad lines
56
+ reader_kwargs["on_bad_lines"] = "skip"
57
+
58
+ # - Define reader engine
59
+ # - C engine is faster
60
+ # - Python engine is more feature-complete
61
+ reader_kwargs["engine"] = "python"
62
+
63
+ # - Define on-the-fly decompression of on-disk data
64
+ # - Available: gzip, bz2, zip
65
+ reader_kwargs["compression"] = "infer"
66
+
67
+ # - Strings to recognize as NA/NaN and replace with standard NA flags
68
+ # - Already included: '#N/A', '#N/A N/A', '#NA', '-1.#IND', '-1.#QNAN',
69
+ # '-NaN', '-nan', '1.#IND', '1.#QNAN', '<NA>', 'N/A',
70
+ # 'NA', 'NULL', 'NaN', 'n/a', 'nan', 'null'
71
+ reader_kwargs["na_values"] = ["na", "", "error"]
72
+
73
+ ##------------------------------------------------------------------------.
74
+ #### Read the data
75
+ df = read_raw_text_file(
76
+ filepath=filepath,
77
+ column_names=column_names,
78
+ reader_kwargs=reader_kwargs,
79
+ logger=logger,
80
+ )
81
+
82
+ ##------------------------------------------------------------------------.
83
+ #### Adapt the dataframe to adhere to DISDRODB L0 standards
84
+ # Raise error if empty file
85
+ if len(df) == 0:
86
+ raise ValueError(f"{filepath} is empty.")
87
+
88
+ # Select only rows with expected number of delimiters
89
+ df = df[df["TO_PARSE"].str.count(";").isin([520, 521])]
90
+
91
+ # Raise error if no data left
92
+ if len(df) == 0:
93
+ raise ValueError(f"No valid data in {filepath}.")
94
+
95
+ # Retrieve most frequent number of delimiters
96
+ possible_delimiters, counts = np.unique(df["TO_PARSE"].str.count(";"), return_counts=True)
97
+ n_delimiters = possible_delimiters[np.argmax(counts)]
98
+
99
+ if n_delimiters == 520:
100
+ n = 79
101
+ columns_to_drop = ["device_address", "sensor_serial_number"]
102
+ else: # n_delimiters == 521
103
+ n = 80
104
+ columns_to_drop = ["start_identifier", "device_address", "sensor_serial_number"]
105
+
106
+ # Split by ; delimiter (before raw drop number)
107
+ df = df["TO_PARSE"].str.split(";", expand=True, n=n)
108
+
109
+ # Assign column names
110
+ names = [
111
+ "time",
112
+ *columns_to_drop,
113
+ "sensor_date",
114
+ "sensor_time",
115
+ "weather_code_synop_4677_5min",
116
+ "weather_code_synop_4680_5min",
117
+ "weather_code_metar_4678_5min",
118
+ "precipitation_rate_5min",
119
+ "weather_code_synop_4677",
120
+ "weather_code_synop_4680",
121
+ "weather_code_metar_4678",
122
+ "precipitation_rate",
123
+ "rainfall_rate",
124
+ "snowfall_rate",
125
+ "precipitation_accumulated",
126
+ "mor_visibility",
127
+ "reflectivity",
128
+ "quality_index",
129
+ "max_hail_diameter",
130
+ "laser_status",
131
+ "static_signal_status",
132
+ "laser_temperature_analog_status",
133
+ "laser_temperature_digital_status",
134
+ "laser_current_analog_status",
135
+ "laser_current_digital_status",
136
+ "sensor_voltage_supply_status",
137
+ "current_heating_pane_transmitter_head_status",
138
+ "current_heating_pane_receiver_head_status",
139
+ "temperature_sensor_status",
140
+ "current_heating_voltage_supply_status",
141
+ "current_heating_house_status",
142
+ "current_heating_heads_status",
143
+ "current_heating_carriers_status",
144
+ "control_output_laser_power_status",
145
+ "reserved_status",
146
+ "temperature_interior",
147
+ "laser_temperature",
148
+ "laser_current_average",
149
+ "control_voltage",
150
+ "optical_control_voltage_output",
151
+ "sensor_voltage_supply",
152
+ "current_heating_pane_transmitter_head",
153
+ "current_heating_pane_receiver_head",
154
+ "temperature_ambient",
155
+ "current_heating_voltage_supply",
156
+ "current_heating_house",
157
+ "current_heating_heads",
158
+ "current_heating_carriers",
159
+ "number_particles",
160
+ "number_particles_internal_data",
161
+ "number_particles_min_speed",
162
+ "number_particles_min_speed_internal_data",
163
+ "number_particles_max_speed",
164
+ "number_particles_max_speed_internal_data",
165
+ "number_particles_min_diameter",
166
+ "number_particles_min_diameter_internal_data",
167
+ "number_particles_no_hydrometeor",
168
+ "number_particles_no_hydrometeor_internal_data",
169
+ "number_particles_unknown_classification",
170
+ "number_particles_unknown_classification_internal_data",
171
+ "number_particles_class_1",
172
+ "number_particles_class_1_internal_data",
173
+ "number_particles_class_2",
174
+ "number_particles_class_2_internal_data",
175
+ "number_particles_class_3",
176
+ "number_particles_class_3_internal_data",
177
+ "number_particles_class_4",
178
+ "number_particles_class_4_internal_data",
179
+ "number_particles_class_5",
180
+ "number_particles_class_5_internal_data",
181
+ "number_particles_class_6",
182
+ "number_particles_class_6_internal_data",
183
+ "number_particles_class_7",
184
+ "number_particles_class_7_internal_data",
185
+ "number_particles_class_8",
186
+ "number_particles_class_8_internal_data",
187
+ "number_particles_class_9",
188
+ "number_particles_class_9_internal_data",
189
+ "raw_drop_number",
190
+ ]
191
+ df.columns = names
192
+
193
+ # Remove checksum from raw_drop_number
194
+ df["raw_drop_number"] = df["raw_drop_number"].str.rsplit(";", n=2, expand=True)[0]
195
+
196
+ # Define datetime "time" column
197
+ if n_delimiters == 520:
198
+ time_str = df["time"].str.extract(r"(\d{8}_\d{6})")[0]
199
+ df["time"] = pd.to_datetime(time_str, format="%Y%m%d_%H%M%S", errors="coerce")
200
+ else:
201
+ time_str = df["time"].str.extract(r"(\d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2})")[0]
202
+ df["time"] = pd.to_datetime(time_str, format="%Y-%m-%d %H:%M:%S", errors="coerce")
203
+
204
+ # Drop rows with invalid raw_drop_number
205
+ df = df[df["raw_drop_number"].astype(str).str.len() == 1759]
206
+
207
+ # Drop columns not agreeing with DISDRODB L0 standards
208
+ variables_to_drop = [
209
+ *columns_to_drop,
210
+ "sensor_date",
211
+ "sensor_time",
212
+ ]
213
+ df = df.drop(columns=variables_to_drop)
214
+ return df