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,155 @@
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 Colorado State University PRECIP OTT Parsivel 2 raw data."""
18
+
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 column names
33
+ column_names = ["TO_PARSE"]
34
+
35
+ ##------------------------------------------------------------------------.
36
+ #### Define reader options
37
+ reader_kwargs = {}
38
+
39
+ # - Define delimiter
40
+ reader_kwargs["delimiter"] = "\\n"
41
+
42
+ # - Skip first row as columns names
43
+ reader_kwargs["header"] = None
44
+
45
+ # - Skip header
46
+ reader_kwargs["skiprows"] = 0
47
+
48
+ # - Define encoding
49
+ reader_kwargs["encoding"] = "ISO-8859-1"
50
+
51
+ # - Avoid first column to become df index !!!
52
+ reader_kwargs["index_col"] = False
53
+
54
+ # - Define behaviour when encountering bad lines
55
+ reader_kwargs["on_bad_lines"] = "skip"
56
+
57
+ # - Define reader engine
58
+ # - C engine is faster
59
+ # - Python engine is more feature-complete
60
+ reader_kwargs["engine"] = "python"
61
+
62
+ # - Define on-the-fly decompression of on-disk data
63
+ # - Available: gzip, bz2, zip
64
+ # reader_kwargs['compression'] = 'xz'
65
+
66
+ # - Strings to recognize as NA/NaN and replace with standard NA flags
67
+ # - Already included: '#N/A', '#N/A N/A', '#NA', '-1.#IND', '-1.#QNAN',
68
+ # '-NaN', '-nan', '1.#IND', '1.#QNAN', '<NA>', 'N/A',
69
+ # 'NA', 'NULL', 'NaN', 'n/a', 'nan', 'null'
70
+ reader_kwargs["na_values"] = ["na", "error", "-.-", " NA"]
71
+
72
+ ##------------------------------------------------------------------------.
73
+ #### Read the data
74
+ df = read_raw_text_file(
75
+ filepath=filepath,
76
+ column_names=column_names,
77
+ reader_kwargs=reader_kwargs,
78
+ logger=logger,
79
+ )
80
+
81
+ ##------------------------------------------------------------------------.
82
+ #### Adapt the dataframe to adhere to DISDRODB L0 standards
83
+ # Raise error if empty file
84
+ if len(df) == 0:
85
+ raise ValueError(f"{filepath} is empty.")
86
+
87
+ # Select only rows with expected number of delimiters
88
+ df = df[df["TO_PARSE"].str.count(",") == 1041]
89
+
90
+ # Raise error if no data left
91
+ if len(df) == 0:
92
+ raise ValueError(f"No valid data in {filepath}.")
93
+
94
+ # Split into columns
95
+ df = df["TO_PARSE"].str.split(",", expand=True, n=17)
96
+
97
+ # Assign columns names
98
+ names = [
99
+ "date",
100
+ "time",
101
+ "rainfall_rate_32bit",
102
+ "rainfall_accumulated_32bit",
103
+ "weather_code_synop_4680",
104
+ "weather_code_metar_4678",
105
+ "weather_code_nws",
106
+ "reflectivity_32bit",
107
+ "mor_visibility",
108
+ "laser_amplitude",
109
+ "number_particles",
110
+ "sensor_temperature",
111
+ "sensor_heating_current",
112
+ "sensor_battery_voltage",
113
+ "sensor_status",
114
+ "rain_kinetic_energy",
115
+ "snowfall_rate",
116
+ "raw_drop_number",
117
+ ]
118
+ df.columns = names
119
+
120
+ # Add datetime time column
121
+ time_str = df["date"] + "-" + df["time"]
122
+ df["time"] = pd.to_datetime(time_str, format="%d.%m.%Y-%H:%M:%S", errors="coerce")
123
+
124
+ # Derive the raw spectrum
125
+ # Remove <SPECTRUM> and </SPECTRUM> prefix and suffix from the raw_drop_number field
126
+ df["raw_drop_number"] = df["raw_drop_number"].astype("string")
127
+ df["raw_drop_number"] = df["raw_drop_number"].str.replace("<SPECTRUM>", "")
128
+ df["raw_drop_number"] = df["raw_drop_number"].str.replace("</SPECTRUM>", "")
129
+
130
+ # Preprocess the raw spectrum and raw_drop_average_velocity
131
+ # - Add 0 before every ; if ; not preceded by a digit
132
+ # - Example: ';;1;;' --> '0;0;1;0;'
133
+ df["raw_drop_number"] = df["raw_drop_number"].str.replace(r"(?<!\d),", "0,", regex=True)
134
+
135
+ # Infill missing timesteps with raw_drop_number = 0 spectrum
136
+ # - Define the full time range with 30-second frequency
137
+ full_time_index = pd.date_range(start=df["time"].iloc[0], end=df["time"].iloc[-1], freq="30s")
138
+
139
+ # - Reindex the DataFrame to include all 30-second timesteps
140
+ df = df.set_index("time").reindex(full_time_index)
141
+
142
+ # - Fill missing raw_drop_number with 0
143
+ df["raw_drop_number"] = df["raw_drop_number"].fillna(0)
144
+
145
+ # - Restore 'time' as a column
146
+ df = df.rename_axis("time").reset_index()
147
+
148
+ # Drop columns not agreeing with DISDRODB L0 standards
149
+ columns_to_drop = [
150
+ "date",
151
+ ]
152
+ df = df.drop(columns=columns_to_drop)
153
+
154
+ # Return the dataframe adhering to DISDRODB L0 standards
155
+ return df
@@ -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
@@ -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,161 @@
1
+ #!/usr/bin/env python3
2
+ # -----------------------------------------------------------------------------.
3
+ # Copyright (c) 2021-2026 DISDRODB developers
4
+ #
5
+ # This program is free software: you can redistribute it and/or modify
6
+ # it under the terms of the GNU General Public License as published by
7
+ # the Free Software Foundation, either version 3 of the License, or
8
+ # (at your option) any later version.
9
+ #
10
+ # This program is distributed in the hope that it will be useful,
11
+ # but WITHOUT ANY WARRANTY; without even the implied warranty of
12
+ # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13
+ # GNU General Public License for more details.
14
+ #
15
+ # You should have received a copy of the GNU General Public License
16
+ # along with this program. If not, see <http://www.gnu.org/licenses/>.
17
+ # -----------------------------------------------------------------------------.
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 column names
33
+ column_names = ["TO_PARSE"]
34
+
35
+ ##------------------------------------------------------------------------.
36
+ #### Define reader options
37
+ reader_kwargs = {}
38
+
39
+ # - Define delimiter
40
+ reader_kwargs["delimiter"] = "\\n"
41
+
42
+ # - Define encoding
43
+ reader_kwargs["encoding"] = "ISO-8859-1"
44
+
45
+ # - Skip first row as columns names
46
+ reader_kwargs["header"] = None
47
+
48
+ # - Avoid first column to become df index !!!
49
+ reader_kwargs["index_col"] = False
50
+
51
+ # - Define behaviour when encountering bad lines
52
+ reader_kwargs["on_bad_lines"] = "skip"
53
+
54
+ # - Define reader engine
55
+ # - C engine is faster
56
+ # - Python engine is more feature-complete
57
+ reader_kwargs["engine"] = "python"
58
+
59
+ # - Define on-the-fly decompression of on-disk data
60
+ # - Available: gzip, bz2, zip
61
+ reader_kwargs["compression"] = "infer"
62
+
63
+ # - Strings to recognize as NA/NaN and replace with standard NA flags
64
+ # - Already included: '#N/A', '#N/A N/A', '#NA', '-1.#IND', '-1.#QNAN',
65
+ # '-NaN', '-nan', '1.#IND', '1.#QNAN', '<NA>', 'N/A',
66
+ # 'NA', 'NULL', 'NaN', 'n/a', 'nan', 'null'
67
+ reader_kwargs["na_values"] = ["na", "", "error"]
68
+
69
+ ##------------------------------------------------------------------------.
70
+ #### Read the data
71
+ df = read_raw_text_file(
72
+ filepath=filepath,
73
+ column_names=column_names,
74
+ reader_kwargs=reader_kwargs,
75
+ logger=logger,
76
+ )
77
+
78
+ ##------------------------------------------------------------------------.
79
+ #### Adapt the dataframe to adhere to DISDRODB L0 standards
80
+ # Create ID and Value columns
81
+ df = df["TO_PARSE"].str.split(":", expand=True, n=1)
82
+ df.columns = ["ID", "Value"]
83
+
84
+ # Select only rows with values
85
+ df = df[df["Value"].astype(bool)]
86
+ df = df[df["Value"].apply(lambda x: x is not None)]
87
+
88
+ # Drop rows with invalid IDs
89
+ # - Corrupted rows
90
+ valid_id_str = np.char.rjust(np.arange(0, 94).astype(str), width=2, fillchar="0")
91
+ df = df[df["ID"].astype(str).isin(valid_id_str)]
92
+
93
+ # Create the dataframe where each row corresponds to a timestep
94
+ df["_group"] = (df["ID"].astype(int).diff() <= 0).cumsum()
95
+ df = df.pivot(index="_group", columns="ID") # noqa
96
+ df.columns = df.columns.get_level_values("ID")
97
+ df = df.reset_index(drop=True)
98
+
99
+ # Assign column names
100
+ column_dict = {
101
+ "01": "rainfall_rate_32bit",
102
+ "02": "rainfall_accumulated_32bit",
103
+ "03": "weather_code_synop_4680",
104
+ "04": "weather_code_synop_4677",
105
+ "05": "weather_code_metar_4678",
106
+ "06": "weather_code_nws",
107
+ "07": "reflectivity_32bit",
108
+ "08": "mor_visibility",
109
+ "09": "sample_interval",
110
+ "10": "laser_amplitude",
111
+ "11": "number_particles",
112
+ "12": "sensor_temperature",
113
+ # "13": "sensor_serial_number",
114
+ # "14": "firmware_iop",
115
+ # "15": "firmware_dsp",
116
+ "16": "sensor_heating_current",
117
+ "17": "sensor_battery_voltage",
118
+ "18": "sensor_status",
119
+ # "19": "start_time",
120
+ "20": "sensor_time",
121
+ "21": "sensor_date",
122
+ # "22": "station_name",
123
+ # "23": "station_number",
124
+ "34": "rain_kinetic_energy",
125
+ "35": "snowfall_rate",
126
+ "90": "raw_drop_concentration",
127
+ "91": "raw_drop_average_velocity",
128
+ "93": "raw_drop_number",
129
+ }
130
+
131
+ # Identify missing columns and add NaN
132
+ expected_columns = np.array(list(column_dict.keys()))
133
+ missing_columns = expected_columns[np.isin(expected_columns, df.columns, invert=True)].tolist()
134
+ if len(missing_columns) > 0:
135
+ for column in missing_columns:
136
+ df[column] = "NaN"
137
+
138
+ # Rename columns
139
+ df = df.rename(column_dict, axis=1)
140
+
141
+ # Keep only columns defined in the dictionary
142
+ df = df[list(column_dict.values())]
143
+
144
+ # Define datetime "time" column
145
+ df["time"] = df["sensor_date"] + "-" + df["sensor_time"]
146
+ df["time"] = pd.to_datetime(df["time"], format="%d.%m.%Y-%H:%M:%S", errors="coerce")
147
+
148
+ # Drop columns not agreeing with DISDRODB L0 standards
149
+ columns_to_drop = [
150
+ "sensor_date",
151
+ "sensor_time",
152
+ # "firmware_iop",
153
+ # "firmware_dsp",
154
+ # "sensor_serial_number",
155
+ # "station_name",
156
+ # "station_number",
157
+ ]
158
+ df = df.drop(columns=columns_to_drop)
159
+
160
+ # Return the dataframe adhering to DISDRODB L0 standards
161
+ return df
@@ -1,6 +1,5 @@
1
- #!/usr/bin/env python3
2
1
  # -----------------------------------------------------------------------------.
3
- # Copyright (c) 2021-2023 DISDRODB developers
2
+ # Copyright (c) 2021-2026 DISDRODB developers
4
3
  #
5
4
  # This program is free software: you can redistribute it and/or modify
6
5
  # it under the terms of the GNU General Public License as published by
@@ -15,7 +14,8 @@
15
14
  # You should have received a copy of the GNU General Public License
16
15
  # along with this program. If not, see <http://www.gnu.org/licenses/>.
17
16
  # -----------------------------------------------------------------------------.
18
- """This reader allows to read raw data from NASA GCPEX, OLYMPEX and IPHEX campaigns."""
17
+ """DISDRODB reader for University of Bergen OTT Parsivel 2 raw data."""
18
+
19
19
  import pandas as pd
20
20
 
21
21
  from disdrodb.l0.l0_reader import is_documented_by, reader_generic_docstring
@@ -30,34 +30,44 @@ def reader(
30
30
  """Reader."""
31
31
  ##------------------------------------------------------------------------.
32
32
  #### Define column names
33
- column_names = ["time", "TO_BE_SPLITTED"]
33
+ column_names = ["TO_PARSE"]
34
34
 
35
35
  ##------------------------------------------------------------------------.
36
36
  #### Define reader options
37
37
  reader_kwargs = {}
38
+
38
39
  # - Define delimiter
39
- reader_kwargs["delimiter"] = ";"
40
+ reader_kwargs["delimiter"] = "\\n"
41
+
40
42
  # - Skip first row as columns names
41
43
  reader_kwargs["header"] = None
44
+
45
+ # - Skip header
42
46
  reader_kwargs["skiprows"] = 0
43
- # - Skip file with encoding errors
44
- reader_kwargs["encoding_errors"] = "ignore"
47
+
48
+ # - Define encoding
49
+ reader_kwargs["encoding"] = "ISO-8859-1"
50
+
45
51
  # - Avoid first column to become df index !!!
46
52
  reader_kwargs["index_col"] = False
53
+
47
54
  # - Define behaviour when encountering bad lines
48
55
  reader_kwargs["on_bad_lines"] = "skip"
56
+
49
57
  # - Define reader engine
50
58
  # - C engine is faster
51
59
  # - Python engine is more feature-complete
52
60
  reader_kwargs["engine"] = "python"
61
+
53
62
  # - Define on-the-fly decompression of on-disk data
54
63
  # - Available: gzip, bz2, zip
55
- reader_kwargs["compression"] = "infer"
64
+ # reader_kwargs['compression'] = 'xz'
65
+
56
66
  # - Strings to recognize as NA/NaN and replace with standard NA flags
57
67
  # - Already included: '#N/A', '#N/A N/A', '#NA', '-1.#IND', '-1.#QNAN',
58
68
  # '-NaN', '-nan', '1.#IND', '1.#QNAN', '<NA>', 'N/A',
59
69
  # 'NA', 'NULL', 'NaN', 'n/a', 'nan', 'null'
60
- reader_kwargs["na_values"] = ["na", "", "error", "NA", "-.-"]
70
+ reader_kwargs["na_values"] = ["na", "error", "-.-", " NA"]
61
71
 
62
72
  ##------------------------------------------------------------------------.
63
73
  #### Read the data
@@ -70,37 +80,47 @@ def reader(
70
80
 
71
81
  ##------------------------------------------------------------------------.
72
82
  #### Adapt the dataframe to adhere to DISDRODB L0 standards
73
- # Convert time column to datetime
74
- df_time = pd.to_datetime(df["time"], format="%Y%m%d%H%M%S", errors="coerce")
83
+ # Raise error if empty file
84
+ if len(df) == 0:
85
+ raise ValueError(f"{filepath} is empty.")
86
+
87
+ # Select only rows with expected number of delimiters
88
+ df = df[df["TO_PARSE"].str.count(";") == 1027]
89
+
90
+ # Check there are still valid rows
91
+ if len(df) == 0:
92
+ raise ValueError(f"No valid rows in {filepath}.")
75
93
 
76
- # Split the 'TO_BE_SPLITTED' column
77
- df = df["TO_BE_SPLITTED"].str.split(",", n=9, expand=True)
94
+ # Split into columns
95
+ df = df["TO_PARSE"].str.split(";", expand=True, n=4)
78
96
 
79
- # Assign column names
97
+ # Assign columns names
80
98
  names = [
81
- "station_name",
82
- "sensor_status",
83
- "sensor_temperature",
84
- "number_particles",
85
- "rainfall_rate_32bit",
86
- "reflectivity_16bit",
87
- "mor_visibility",
88
- "weather_code_synop_4680",
89
- "weather_code_synop_4677",
99
+ "date",
100
+ "time",
101
+ "id",
102
+ "unknown",
90
103
  "raw_drop_number",
91
104
  ]
92
105
  df.columns = names
93
106
 
94
- # Add the time column
95
- df["time"] = df_time
107
+ # Add datetime time column
108
+ time_str = df["date"] + "T" + df["time"]
109
+ df["time"] = pd.to_datetime(time_str, format="%Y/%m/%dT%H:%M:%S", errors="coerce")
110
+ df = df.drop(columns=["date"])
96
111
 
97
- # Drop columns not agreeing with DISDRODB L0 standards
98
- df = df.drop(columns=["station_name"])
112
+ # Retrieve raw spectrum
113
+ # - Add 0 before every , if , not preceded by a digit
114
+ # - Example: ',,1,,' --> '0,0,1,0,'
115
+ df["raw_drop_number"] = df["raw_drop_number"] + ";"
116
+ df["raw_drop_number"] = df["raw_drop_number"].str.replace(r"(?<!\d);", "0;", regex=True)
99
117
 
100
- # Drop rows with invalid values
101
- # --> Ensure that weather_code_synop_4677 has length 2
102
- # --> If a previous column is missing it will have 000
103
- df = df[df["weather_code_synop_4677"].str.len() == 2]
118
+ # Drop columns not agreeing with DISDRODB L0 standards
119
+ columns_to_drop = [
120
+ "id",
121
+ "unknown",
122
+ ]
123
+ df = df.drop(columns=columns_to_drop)
104
124
 
105
125
  # Return the dataframe adhering to DISDRODB L0 standards
106
126
  return df
@@ -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
@@ -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
@@ -38,11 +38,14 @@ def reader(
38
38
  # - Define delimiter
39
39
  reader_kwargs["delimiter"] = "/\n"
40
40
 
41
- # Skip first row as columns names
41
+ # - Skip first row as columns names
42
42
  reader_kwargs["header"] = None
43
43
 
44
- # Skip first 2 rows
45
- reader_kwargs["skiprows"] = 1
44
+ # - Skip first 2 rows
45
+ reader_kwargs["skiprows"] = 0
46
+
47
+ # - Define encoding
48
+ reader_kwargs["encoding"] = "ISO-8859-1"
46
49
 
47
50
  # - Avoid first column to become df index !!!
48
51
  reader_kwargs["index_col"] = False
@@ -76,12 +79,17 @@ def reader(
76
79
 
77
80
  ##------------------------------------------------------------------------.
78
81
  #### Adapt the dataframe to adhere to DISDRODB L0 standards
79
- # Remove rows with invalid length
80
- # df = df[df["TO_BE_PARSED"].str.len().isin([4664])]
82
+ # Raise error if empty file
83
+ if len(df) == 0:
84
+ raise ValueError(f"{filepath} is empty.")
81
85
 
82
- # Count number of delimiters to select valid rows
86
+ # Select only rows with expected number of delimiters
83
87
  df = df[df["TO_BE_PARSED"].str.count(";") == 1107]
84
88
 
89
+ # Raise error if no data left
90
+ if len(df) == 0:
91
+ raise ValueError(f"No valid data in {filepath}.")
92
+
85
93
  # Split by ; delimiter
86
94
  df = df["TO_BE_PARSED"].str.split(";", expand=True, n=19)
87
95
 
@@ -132,5 +140,4 @@ def reader(
132
140
  "sample_interval",
133
141
  ]
134
142
  df = df.drop(columns=columns_to_drop)
135
-
136
143
  return df
@@ -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
@@ -157,12 +157,17 @@ def reader(
157
157
 
158
158
  ##------------------------------------------------------------------------.
159
159
  #### Adapt the dataframe to adhere to DISDRODB L0 standards
160
- # Remove rows with invalid length
161
- # df = df[df["TO_BE_PARSED"].str.len().isin([4664])]
160
+ # Raise error if empty file
161
+ if len(df) == 0:
162
+ raise ValueError(f"{filepath} is empty.")
162
163
 
163
- # Count number of delimiters to select valid rows
164
+ # Select only rows with expected number of delimiters
164
165
  df = df[df["TO_BE_PARSED"].str.count(";") == 1107]
165
166
 
167
+ # Raise error if no data left
168
+ if len(df) == 0:
169
+ raise ValueError(f"No valid data in {filepath}.")
170
+
166
171
  # Split by ; delimiter
167
172
  df = df["TO_BE_PARSED"].str.split(";", expand=True, n=19)
168
173
 
@@ -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
@@ -44,16 +44,18 @@ def reader(
44
44
  """Reader."""
45
45
  ##------------------------------------------------------------------------.
46
46
  #### Define column names
47
- column_names = ["time", "TO_BE_SPLITTED"]
47
+ column_names = ["TO_PARSE"]
48
48
 
49
49
  ##------------------------------------------------------------------------.
50
50
  #### Define reader options
51
51
  reader_kwargs = {}
52
52
  # - Define delimiter
53
- reader_kwargs["delimiter"] = ";"
53
+ reader_kwargs["delimiter"] = "//n"
54
54
  # - Skip first row as columns names
55
55
  reader_kwargs["header"] = None
56
56
  reader_kwargs["skiprows"] = 0
57
+ # - Define encoding
58
+ reader_kwargs["encoding"] = "latin-1"
57
59
  # - Skip file with encoding errors
58
60
  reader_kwargs["encoding_errors"] = "ignore"
59
61
  # - Avoid first column to become df index !!!
@@ -84,6 +86,20 @@ def reader(
84
86
 
85
87
  ##------------------------------------------------------------------------.
86
88
  #### Adapt the dataframe to adhere to DISDRODB L0 standards
89
+ # Remove rows with invalid number of separators
90
+ df = df[df["TO_PARSE"].str.count(";") == 1]
91
+ if len(df) == 0:
92
+ raise ValueError(f"No valid data in {filepath}")
93
+
94
+ # Retrieve time and telegram field
95
+ df = df["TO_PARSE"].str.split(";", expand=True)
96
+ df.columns = ["time", "TO_BE_SPLITTED"]
97
+
98
+ # Remove rows with invalid number of separators
99
+ df = df[df["TO_BE_SPLITTED"].str.count(",") == 1033]
100
+ if len(df) == 0:
101
+ raise ValueError(f"No valid data in {filepath}")
102
+
87
103
  # Convert time column to datetime
88
104
  df_time = pd.to_datetime(df["time"], format="%Y%m%d%H%M%S", errors="coerce")
89
105
 
@@ -91,7 +107,7 @@ def reader(
91
107
  df = df["TO_BE_SPLITTED"].str.split(",", n=9, expand=True)
92
108
 
93
109
  # Assign column names
94
- names = [
110
+ columns_names = [
95
111
  "station_name",
96
112
  "sensor_status",
97
113
  "sensor_temperature",
@@ -103,7 +119,7 @@ def reader(
103
119
  "weather_code_synop_4677",
104
120
  "raw_drop_number",
105
121
  ]
106
- df.columns = names
122
+ df.columns = columns_names
107
123
 
108
124
  # Add the time column
109
125
  df["time"] = df_time
@@ -111,10 +127,19 @@ def reader(
111
127
  # Drop columns not agreeing with DISDRODB L0 standards
112
128
  df = df.drop(columns=["station_name"])
113
129
 
130
+ # Remove rows with invalid raw drop number
131
+ # --> Occurs e.g. in UCONN apu28
132
+ # def mask_invalid_raw_drop_number(df)
133
+ # df_split = df["raw_drop_number"].str.split(",", expand=True)
134
+ # idx = np.where(np.any(df_split.astype(float) > 998, axis=1))[0]
135
+ # df.loc[idx, "raw_drop_number"] = "NaN"
136
+ # return df
137
+ df = df[df["raw_drop_number"].str.len() == 4096]
138
+
114
139
  # Drop rows with invalid values
115
140
  # --> Ensure that weather_code_synop_4677 has length 2
116
141
  # --> If a previous column is missing it will have 000
117
- df = df[df["weather_code_synop_4677"].str.len() == 2]
142
+ # df = df[df["weather_code_synop_4677"].str.len() == 2]
118
143
 
119
144
  # Return the dataframe adhering to DISDRODB L0 standards
120
145
  return df
@@ -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
@@ -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