Skip to content

Commit 6feff22

Browse files
wolfidanwolfidan
committed
added description for all config files
1 parent a10669f commit 6feff22

39 files changed

+627
-472
lines changed

‎.gitignore

-1
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,6 @@ dist/
1414
downloads/
1515
eggs/
1616
.eggs/
17-
lib/
1817
lib64/
1918
parts/
2019
sdist/

‎binder/appendix.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
USER root
2-
RUN echo "export PYART_CONFIG=/home/jovyan/pyrad_config/mch_config.py" >> ~/.profile && \
2+
RUN echo "export PYART_CONFIG=/home/jovyan/pyrad_config/mf_config.py" >> ~/.profile && \
33
echo "export METRANETLIB_PATH=/home/jovyan/lib/" >> ~/.profile && \
44
rm -r /srv/conda/envs/notebook/lib/python3.9/site-packages/pyart_mch-1.8.1.dist-info/ && \
55
rm -r /srv/conda/envs/notebook/lib/python3.9/site-packages/pyart && \

‎binder/environment.yml

+1
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ dependencies:
1313
- pydda
1414
- pyart_mch
1515
- xradar
16+
- pygrib
1617
- wradlib
1718
- sphinx=5.0
1819
- dask

‎data/Attenuation/L/22179/MHL22179/MHL2217907250U.003

-14.3 MB
Binary file not shown.

‎environment.yml

+1
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,7 @@ dependencies:
1313
- pydda
1414
- pyart_mch
1515
- xradar
16+
- pygrib
1617
- wradlib
1718
- sphinx=5.0
1819
- dask

‎notebooks/pyrad/description-config.ipynb

+148-24
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,10 @@
1919
" - Plot along specific polar coordinates\n",
2020
"\n",
2121
"\n",
22-
"**How to run** : *cd pyrad_config/00_plot_vol; main_process_data.py --cfgpath ./ --starttime 20230801000000 --endtime 20230802000000 jma_plot_vol.txt*\n",
22+
"**How to run** \n",
23+
" ```\n",
24+
"cd pyrad_config/00_plot_vol; main_process_data.py --cfgpath ./ --starttime 20230801000000 --endtime 20230802000000 jma_plot_vol.txt\n",
25+
" ```\n",
2326
"\n",
2427
"## 1 : Create a Cartesian grid and plot it (pyrad_config/01_grid)\n",
2528
"---\n",
@@ -35,39 +38,158 @@
3538
" - Cross-section between two points\n",
3639
"\n",
3740
"\n",
38-
"**How to run** : *cd pyrad_config/01_grid; main_process_data.py --cfgpath ./ --starttime 20230801000000 --endtime 20230802000000 jma_grid.txt*\n",
41+
"**How to run** \n",
42+
" ```\n",
43+
"cd pyrad_config/01_grid; main_process_data.py --cfgpath ./ --starttime 20230801000000 --endtime 20230802000000 jma_grid.txt\n",
44+
" ```\n",
3945
"\n",
40-
"## 2 : Create a Cartesian grid and plot it (pyrad_config/01_grid)\n",
46+
"## 2 : Ground-clutter removal (pyrad_config/02_clutter_filter)\n",
4147
"---\n",
4248
" \n",
4349
"This pyrad configuration file does the following:\n",
44-
"- Read polar reflectivity and RhoHV data from JMA\n",
45-
"- Convert polar data to a Cartesian grid\n",
46-
"- Perform a series of plots from the Cartesian data\n",
47-
" - Histogram plot\n",
48-
" - Surfaces at specified heights\n",
49-
" - Latitude slice\n",
50-
" - Longitude slice\n",
51-
" - Cross-section between two points\n",
50+
"- Read polar data from MeteoFrance radar (Zh, RhoHV, ZDR, PhiDP)\n",
51+
"- Use this data to detect ground-clutter\n",
52+
"- Remove ground-clutter from the radar data\n",
53+
"- Make PPI plots of filtered Zh, RhoHV, ZDR and PhiDP\n",
5254
"\n",
5355
"\n",
54-
"**How to run** : *cd pyrad_config/01_grid; main_process_data.py --cfgpath ./ --starttime 20230801000000 --endtime 20230802000000 jma_grid.txt*\n",
56+
"**How to run**\n",
57+
"```\n",
58+
" cd pyrad_config/02_clutter_filter; main_process_data.py --cfgpath ./ --starttime 20210114101500 --endtime 20210114120000 mf_pam_mtcy_filter.txt\n",
59+
"```\n",
60+
"\n",
61+
"## 3 : Compute KDP (pyrad_config/03_phidp_kdp)\n",
62+
"---\n",
63+
" \n",
64+
"This pyrad configuration file does the following:\n",
65+
"- Read polar data from MeteoFrance radar (Zh, RhoHV, ZDR, PhiDP)\n",
66+
"- Read a GRIB iso0 height file from MeteoFrance\n",
67+
"- Correct ground clutter as in 02_clutter_filter\n",
68+
"- Perform smoothing of raw PhiDP\n",
69+
"- Estimate KDP with different methods:\n",
70+
" - Vulpiani filtering method\n",
71+
" - Maesaka variational method\n",
72+
" - Linear programming method\n",
73+
" - Kalman filter method\n",
74+
" - Moving least-squares filter\n",
75+
"- Perform attenuation correction\n",
76+
" - ZPHI method\n",
77+
" - Philinear method\n",
78+
"- Perform PPI plots of KDP, attenuation corrected Zh, specific attenuation, PIA and PIDA\n",
79+
"\n",
80+
"\n",
81+
"**How to run**\n",
82+
" ```\n",
83+
"cd pyrad_config/03_phidp_kdp; main_process_data.py --cfgpath ./ --starttime 20210114101500 --endtime 20210114120000 mf_pam_mtcy_kdp.txt\n",
84+
" ```\n",
85+
"\n",
86+
"## 4 : Classifiy hydrometeors (pyrad_config/04_hydroclass)\n",
87+
"---\n",
88+
" \n",
89+
"This pyrad configuration file does the following:\n",
90+
"- Read polar data from MeteoFrance radar (Zh, RhoHV, ZDR, PhiDP)\n",
91+
"- Read a GRIB iso0 height file from MeteoFrance\n",
92+
"- Compute hydrometeor classification\n",
93+
" - With semi-supervised method (Besic, 2016)\n",
94+
" - By mapping MeteoFrance operational classification\n",
95+
"- Plot PPIs of hydrometeor classification\n",
5596
"\n",
5697
"\n",
57-
"## 4 : KDP and specific attenuation (pyrad_config/04_attenuation)\n",
98+
"**How to run**\n",
99+
" ```\n",
100+
" cd pyrad_config/04_hydroclass; main_process_data.py --cfgpath ./ --starttime 20200516200500 --endtime 20200516220000 mf_odim_coll_hydro.txt\n",
101+
" ```\n",
102+
"\n",
103+
"## 5 : Melting layer detection(pyrad_config/05_ml)\n",
104+
"---\n",
105+
" \n",
106+
"This pyrad configuration file does the following:\n",
107+
"- Read polar data from MeteoFrance radar (Zh, RhoHV, ZDR, PhiDP)\n",
108+
"- Read a GRIB iso0 height file from MeteoFrance\n",
109+
"- Compute melting layer (ML) extent\n",
110+
" - With Giangrande method\n",
111+
" - With MeteoFrance method\n",
112+
"- Estimate VPR (vertical profile of reflectivity) with MeteoFrance algorithm\n",
113+
"- Correct reflectivity with VPR\n",
114+
"- Create relevant products\n",
115+
" - Timeseries of ML and VPR\n",
116+
" - PPIs of corrected reflectivity and ML extent overlaid on radar moments\n",
117+
" - Altitude plots of apparent VPR and theoretical VPR\n",
118+
"\n",
119+
"\n",
120+
"**How to run**\n",
121+
" ```\n",
122+
" cd pyrad_config/05_ml; main_process_data.py --cfgpath ./ --starttime 20200516200500 --endtime 20200516220000 mf_odim_coll_ml.txt\n",
123+
" ```\n",
124+
"\n",
125+
"## 6 : Quantitative precipitation estimation (pyrad_config/06_rr)\n",
126+
"---\n",
127+
" \n",
128+
"This pyrad configuration file does the following:\n",
129+
"- Read polar data from MeteoFrance radar (Zh, RhoHV, ZDR, PhiDP)\n",
130+
"- Read a GRIB iso0 height file from MeteoFrance\n",
131+
"- Compute attenuation with ZPHI method\n",
132+
"- Estimate precipitation with 4 methods\n",
133+
" - From Zh with R-Z relationship\n",
134+
" - From KDP with R-KDP relationship\n",
135+
" - From Ah (specific attenuation) with R-A relationship\n",
136+
" - From hydrometeor classification using different estimators for every class\n",
137+
"- Compute rainfall accumulation over one hour\n",
138+
"\n",
139+
"**How to run**\n",
140+
" ```\n",
141+
" cd pyrad_config/06_rr; main_process_data.py --cfgpath ./ --starttime 20200516200500 --endtime 20200516220000 mf_odim_coll_rr.txt\n",
142+
" ```\n",
143+
"\n",
144+
"## 7 : Compute velocity azimuth display (pyrad_config/07_VAD)\n",
58145
"---\n",
146+
" \n",
59147
"This pyrad configuration file does the following:\n",
60-
"- Read raw radar data from one of the Swiss operational C-band radars\n",
61-
"- Plot PPI of reflectivity\n",
62-
"- Perform echo classification and filter clutter\n",
63-
"- Estimate KDP with the Maesaka method\n",
64-
"- Estimate the specific attenuation with the ZPHI method.\n",
65-
"- Create PPI maps of KDP, corrected reflectivity and specific attenuation.\n",
148+
"- Read Doppler data from MeteoFrance radar\n",
149+
"- Compute velocity azimuth display (VAD) from Doppler velocity\n",
150+
"- Plot and save (csv) vertical profiles of wind:\n",
151+
" - U,V,W wind components\n",
152+
" - Wind speed and direction\n",
66153
"\n",
67154
"\n",
68-
"**How to run** : *cd pyrad_config/04_attenuation; main_process_data.py --cfgpath ./ --starttime 20220628072500 --endtime 20220628072500 attenuation.txt*\n",
155+
"**How to run**\n",
156+
" ```\n",
157+
" cd pyrad_config/07_VAD; main_process_data.py --cfgpath ./ --starttime 20210114101500 --endtime 20210114120000 mf_pag_mtcy_doppler.txt\n",
158+
" ```\n",
69159
"\n",
70-
"## 11 : Radar visibility from a DEM with the GECSX tool (pyrad_config/11_visibility/)\n",
160+
"## 8 : Compute dual-Doppler estimation (pyrad_config/08_DDA)\n",
161+
"---\n",
162+
" \n",
163+
"This pyrad configuration file does the following:\n",
164+
"- Read polar data from MeteoSwiss C-band and X-band radar\n",
165+
"- Perform ground clutter removal for X-band data\n",
166+
"- Load C-band operational dealiased Doppler velocity\n",
167+
"- Perform dual-Doppler estimation using the pyDDA wrapper with sounding data from wmo:06610 for initial conditions\n",
168+
"- Generate plots:\n",
169+
" - 2D wind arrow maps at 1000, 2000 and 3000 m.a.s.l\n",
170+
" - Cross-sections of U,V and W wind components along runway 32 (RW32) of Zurich Airport\n",
171+
"\n",
172+
"**How to run**\n",
173+
" ```\n",
174+
" cd pyrad_config/08_DDA; main_process_data.py --cfgpath ./ --starttime 20210114101500 --endtime 20210114120000 mf_pag_mtcy_doppler.txt\n",
175+
" ```\n",
176+
"\n",
177+
"## 9 : Quasi-vertical profiles (pyrad_config/09_QVP)\n",
178+
"---\n",
179+
"\n",
180+
"This pyrad configuration file does the following:\n",
181+
"- Perform timeseries of QVP profiles of Zh, ZDR, RHoHV and KDP data from MeteoFrance, using 4 QVP algorithms:\n",
182+
" - Original QVP algorithm [Ryzhkov et al. (2016)](https://journals.ametsoc.org/view/journals/atot/37/9/jtechD200011.xml#bib60)\n",
183+
" - Ranged-defined QVP [Tobin and Kumjian (2017)](https://journals.ametsoc.org/view/journals/atot/37/9/jtechD200011.xml#bib76)\n",
184+
" - Enhanced vertical profile [Bukovčić et al. (2017)](https://journals.ametsoc.org/view/journals/atot/37/9/jtechD200011.xml#bib10)\n",
185+
" - Slanted vertical profile [Bukovčić et al. (2017)](https://journals.ametsoc.org/view/journals/atot/37/9/jtechD200011.xml#bib10)\n",
186+
" \n",
187+
"**How to run**\n",
188+
" ```\n",
189+
" cd pyrad_config/09_QVP; main_process_data.py --cfgpath ./ --starttime 20200516200500 --endtime 20200516220000 mf_odim_coll_qvp.txt\n",
190+
" ```\n",
191+
"\n",
192+
"## 10 : Radar visibility from a DEM with the GECSX tool (pyrad_config/11_visibility/)\n",
71193
"---\n",
72194
"\n",
73195
"This pyrad configuration file does the following:\n",
@@ -76,9 +198,11 @@
76198
"- Create PPI plots of the clutter and the visibility\n",
77199
"- Create Grid map plots of several other products generated by GECSX (e.g. slope, aspect, min. visible elevation angle,...)\n",
78200
"\n",
79-
"**How to run** : \n",
80-
"- *cd pyrad_config/11_visibility/; main_process_gecsx.py --cfgpath ./ visibility_norad.txt* (no radar data)\n",
81-
"- *cd pyrad_config/11_visibility/; main_process_gecsx.py --cfgpath ./ --starttime 20231127170000 --endtime 20231127180000 visibility.txt* (with radar data)"
201+
"**How to run**\n",
202+
" ```\n",
203+
"cd pyrad_config/11_visibility/; main_process_gecsx.py --cfgpath ./ visibility_norad.txt # no radar data\n",
204+
"cd pyrad_config/11_visibility/; main_process_gecsx.py --cfgpath ./ --starttime 20231127170000 --endtime 20231127180000 visibility.txt # with radar data\n",
205+
" ```"
82206
]
83207
}
84208
],

‎pyrad_config/00_plot_vol/jma_plot_vol.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77

88
# Name of this configuration:
99
# Will be used in product generation save path
10-
name STRING PLOT_VOL
10+
name STRING 00_plot_vol
1111

1212
# ---------------------------------------------------------
1313
# Raw data pathes

‎pyrad_config/01_grid/jma_grid.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@
77

88
# Name of this configuration:
99
# Will be used in product generation save path
10-
name STRING GRID
10+
name STRING 01_grid
1111

1212
# ---------------------------------------------------------
1313
# Raw data pathes

‎pyrad_config/02_clutter_filter/mf_pam_mtcy_filter.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88

99
# Name of this configuration:
1010
# Will be used in product generation save path
11-
name STRING MF_PAM_MTCY
11+
name STRING 02_clutter_filter
1212

1313
# ---------------------------------------------------------
1414
# Raw data pathes

‎pyrad_config/03_phidp_kdp/mf_pam_mtcy_kdp.txt

+1-1
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010

1111
# Name of this configuration:
1212
# Will be used in product generation save path
13-
name STRING MF_PAM_MTCY
13+
name STRING 03_phidp_kdp
1414

1515
# ---------------------------------------------------------
1616
# Raw data pathes

‎pyrad_config/03_phidp_kdp/mf_pam_mtcy_kdp_loc.txt

+3
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,9 @@ rmax FLOAT 100000.
1616
ScanList STRARR 1
1717
PAM_67_data_ # masterscan: first scan of a volume
1818

19+
# Radar frequency
20+
frequency FLOAT 5.6E9
21+
1922
# scan strategy
2023
# cycle 1: 90/5 /2.2/1.2/0.7/0.4
2124
# cycle 2: 7/3.9/2.2/1.2/0.7/0.4

‎pyrad_config/04_attenuation/attenuation.txt

-31
This file was deleted.

0 commit comments

Comments
 (0)