From ff3b231624de3978c2fd4a8dc261e1644b206b07 Mon Sep 17 00:00:00 2001 From: Arjo Segers Date: Wed, 8 Apr 2026 10:02:01 +0200 Subject: [PATCH 1/2] Updated template settings for STAC api. --- config/Copernicus/cso-s5p-co.rc | 18 +++++------------- config/Copernicus/cso-s5p-hcho.rc | 16 ++++------------ config/Copernicus/cso-s5p-no2.rc | 16 ++++------------ config/Copernicus/cso-s5p-o3-pr.rc | 20 ++++---------------- config/Copernicus/cso-s5p-so2.rc | 22 ++++++++-------------- 5 files changed, 25 insertions(+), 67 deletions(-) diff --git a/config/Copernicus/cso-s5p-co.rc b/config/Copernicus/cso-s5p-co.rc index 7bb95d2..fa6e72c 100644 --- a/config/Copernicus/cso-s5p-co.rc +++ b/config/Copernicus/cso-s5p-co.rc @@ -34,16 +34,11 @@ cso.s5p.co.inquire-table-dataspace.timerange.start : ${my.full-timerange cso.s5p.co.inquire-table-dataspace.timerange.end : ${my.full-timerange.end} ! API url: -cso.s5p.co.inquire-table-dataspace.url : https://catalogue.dataspace.copernicus.eu/resto/api +cso.s5p.co.inquire-table-dataspace.url : https://stac.dataspace.copernicus.eu/v1 -! collection name: -cso.s5p.co.inquire-table-dataspace.collection : Sentinel5P - -! product type, always 10 characters! -! L2__CO___ -! L2__CO____ -! ... -cso.s5p.co.inquire-table-dataspace.producttype : L2__CO____ +! collection names (space seperated list): +cso.s5p.co.inquire-table-dataspace.collections : sentinel-5p-l2-co-rpro \ + sentinel-5p-l2-co-offl ! target area; !!~ empty for no limitation: @@ -51,9 +46,6 @@ cso.s5p.co.inquire-table-dataspace.producttype : L2__CO____ !~ domain specified as: west,south,east,north cso.s5p.co.inquire-table-dataspace.area : ${my.region.west},${my.region.south},${my.region.east},${my.region.north} -! template for download url given "{product_id}": -cso.s5p.co.inquire-table-dataspace.download_url : https://zipper.dataspace.copernicus.eu/odata/v1/Products({product_id})/$value - ! output table, date of today: cso.s5p.co.inquire-table-dataspace.output.file : ${my.work}/Copernicus-inquire/Copernicus_S5p_CO_dataspace__%Y-%m-%d.csv @@ -160,7 +152,7 @@ my.s5p.co.selection : C03 ! (%{collection} == '03') and (%{processing} == 'OFFL') ! #if "${my.s5p.co.selection}" == "C03" -cso.s5p.co.convert.selection : (%{collection} == '03') and (%{processing} == 'RPRO') ; \ +cso.s5p.co.convert.selection : (%{collection} == '03') and (%{processing} == 'RPRO') ; \ (%{collection} == '03') and (%{processing} == 'OFFL') #else #error unsupported my.s5p.co.selection "${my.s5p.co.selection}" diff --git a/config/Copernicus/cso-s5p-hcho.rc b/config/Copernicus/cso-s5p-hcho.rc index 77026f1..20b7bea 100644 --- a/config/Copernicus/cso-s5p-hcho.rc +++ b/config/Copernicus/cso-s5p-hcho.rc @@ -34,16 +34,11 @@ cso.s5p.hcho.inquire-table-dataspace.timerange.start : ${my.full-timeran cso.s5p.hcho.inquire-table-dataspace.timerange.end : ${my.full-timerange.end} ! API url: -cso.s5p.hcho.inquire-table-dataspace.url : https://catalogue.dataspace.copernicus.eu/resto/api +cso.s5p.hcho.inquire-table-dataspace.url : https://stac.dataspace.copernicus.eu/v1 -! collection name: -cso.s5p.hcho.inquire-table-dataspace.collection : Sentinel5P - -! product type, always 10 characters! -! L2__HCHO___ -! L2__CO____ -! ... -cso.s5p.hcho.inquire-table-dataspace.producttype : L2__HCHO__ +! collection names (space seperated list): +cso.s5p.hcho.inquire-table-dataspace.collections : sentinel-5p-l2-hcho-rpro \ + sentinel-5p-l2-hcho-offl ! target area; !!~ empty for no limitation: @@ -51,9 +46,6 @@ cso.s5p.hcho.inquire-table-dataspace.producttype : L2__HCHO__ !~ domain specified as: west,south,east,north cso.s5p.hcho.inquire-table-dataspace.area : ${my.region.west},${my.region.south},${my.region.east},${my.region.north} -! template for download url given "{product_id}": -cso.s5p.hcho.inquire-table-dataspace.download_url : https://zipper.dataspace.copernicus.eu/odata/v1/Products({product_id})/$value - ! output table, date of today: cso.s5p.hcho.inquire-table-dataspace.output.file : ${my.work}/Copernicus-inquire/Copernicus_S5p_HCHO_dataspace__%Y-%m-%d.csv diff --git a/config/Copernicus/cso-s5p-no2.rc b/config/Copernicus/cso-s5p-no2.rc index 5ae5685..4cc36ed 100644 --- a/config/Copernicus/cso-s5p-no2.rc +++ b/config/Copernicus/cso-s5p-no2.rc @@ -34,16 +34,11 @@ cso.s5p.no2.inquire-table-dataspace.timerange.start : ${my.full-timerang cso.s5p.no2.inquire-table-dataspace.timerange.end : ${my.full-timerange.end} ! API url: -cso.s5p.no2.inquire-table-dataspace.url : https://catalogue.dataspace.copernicus.eu/resto/api +cso.s5p.no2.inquire-table-dataspace.url : https://stac.dataspace.copernicus.eu/v1 -! collection name: -cso.s5p.no2.inquire-table-dataspace.collection : Sentinel5P - -! product type, always 10 characters! -! L2__NO2___ -! L2__CO____ -! ... -cso.s5p.no2.inquire-table-dataspace.producttype : L2__NO2___ +! collection names (space seperated list): +cso.s5p.no2.inquire-table-dataspace.collections : sentinel-5p-l2-no2-rpro \ + sentinel-5p-l2-no2-offl ! target area; !!~ empty for no limitation: @@ -51,9 +46,6 @@ cso.s5p.no2.inquire-table-dataspace.producttype : L2__NO2___ !~ domain specified as: west,south,east,north cso.s5p.no2.inquire-table-dataspace.area : ${my.region.west},${my.region.south},${my.region.east},${my.region.north} -! template for download url given "{product_id}": -cso.s5p.no2.inquire-table-dataspace.download_url : https://zipper.dataspace.copernicus.eu/odata/v1/Products({product_id})/$value - ! output table, date of today: cso.s5p.no2.inquire-table-dataspace.output.file : ${my.work}/Copernicus-inquire/Copernicus_S5p_NO2_dataspace__%Y-%m-%d.csv diff --git a/config/Copernicus/cso-s5p-o3-pr.rc b/config/Copernicus/cso-s5p-o3-pr.rc index 257706e..6d01be9 100644 --- a/config/Copernicus/cso-s5p-o3-pr.rc +++ b/config/Copernicus/cso-s5p-o3-pr.rc @@ -34,20 +34,11 @@ cso.s5p.o3-pr.inquire-table-dataspace.timerange.start : ${my.full-timera cso.s5p.o3-pr.inquire-table-dataspace.timerange.end : ${my.full-timerange.end} ! API url: -cso.s5p.o3-pr.inquire-table-dataspace.url : https://catalogue.dataspace.copernicus.eu/resto/api +cso.s5p.o3-pr.inquire-table-dataspace.url : https://stac.dataspace.copernicus.eu/v1 -! collection name: -cso.s5p.o3-pr.inquire-table-dataspace.collection : Sentinel5P - -! product type, always 10 characters! -! L2__O3____ : ozone total column -! L2__O3_TCL : ozone tropospheric column -! Level3 product? -! 3-days running average on 1.0 x 0.5 (lon x lat) grid -! L2__O3__PR : ozone profile -! L2__CO____ -! ... -cso.s5p.o3-pr.inquire-table-dataspace.producttype : L2__O3__PR +! collection names (space seperated list): +cso.s5p.o3-pr.inquire-table-dataspace.collections : sentinel-5p-l2-o3-pr-rpro \ + sentinel-5p-l2-o3-pr-offl ! target area; !!~ empty for no limitation: @@ -55,9 +46,6 @@ cso.s5p.o3-pr.inquire-table-dataspace.producttype : L2__O3__PR !~ domain specified as: west,south,east,north cso.s5p.o3-pr.inquire-table-dataspace.area : ${my.region.west},${my.region.south},${my.region.east},${my.region.north} -! template for download url given "{product_id}": -cso.s5p.o3-pr.inquire-table-dataspace.download_url : https://zipper.dataspace.copernicus.eu/odata/v1/Products({product_id})/$value - ! output table, date of today: cso.s5p.o3-pr.inquire-table-dataspace.output.file : ${my.work}/Copernicus-inquire/Copernicus_S5p_O3-PR_dataspace__%Y-%m-%d.csv diff --git a/config/Copernicus/cso-s5p-so2.rc b/config/Copernicus/cso-s5p-so2.rc index e3e00a5..4a6c758 100644 --- a/config/Copernicus/cso-s5p-so2.rc +++ b/config/Copernicus/cso-s5p-so2.rc @@ -34,16 +34,11 @@ cso.s5p.so2.inquire-table-dataspace.timerange.start : ${my.full-timerang cso.s5p.so2.inquire-table-dataspace.timerange.end : ${my.full-timerange.end} ! API url: -cso.s5p.so2.inquire-table-dataspace.url : https://catalogue.dataspace.copernicus.eu/resto/api +cso.s5p.so2.inquire-table-dataspace.url : https://stac.dataspace.copernicus.eu/v1 -! collection name: -cso.s5p.so2.inquire-table-dataspace.collection : Sentinel5P - -! product type, always 10 characters! -! L2__SO2___ -! L2__CO____ -! ... -cso.s5p.so2.inquire-table-dataspace.producttype : L2__SO2___ +! collection names (space seperated list): +cso.s5p.so2.inquire-table-dataspace.collections : sentinel-5p-l2-so2-rpro \ + sentinel-5p-l2-so2-offl ! target area; !!~ empty for no limitation: @@ -51,9 +46,6 @@ cso.s5p.so2.inquire-table-dataspace.producttype : L2__SO2___ !~ domain specified as: west,south,east,north cso.s5p.so2.inquire-table-dataspace.area : ${my.region.west},${my.region.south},${my.region.east},${my.region.north} -! template for download url given "{product_id}": -cso.s5p.so2.inquire-table-dataspace.download_url : https://zipper.dataspace.copernicus.eu/odata/v1/Products({product_id})/$value - ! output table, date of today: cso.s5p.so2.inquire-table-dataspace.output.file : ${my.work}/Copernicus-inquire/Copernicus_S5p_SO2_dataspace__%Y-%m-%d.csv @@ -107,8 +99,10 @@ my.s5p.so2.download.selection : C03 ! (%{collection} == '03') and (%{processing} == 'OFFL') ! #if "${my.s5p.so2.download.selection}" == "C03" -cso.s5p.so2.download.selection : (%{collection} == '03') and (%{processing} == 'RPRO') ; \ - (%{collection} == '03') and (%{processing} == 'OFFL') +!~ SO2 on DataSpace has a reprocessing with v2.7.0 (using COBRA algorithm?), +! ignore the previous processings: +cso.s5p.so2.download.selection : (%{collection} == '03') and (%{processing} == 'RPRO') & (%{processor_version} >= '020700') ; \ + (%{collection} == '03') and (%{processing} == 'OFFL') & (%{processor_version} >= '020700') #else #error unsupported my.s5p.so2.download.selection "${my.s5p.so2.download.selection}" #endif -- GitLab From 8abd7987e49aef9bc83c63354417bbf1e54f0427 Mon Sep 17 00:00:00 2001 From: Arjo Segers Date: Wed, 8 Apr 2026 10:02:12 +0200 Subject: [PATCH 2/2] Updated User Guide. --- doc/source/figs/SO2/Copernicus_S5p_SO2.png | Bin 47193 -> 46841 bytes doc/source/s5p-so2.rst | 131 +++++++++++---------- 2 files changed, 68 insertions(+), 63 deletions(-) diff --git a/doc/source/figs/SO2/Copernicus_S5p_SO2.png b/doc/source/figs/SO2/Copernicus_S5p_SO2.png index 65b0435fc8b9de5c3105ef1417a54ead945a3042..48d701593a5e316e089f102ef950246c5ec63ff8 100644 GIT binary patch literal 46841 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 z∾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 literal 47193 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

%y4Q&}_ZkYZ%R>Q&QhP zKQ3>ttgkP#;EYx7tu2aHy95IR6Slv9{!{14AcJe3H8+1`WM!ANT*)wUnIfp7koQ|80Sp<)S@%R>>r;IQ6*WlJP|*R|hfJ zHmj^jOH>{QhD`c7BulC6CCH~7Rs(zc`Ji1hTQY+W9XgbCcgwxvTCT*ZDyzNK-_>kvVuJr)yz>84U#qdT?TNhY zo0E=mfkwMOM((?1JAe7V*CK~DZM<3t)=>NVo2re?o%dyqmXCarN~$jhAo+o_&jN%fBmEwt24)HeaGQU+&kG*xBWQ_N(gF{$3~5zxDZU zIg6@>_55{b*X8f+zv}R|T;cokm@T{l(qi7tR=hXrbL`ze^-rnfof5hHOO@*B$w`w= z{jm#@t52%^>$uV=$yW{3h)n(U+<*7d`o#5|8<%z~ZPmS&V-{YqhSh1!$&^pp+fvrd z%d7cyJ1_OG&h<8#z_>N`wd=GPBM+>~b?cRSy6c@oK!5IP!Fw z-2CZV&AYG9tM5I3t?t;w!|ofdZN9YBU;LPlgmX^Jn)iKTlK&U_|GghlCjY(8Z%;+l z<7V?!ySbG_Cr93u75Lcv{j_lh%bcH)pI7hZ4&pr2boj&${pKYzmb`k`)zLAf=$^<1 zqhh1j`rMDpp6KgNT?$&EHPg6#(ITaNKfg&I>yz}(^V9R+|7VN#vvuw7lLAgD_{rEG z>}u7ncy=*;g>YHxE{;)`r2ymen#7fodrwXeO%^ptohor z^33-?U*)dp#2^0kp4c{fTFZZklOY zFP8Z5*w#Zr`W{Q3rt0o|I7_CNzpFZ27uPL+#58i#@_c|`X&1oNhy-aIvW57YPf zs8xs7@Bee^`D;7%6G8uWo>NRz6uG%KUP0enefpR0ml-*>NtB+L^G0T0#CKNnyJeGC zSA-slI`1|AVC|2LpYBiNcKAZavsEt45jWnzbg)ZQdqwbazN1HvK6x&EbPKzh?E}+o zD^_$|^$y$oxqa@PiqpO8o*wU$dwlEJ^+zREC+!or6y~na&MYbvX887J7yI(do|m8b z?%j6#%cEs7wnbCkINv-H`S{$!?ZPl0*k~n$PJF#?cOPiG;GR7;aWnsNMQ_VbeDPwT zoT0vNZD;uZuUf6Gtr0q6c{`trU3b01sPx+9)3^G2%XaLTk#G0EZF_v}?9TslA|BdJ zIkU&=YhE9uf25?;=)<~3OGr}knmrOB}>KbDtox~dHmyf`|mvN+WGWd^p3h0 zUt3z+6W8YJ24@(}^fk%4#nGT9ZvODXL1&w?^T~hiSN~@}(CVvqB*p0C>;C@22Txw%s2jMa-MF=27%#mjmvHR!k`i}?kG#e)qNu3jbu$c+9P!LaLdrS{r>H(#f=eeUGx&d<*ItlRr3Y7_V7 z)qCxqd*5!nHh?SZ z-%Q`$-tyfljCt$*#yj(iFPb^zMCkCoGD-Nq@vqED`=Dp00cmqDy`BnMui)h3!gRVa z@W3Xw2u^N3<^3A>(|uC^ElquQXJ_iPR<`z{-)pxQ|6aSDdBRTX&3DY+?S5_dZujeb zMyI9YE(z?u`);GozEYd_`#!I`|Mv|4IdyZD>Cw^mydolI+b`Z0?x+6U z5TSGRuB_mEkO<$pMe**vp`0~kyXVe0Bk`;BLdDbrY1?l{rbaK_sHLP7)OxO)DJ;lG zNb-B?j(@iv_5QmAP8>=~NR|&0R^A>&#QlPekl03vXS@A z&V-Av+K>q+wUD-pP#vnS3rpSA@7}!6MxBu zJc+T)=Yn(&gP3K`w>;H7`0)29`5;5F2Sp9~_g6fdH)r{o#0hg2Dos0KxoEclxJ>kT zps`_Ph3eL3<@>hP-Y(}*c9&_srrJEZK&GDQrrpp>ai@G1}*|R6>o#)%o zO}VAk88Ar|(`QQW9335x96MI@-~c0ol9H0aOrNWFR^K}KvSiZq>Bk$H**kiBRW&qL z?AomY4UI=Z$y^Z(ot>Qw>y)O=iQc$zs+uvK@_wX(ZwZeae(%W!v`kD-?bIAw0>rgY}0+hGEkWt z8aCdpYK}#0A~$-jqXf1Q7qcp)NfEl)Pjp-EdFuoGxA#AvRCYZ{^Az8mI`*jgb6av7 zCPZ-LKj`cCadJ7w3tfS%vcW~|rTG8igL%)d&t1J^Num9PxyM|Wv>At&vqRnJqIJ3Y z{a*L;^K3mmJQS>~X8FyvnmBJ>+{3T@vQ|f0#p60oraU?^QTgeyfA|0Ym5<$BrfOxi z%jx6OTYDticp86wRn*~$+S0Hw`QdT-yM{AoPME_pabm*OLw~{g;c_bSF#qw~e{@qD6b4V}q-5eji}` z@$dJtCr=#8${u{PzVNG9?-m&3^G-xe0XuzgZSbbjQ^6)hc()lg-_9~i+&N4Nw+aRvnq&~lem3zSs ziC^E_TUdU)uYY(!amQP;0;|MpI*VnyS@ZUa{`BGB9HzXdO`F*|A3lYeQVondU*&#bK#rMo_Vsn8x~I>b zQ?s?5J7vlgqmO*;&3Ep^JbLu#RBrk2Z*M_9*nY3-^kRdsmzOU0GJc-EzoOpW?Anj- zpU*$sbo$OwZG*HNQIP}7eD7VqyHohzXZaVGp3W)Txe2mQ5ES>OQ86(xwZFb3{`>QD zU23-IvN@YKR!IP`F^KZCG_i+o%8FA{^ed> z^=HQ#oyWJrmR?=Ut*CgcdTDHNuc7FM%HkiF=O>(+Qhfcs7I;G*xc|TEMXn7~^PLrvd7s(fof*f5 zWcQziot>%aQK{+D`qF6=Vpk>~sWN8M*$P7KSwwhOLzpu>Pmj&bwzr+;{G z5VRA!__<%ymJG+=-`>W)U%qsyVbzz6OP4OaxWE5@=I!WBDV*wla|-tUd$oE!=!gnw zvz!H>MHQc9W2(Ly<;DJ7Utbw_WbcuQ%EwAKSd|*-UE5c`|M#}(@^u^w7Y4lAJ^f*c zl&fBST2-hqv^a5bSrX>q>8WUGITN($D*0PzRFu^AdsW)T>F1ujTD@NF^^-MAu`Ih- zF19j9ef^<&>}xIr8`iAR*|cfXjh)5npwSFfEv>F4OO{-YGr6aVvf$$3qwZer-TE;Z zcb0vs9TG`uM9}lw2|M;HD#@BM*&bZ58*-b*cMBYxO zsOZ7U}5s>u;?SZ+Y8cxNJ?B`nK9*5nIi84yRe~ls&|C@a2bnvb9@fQ<=OwR_Cv) z6%p#Xnq{=jf1+&m-K6)oFNWXV_wC|E0fU*ng`alIc6HajSB}rEzU|&Amebzs*C%W( zA}TEXc!}ep>OE19=c*jFK6t%e^La63vHjQGY$5*(kIekCbCV^rho4`caKST)-3uP| zw{qX@)rrZ_d41{V=EBui_nRGjS@Tl$`>*WlQm3P~f6Likn*IOwT$7V~|82`XX0-b1 z=DT{afAYWItG@eM-r_-A+$~@8pZDMSnpbWM-1O%F?nFTw$Naojo^S zvMhJDbUH4${GIaCj!(zu+xJV&Q9fnecY;yxK~ z!2-}q_8OVOFDC?(q|8)6d)_APmJHi`U=LeZ%97{DKD!re_5hF&`l;J?n7p5R*9}6B7q;v_dRJ=!bQ>&FV59F*?Rc4=$G!;)PW;>k?U;bNKGZq1 zie(X~k-uuUc;iW#v>bWR-f0$Cd;3WD2^EiX4NS8?{yI{pVUuK|zoF4qTqp3@>q*ZS zhL!Kx{ycrNU+LCZB^9wl(mSTRtId5mO;m8Aln3ZoCPBf84x%%cIQ4dPa9FhlKpXH` zJHOwn?w@B{J!!%OhmsPLxmKl0wzhlkl=8`1xy-k#&A72aapA&+CRtZHe!tt@zu3Kh z+U__}ZrpfbL8G;r=j1CcPfYCoehCJh=Wu0ZaA$9C z>bW_VD(dQ+3m?1P+M4~mRCe>tGY1-(D_^Z#?&0B)@ci6d&??5m?fk~||7zyXH%&am zg1&-1zTS4WS+0_X#)?h*lGZKZf>4w zl*(28?ajfQviUh?*tekWJkJz%cUS4o=kuy#)=Qh`o!R^S-f7U*?9K9)mX>=y9+Tel z_uK6+FD^1Sl;5jtck7h`oq1IC{avkD{O3K(V5w-%*=3KW>i_)tPBL1l=${n6Ev0&e zg@vO3dTM`v`*^SV{l%r;;`0q>o8=zL+kSaD`ZM@P&H&ds7yqP{f^vC8UI*8U5 zZ2PF(@^89PTRL{^u-H}pK2ELf*O!+v_H}a>I=9c;_V(f7c40xmgRJ5)py*$}|KG0j zH`c7tadL865xsrg@lU_LzMedF>eJ)qlY)`j;Bj7FT;9`k7A{!8&~W8SNE@$o*t1>1 zDDC3Cm$z9bALH5g^O^L$`v0|{)1KsNJ~;0G{j9{waHdb)dUd4vP|UWlLD3VBe)x29 z!9%C(rmOta4GkxTt&K7)c;JwBe%@K_^?MHe`}@20m>B9Z=l^H+&0s(@v~>mG8#6&C zkcjCFLOSa^|W*qmbv5|&t_$xdtrPOsdvDo zsi_H?|2Ds0a~aW?1x?+98nfEk-D}q96crW47)<>uH_p>OdskMQ+0qt^C9sTzIW}KaEZd~-l zoz?(eHjowh!D`@1c#`=m^}0vEgOjEgV7TUzt&X8O~0mzQ`7U(ak+J#^?0=oqEV zX=hgj%wL+sw5cI9BElmvF>&V8w9PXgJV@xbi1$$w7VCc6lk~Q%dM0DU&5aC-ii+tX z(IFu%haXy~Zxri3TAJQ+s!LZ-Z`qC=Kjs`^V`on`o4wlRTHf~Hm>8eLL`6qO$8{0y zhaCe0C!Q~BZfc4N{q6vtsE+>ieDkKHg@5L!KIM47k*~e^&>^S!A5RH}ic53Ye{Y{XN<7&!5DI;2H#j4i0|!_;VPWp@>|L*L#yrld>T7ytfdX;E?_~&>HoD8~n6Iuf!?NZ^hPmCngN@8b)#p#o{rw@)IIUP9O#4QT zUsrecsUuUj$O=Dx$86ErtNZAJ;+}1}TW6g(XI5voHcWm0|F|cc`PC+O{`ip~Wnxg| z;?pzth|7m>$yNKFcU(HYCViGaXoFo~=yAcPPecE%3*5Oe;G4ywJ$B*K8*~!({&>{g z(%L#T@*Ze9RkPvpGT+aZpfds91X|9uEM9he%DzidW;rKrY)p<_|Nrm%`sz9C(NRuL zOyBQSuYdhDd;Q*H2byvBK1t&?ZoM504f^|jG?`{!`_Z%a?Y7%7 z&o%RJZRxzaI{bH!tX++TZqycrgxA;B>O^lllYQsf+UT7xm(AYs<&rn!kB9B@5ql~& zo-bqPlQ|(89>aLx++1rUo_kAye}Xx_c{ zSlP=Gb`bIYEcnQ522e$OYb>#YKxKYf~EmOJbG zjcvKNjWRAM9PsEnZ}Yk5{EcgCqm5He2wZ>tDQT)Q&+=y-vAfHr?zW$z%rkYOGQ-o3 z$$w4?GBmUEvw&rWpqcq=Yoqrb3rp+!aaevG!vep#n=F;guU9mr_ubff z+Sq-{ktsI&U#*h6Q`9|C`P;kF=N-Y1i;8WFk2Es7^;wv%b9sI3olN1Aj`Ti@(z(-g z*FU)y-78c0XNR?W#cSu=+j3vtuNPowZ9OHZdg`>Gb@{s|pc7YKZ!K!+Q)c>T0h$}W zZ^{!|DHHfB;%}7MGpsK%hR)+!;V51&i?-PR@u&O-l}1wY0a-H@{p}%C&Hz+Eb3*ch7Z+YQMO;diwG7pIPCSPQm|I{}ws)w|{q2Ol1$WM|ZsEv)ick7GTiXxJ^Y*APX^C2Rz%6j2aJ%Zg3VsEZ zd!p^CT@w-}zpe}{km>sq{K(68yG4;zo(#ltGaon-*vqg<-I~yeHObT>Wf?w z6BV_?)+{K0e=n{-a;mbHx!9?H>n2W~?Cj*kWNB&X;_m)CX1x~c6U`PyMMXL3^?NMp zZ>`aY-~WU)E9a&BqFDmbR)JTqL`**E5)dGusHnK^f4~8cEK%9)MuBXjnOPw^A@|PL z=AIK&Og)vk{#Wdcn%{`<0X6=d9S;;khI!X7@FdWEU4CV75$N5_>SEu`cG8wv#- zDmM#W$0?C?9&FI;mZ*a=VR!dVSe3+Q{B37Phlj3s%w1W~zT%0+8b+Lxj29e8+hey; zo~vKtJaPO=rp7?6m;7~ZRLuf0MnCnu(h7cZ8)y3+aO%a@|-Kfm41m$a*~=#?^6vay*18bh3EoIdZ{=6~=1 z|Lb2DyIV+Bwihyjo__D++1ZIF1Xje$A3C(am0QAEtnSZ6*~v3GPo5NzdI{rU6xWABBpUVJaKapSS~%BrU)n|$7`fHWd+wB7{TOv32l-d2}(c3Tc?^pO^`*l;bA6|=Aw7R8Hb5#J6 zj;;jFoOxlB>XYZ;<^EaH+!tp3{JeU%{5)tgU(nK?$fc;ibrO2zY;QgO>M9<41awYN z_4~cyd5qbIS~wZjL~nn0W*?73oZOu{>o2d_y{GS*Zl22(9{coP_my_}L*L$RNar`n z$gE9-{L$?v}v7cJ1* zcieIbq|*aBi7NxP+;r)(<9gWp17Sam?f(BM7SoG45nFz@)bCf!I^=QlEe9^Wy4E^D z;IVDKn10*(eMV^&R}~=P4w`K4ojz&Op-HOV8X6i53Z|x06A!luiikWBoDN-Kx*>t_ z>#M7)18(21|8L98&i4eg)7G~7o6YlD{lhQURIEAqq_#Hy^!2sIe)=_UO?P~`Wc)UE zYXIm>QgClIYY+Nf$i|7v?o~&0P{+)Y( z`EFcU+O=O_kD0EYSATCuM>X$aL`YRUeE5(@&Su7yDW4zGVe!p*a|^d0s{beaZqMdTRk17K2VGB$0&QEIsvZ96+3ftPGyA-}y&qqT&QJaI z(@uMNY3UZN(z7ckJqkTP&$jZzLH5|!pyh6&o6FzFMQzPG zIz7JbWz@8(Q;$y5jfRbjr=FgsD`Qu)<59c{cvw7aT?->~!da;sTe%|3*%-56u{P?(T z#+*4aMn*<4>&11WjvQ=e_w@Ds8nN8Doo}7Q?z?_&Zfup6mFrU1@B5|o_SV+qH#asi z#8kiCx+VL1AHUs?1N-%j3lwU;Nk-@xB()Seet&ql*P6rb>l8s@kra`ghYl?$PM5F} zVdHJeynN^FnYrARl^@O+Us%xi+puCo{oj>oYRfOr*KQ772R%sQY#OMMvTL{Uqse#k zKu0Nld3~L~`)JVJyMiA*lS8wFdaoDjLl&|BdG)R{q;-SAi4zS=mb`k`$-?y%eB2hZ zzh^C|PxWHb%$Tb>J9b$=xcc$&vHu4|MWwh7s_*v-6ciC@xXJVI;k?{m+A2p@lrV{i zOS{*r3A?!LNdENc&u(i5iQKjpiSx327KMi@Lr%hYyccGqkoIJNo?3!)*E1R>}LUJ!ah8 zf3wAHwk_QW*_)Vp{C?z?*SA1>1@}V-#UUf4(1Tiz|D2-?*;DvlTyC8VW9T&HnBOOE z|FE82mR;PZVH>wsc8`|3#Gey_o*yS{yxH=0!p8aE(`Q;dvI}Oqt@t=T+vY|ei{k{= z)uK6O>O0%HJ6An!nP31J=P_)(!Dn^n^^~~(0#D?O1w)U&{2A9I8Qpg=ezj=M?@zru zb_g6u*&>^FJZk$6pXz(J+9sc03>s2T*gUtV`;_^$jV%)MGn?-ymn~B2+Pf`0?{?ur z_3g|F`Uj+*ADNcS2V_lCc5Pin2_ecI!a(=(aP_i*fO^ObRSGV7OGJ}Q}_%(MKBa(G;CZ|U(D<-Ct~ z_9^$IHcn9Xl4o{t*LHXKD(^nWbH4U$(xZ_ig0X`WLa|!rc>xT90kgi?xy7 z9`!d{c+R=$aYgI*m#y8n269NtxBYiLC*OIUe>+WQbCm7vx0jCoFMGfD`rdzy%dlhdVDPxH$Z=_aC%(YFlox{%n(z|3QbXY|Xw4I>P0DnfKephYo=^ z5q`D(_ouevHaI##F?jpO=kE`5<$p@m|FeNa@BH>6m!H2^m^|e;9Qll+zjldC;J+WA zpD&boSS_#V9+KGy*^D<;nZ)y1E||g=gSx0JV0~t~q3r#)_fiqyG48KyZ??qkzI(2I zn%+|X^>Gm;Tnm?dbvp2jWA|M@$a>6Ui-I|LXZ?C#rdM?2qisOJr#;L5=xEq5B`O}X z)7s#eD9Ccu>7yVAXIp^w6Zw|K?FWO7N1U(Y(J9@)em(X0_Ww(-s;=G8a=m!Fv{b&0 z`E%!po{Pse-ai<}BFK5*;^e}x6Zc+ctuMK~&dh6j_@_HFna|m5aB&QXJ#m(4GiQ>N z)P2SUJNh>E+2>wg$=|1(aGteTMS!=pUD4*qi|j^TKM^O7IrX{h?2aLeHr6@viOm1= zbF+xleZ?zWmcI`?G`Yse(b>Ae<$E1>Z~F3$}4R;i!(2dwF`g^v%^*>n^eCfyJS?0Eb_{-%BTlE*Fsc|H?v1p}6I^;c7oclaSBvrJzTq#4^9$qNHqV zKF_|X`EK*`D`w~20w#Pn^WvXpoM={^zx_*sy|CKk?`3~?ZkwTh?-nm_srr=Sn|U4` zzuRB?fDdT;{(AL~gMw07Uv_?}_-y*`4>T2gK$!*u9YvD+z2>wa;uMmimT1+d9P59t z*!HyJ@yrjN)&+BBYqvxG@Rv3}=O`RC4kD>!7` zCA2V(gv^wXg^@0v2Ye^aYX5Nr*kcqXKvJkCIJnSXhmdEK9i zTif&fGcq*7V+vd2=f5nmdU<=hzS`u@@AvEfpRv-@gAANMcS%#bk@N04WZ3-kq^Du4 zKiZg!FY=rBGwjozyx1RKE-(A@$N0+n_tkSJU0-_NI`+0`?DA#XVlS3@9XaOI%=Yf7 zr`7BL7niJ^_*&^dW6r-UF{=8K0XpQp{C@58>*@PG9O9ngvuyL*U2`B!#yMNh_+;D^ z`tPc>B;lo=UA#MDFq4hN*b}uK6~ue*6i5Rn>KIu^!Ha+ zRbA?{=kP-XbMxstcI+s=H+|0@n>K#=bKd%UU6PU>S?2$*S&C@I!P~o^pYNWAYXJQ7 zKAR5*m}831n)1k4e3-Mn)(+7J&Dt|%iU{cRX-7v!hLtN<@<^NYELfn>zXRn+kb9PI z53|eH98jNMbBJ4iPl4ZUQFwY^BIe=eckE%ohN7ol-`?Cj+{P;{VOg}q{S54w!W{*Q zwpCv&p4Wm-9R2b0`TWk_UR4W=84nU3UwUkQuR=L?cbV<;`Q>&ONnFBFzx2z)i|+EN zXJ#16oxZgt^Kg%(v4@}Ex+&*v;#a`7!76Qa^77(3dGaJ^bD!Mi^_MPP0-bdXx~d~Q zzScA{GO{7?OIK$nW5UZzOMT{8Oq8`Q+i~so&SLfBeX`2h+TFtHexL)H8KSo5`FeP8 zpq+*RI-FiS&)>^yQRd}kQ-7Szwnqd^*o$jxr3(uSQ&LjEyK+9=+?*a95^`im;bRH& zygAuFLFabg*;&j8T1&62e0cF*!{lQd>i$+;e_i(W7UPH4>-S$;;wk*5%vw@X^2yVu zp^vr;L3#@37*~rPI-~%a-ckC;#clj;en*E#u7HThk$ttlPwB*O&%2v>UDh;9WU*WC zr|i9IzOx>bSe@>*y!$)IkTLRrmX6MmmnBI?GZ{3%&r9>_ACI5#(^e6?uZ|GR#9 zdPk12F{>37FZ7$6^y*q^!H*4`n=OB&$S>G&!>`6h#!|>9Z(ZjKjgD^ZXAd0N)h2gV zeQomp#+a1+R<4%8qH4>G6DKy+S`-}UyUh9Z6>H&(2|rWhWv;A^KJ)N!f?4#bFN)UI z9m&VfxVSc6eyO0oe8vim74i2Uy>h<0t1QRNV0N>Ihe7gY$GmmT9UVzNY8G{OoI<92 zw_`YR+*(7=Ea~xMU6YJ}Pj|aKd`bdh);#8@PwwvO^80PPTxQ|pj#u}-gU>51`@2q% z;jxS5qCYntJxb!@=GM;j(RBYI9)0P#gU|%>hjvnOGUJa|tJiz@`!DyMZN?*Kb3@d+_?geAPoH*xCi}LZyt65l z8#FwZdU_g_!=2(y9VOH@Nh6CGjZ-b7D5sxhq+v4}C z9BjT*c01Q3^Abw~=q?#nZZXifh+Dth+pf9R<$Axry-oh{;o+8yi%bT~WcPhOXMJUT z{QTYT_uUqqJ!{sfcXxLq2Cv_4zdyq`ov*O4@Xycl^<_u(Vs=cJU-zrCk(s^dsAxDt z!Gi;gY3JwphJ=Xl+x=LeUH0sPbROs@#RYi=&0*mB`+WC+U(@$$avoFw+@59&Bqq) zPS_YdXePc7azn{-FH8dXV`~6PY&Q7kucedHas;^m~J7*>+I>&6>oOV{p z+e<=m-)A)KNJ` zG3h`5e!uULv7D54b{6BYomVn5Gfi@COxT!wd{+|aC~;81eAfKF&+4$X3@6T*6sgSb-k5`U(V)) z_WC_eE-oznHlI4QzcusQfhHopyt_Ml_4<8M2Fos=n`0^5ee@9M=%=pOty!Y8&GVn_ zdcE%Pt?c!z3i|r}nU|L_8f0El34b%oH2cPmLgo5DkL6$9+iRVma(q&)ec>aQ>-A2c zLk#!-|EnJ!TPj-n>r3I*K%w6s4)bffhZwlOxwW-B^YSuH_mILq&}L=Jnjar3rz!^p zpMKWCZ>KR^xli7_$R%%GdSArWSIJW5|GKv2@?YAV?$5x*z4v)Xzr9(J%j;|5g|FAX zlll04zdvij8Hw_~A76ssTPD4_@*F(jQ1kI<_@7VSH)THFDb}BIQgF7Jq~)T-!_#`? z-=7oI-}52APwwo)XS45GKHB|$&-0Gy@pZkiyKRb(^vSyQb@b-Ccy(F3@A-Bs20Te| z-hOxS5oZ1!#YgV!bnAO@_x4<6BjdZ4kFG`EwM_a~BkL~ld*36=q|eXJ=G@&Sy8G_A zv*!2TbcOaAys%Iz=u-yWjc{#k^v}QF?}KOMH~xxsJ}%feLm4!0(kE*@MVaYId2g`) zQXZCPuiiCuK!Hc4&p8Gw$nDg#W@3Sp@!~(jeDSm(5y8V6Zr}nL1YkBCp z9oLpZp$tnUd;9sI%ZIk-#~(U;`1IX(TPx?huu%F??BeLis2#p;iT`{%7Z;Z~fxAx$ zTJ^2yk_n86IMF4l{o?NK?b**R@60d{_*T2%S;wcO;-VrC4-W-(_2Z_(8+Wm$FrH4^ zymMK67mL#FyXRJgu6}WS{ruznyF3#pQIw)&mS|F3f%*~XZZywH)kyk?Tx%Fd1s57QrCF8jZ{xmi7Uxu2?;*)+@IXP}FQ zj`d1sUSBu&{MR{t>Wkg`(;gq|t@(bpT=dtPZ*Ol;o;1lRC`hQCUq0>AlaruS8(;r- z>VgFeioZ@hXAK^sowF3$qF=pRy-`<($H*w;h>)P*#NzyKL@h1fbBF0#xBfnk0|%Sg zwPOzK`h3nh_WW#<%tOKcwyw9g<=)(yEe<*&?RmDRCb%#7MCWFXR$Qn{-M;E?pp4(pOal-R}|* z5WwJoRxSK{x0S8G~JZc)WSzcIJZHL<#FOT0}7rKEpOaJTv=xvP?qZUSQ&pUGT=){Q=4|WJD$DB?-KhHNX zQ1J1w-sC$w3fDaa4V4!^KgX(|4qlPc{|(f7`t|j7?E2eVv)K=<-~Z2RvYPJ(*isaB zhlmIXX|tRMt>SSC*4DFseSHlIz)v^R=ZD_5(vO5>$4pxT5U0J??NDZ|rh5F)^{Etx=W#|9(IHcg`#Yf!|q0YyoQ4RbMm= z4GnF6y;$7R+8SD3?&9L2_2$IHj8C7G7%a-x@csOG?0<4)P=4Ai;`SZ```TxNSD_^{L^^Q+q zfiY+pC2Q7=8;iBhffRLwOlp|ZxHbR2-J{2kSMRn~vb*`V40iHx_fqf(_pw!1RHW9! zN_H*N)?--@EUUg~aB_0aYAm%Df)I{xaTkH&_b z@$+wBKYs^2QEFEz3*R_oHG6I4y}&%k^&4D}Ybluh6|SW)Z36W-O)q@(iMS^u^YiN6 z$p;ennxF89ZUhy&F6S5__k(72GR^J^UuyZuHhnR8a^Zv|xPS&LqDnntY3{T(fp7J@ zI2OL*85<#cN}sG@1+T7LGOfd>=?Ra-;p@-m^FN=`UVi~}lEl1KFt72ofcYiejL$iBWV^j7~ZH^{nI&^3-1A3b{X;_`C-&(F`7>qc+M z5G*V#EO~!#uh;KQ2?v?Fy1F|0`_)ZMrhty3TIxOh(wfN4T5sKRktYSQZUzdy)eq`i zzIl^#ZB69i>+$txoB8cdOi*;bv8yzD>bJ$)F2YC8mmKqk4+dG4yg1OtD_!yL=kwKD z_(As?f{t9ey)F0gC2xJ!1-ZAk<=oiN2)e&%&#zajLvPK$<%00b$3uq?gDz=XxpL*3 zJ3A*s)-(Rrdg~k)C)aSi^$BBBQ&WM3Oz5rYx7?OPwnKJwc&wc;Y0{xnQ?)BUpEZ}X zELw8BI(l19;^}F+GS+21&FuV}QcsJ4mT6VhgXR~ruAWMsJJ-4#B)VzSCX2#HEvtJE z9dcs$_U^9t>aew-3#}M4uC5XlkFPNV9j+Q*_fr+*577F@#r<|k7Zx~9{rxoC@+_{p z!RB7}^>uS!|6Jxf8#JTZD{Y>3eO)XA^f1zm=VlltN9?bwooQD0_iOkplgy^OdFsl_ zhfP19O4_&~>#7#$lB`LSCtH@ikpQ^?bgNkW{<^6jr=FLFR0`O5+W2^h*0;Ym`zEit^?j?Q`;?y0%{OC~S{};cRn+16 z^jT0rhv(5F84)qIXBM1OWCA}GhhH*($|39its-eGtPVN{{8K3@zH7b-2IkszVp^D=?I5gkHo{k{vSUc_t(Dredv&rlzCpv zvb)QCXM^sA?Y}YUA4^o<2T|&dfUF2#FPGpWAG0xuRX2KD%8d<)>u!J&=#wW;4ARa> z=-T<>0v+hS?RMT`&&g^GpcCCe+10IA3bfrU z{LP)6#W%O-%O7s%U+&s1))2V0_W9g$(9NLb_iMLno0*zUy}P@-__DA0PQ5?hZs+ee zOg|^{=+UDepXdL7(-pg;K+*p17h%v^f-dcK3=a-8GJ{H^6)QAAOO34> z?eA|(laKc?fUc399#_?Q;X(i?^@P9a64n0k?RGxsh_SiWeAfPjDlo6p;EOOz*Scv^t&@||D*&l0u<@MH7mGsfo`K3w1bZ|a5( z1`ME<;IFT*cYZph{qp|){jWdItNj)!!^aM~`tjn$iwvME@76?aZrhf7yUOP*Xt^WO z0Eoe=x2wa~FDre0jYrbxh^Te;HJzg3;+?P8?e_5TVF3*(fR0Ric6N4k$cOSbHx8EH zuRZ>D`+dKlARz|(KOdO8#r2mJK0ekXWqL~V_c7`G55M2<2Q47JzBai0-5t-UC@EfP zvy?YCHmkd*WU-t z{5N)$YJ(1vd$oE!ThD&CGk69-dOq)4?mL_9z!J~NF&ne5tx0@*toP5y{`!);r>^B~ z-~H|Hkxt>*|D0>1xA*=3_kBO;3c)WgFCV|^=K1C@zx^7Sz=JXyv#;wd^PL^0YpJBn zoMZMl{pV?YNa(%%BTka&O0Z zG_y^gJe#}pl?dowCr3w(zrX%=vhg}?xS8<$-25Bc-&;R=99{5oY3_!o-t)g7H2ZUK zo_u~xdUw&EiX$iAPdqq1{-4j`Ht`Eu&gcepYCbo%V+(V(o^Ei|R7Aua-n_*Y51HPynVfAN{Z0i+vNwcOt+n1 zKEICPP5OZbMw5&S468+pit8WDOrN4$^R#1Y_VrDrufrBCTJ+-PX7vT2anS=deK+=0 z8b@!>JDRt>7!<2Xe=T7nK^yv%OJo>B;`(mvtu~L|p7-?o{rczgs^1kJ)pBR~_g?CG zavvzVtjpd6^l?mh+!36$I;Ixx5Z_b%y8d zev2}Ezi;0$X}7ex%A1Fu&+lIpygZ@ms}bL{u5Ly3;~jh7?>jfg=3UC&U3=HW@9))K z&$GDxzuCI;wpCy1EoAuG`2H%Z_gnwG|37EO+4zgwauu7|ww50K_j&&PIW`~mbp5D! z?69=*GxM6bzgJH(pI;rjasU5)t#|Ik9P8OR<;W2UhHW{PM>eJ2&bYUyK~ULhM-spM zy|WJww`X2HcJAb3zkUDz#pHy7T4EDF_n(Y3x~|J0V_P+4#taG2#dAqXNe;em*JNHc zHC?;CX!+M$Z_C2gL^!UG+snbvzkcImm*D@|^?e$)VTTVLnxbs-)&9Y^+Lt##^Bz@S zvwnSj{ruPKiUn_e-Z9Rh%XgQ;`-KQrdDiedR?7E}1b=t92uu&kkd6RzmD2Q$- z;aYg&=er6uoqSHd*v#E#n;62GYNF4|Y9=Bz;E(7(1C6VNYzDR8gGyz7zPlL>YI-Uu zi9)6l!F?4L6Zqthi^>9UgBhZT(HGvb5#-E(clA3w9MGHp&v!$&MiuQdXqQa(1NRJ$ z@Pl_GtW2BeIbjYXtJ&kPoqq!=j#R`YFoRAD?OEjP*|YumzhjP9*A&m&o?9;R`R%v+ z8P%T3I(?5r@5{rxFHR8CHXQ)^?cMOUq8Ocwfo#V?>Wyw_letpw@2Mf1kdxn`|dR@dTr|b=g&a1AK&*J z1vz!!_ShJn{eR0C_y1u!-XES{&ybY7@ZibKoZi#aGe6A-1!>5prY0sKA)$&tACJ#8 zOm=I%UTifNbnSgF^nyRLeSwSJ-rV1RKl$eWzxV%tTwnjUdtdGEUw88hK|vdXXwaY7 znasFu%{#vzB4TWkl3Gci{@00{Gi|HQf|vOuo}Xts+k!a#K6ukw`1?NU%Q>>#wS+B1z^PPQTQ!01)okI7mUl(qJ%d17gMxx0Hl=W~va&KPS+>k5=Y~O3Q`4%Y_Ue9f68`=9 zIjgp`kI;b5>b3UW;`(a(`u)-Qd$->D6)^jS(mO~3Rzg0o^5)KBb={~fpj)P|UYifP zTbz-Z4Ri}yZtV(RP}GCG;o_3jI%SGT*t(dLv-9^wrhU5#TBx@vmHT*~ENH?g=jNu? zx3{eYkt3GGPmB2hPb^|b5E}?kK;bU6qcB%=(k*W@<|ql!a~EN zM~}`po7U9aZ2O2oN9?p^@7CLIE#~?)H8&g1?)A)~u%Z3r%HPbbP7xAMo+}5bLXLYZ zw91a}<7k=xyLhhhDy3~H)ziM{27KGwr+hA_{@S<49g7w%x}5j@mW|&kW%nP}ep8fX zM8w6Dx8I(s%#<)k!+nZ;GxS#^z^VisQ>?4KKuGQ z&|ZHY34;To=DD{_-jrE`t`{~l6Khz%?^oBCFD19OWFCHSusL?4ar!wGef|FGcRSmw zzP@5S_T`|ccG!hYsorh8($Bj7e&7G!*UyhH`B=}xCT=~3gxlM4bz*l->DJrT5uLa5 zsOaxo+3O2GJaEk0{nl)jNhZ^Qe*1qXnpn9ruB;GT?A~8?^xRzQ>9xPV8P@zLh}x3D zC=q%av@sDhkoNs<`R=6P;NY8ktIf^tmIzOetI}lH|M#18@v}3EdU}2K|9_reccYbC z{L^KBd(fV{bvqt$G4RP)9C&kcb7xoAql4`7B}YMb;=aAT9dz+1X#30o&=smLmrm#4 z<$Ze5UB2|_x`>TU`TPG)gPs)0P*hwz(=eGWZSzd^`8AhBXV05=?s|N^?{vM`7q_-* zGqAF<+WdaAnE`aZ?YfrFACJp_{`q|V<(0we;ik797JMMLjSbp|6aMD&d3%3HN5=1W z%jG|Q{MZnf8^5>8bZzwZv=b8)*WHNRoHlXx?9;L3cU_Z`lt8CRfKF90$-j4JanpX> z(~N0XRs^oQ0m|$5>;KQ4sO)}eO{DRG89}qAO>={uQmOsz?e_os_g3?Fue$Tw{$H8} z?+cED3o@dw=oo5$4hj3F&EHvZ;*`3+@0XK&@3zEd#%{Haf4BVam+bBG<#AcNi^8Yv z&UHVnUhfg5Hfx(Ld)KVV)3`V_nyq@24l}&|e*A<&CL7mbsULgRoj#p-_WQo;d(&!n zM%L}U{>b*zr%#{-74<)}^78b!#r0Ga6&u;*Yc9zDe%LM#irB*AvgH@R(|=rC6|dKB z@96AIJk}%m@5a$?@y7)g5~f*G{@Z<6v`8tg{%`4`#fw4d+{25ho!RbRg=qD+H;R@& z)oyLwEz@x6l5owpn^I2Bhj+YQCo;#+uQykFcbV*?N8S3*SFPTau-&c@AGR>t+19@bvrj)%sRA}|EUA`SH3^_!GU=eb03r) zZsUy?l6?7WR(6}PsA%t9zUXallE1%u@9DSg^3u~=cic_beDHew`X@g=3b66-YtxIp z^`OKlE>7?Fx7=l=ul>Hfyv)B_c8*`f#w6Lcz(Xe{UJs0vWIu3n^3FApo11@BSRZbW ze=UD_TkidWKR*hqzU-K{WJ&ji+lkN5Ic?gsZ*lVRjCDJb7X1Glx$8@GSJ$Z>58JeN z{`pj9G50}<*v9PZ<}Gd8QV%rze=L94{C>{TEnfuoR()L*x|(mf-F&5K`uBZGO0Gb9AG_9(>%A_~OFCe}*~t_w^u%%(gq2Ma)&AFeHOepQ zRzdx|Cr@jS@2ma2i&>_3G;I&3SjNetm!MpOv+0fB&l+ z$K~r|t_$w!%h+NGov+vvr~mj^@8{!LeIGK{SSCF^H8tnXj)~IwdnPJ6w=v98uFLMT zD0l#>!ep#UIx;UW`y!5;upQof96vW^Y&_X27cQT?yLVhKYhK<9=Sb_{qOJXN~T-e_xC3s zzs6{gcjxS!Uo#Jx-xm=S+cxvwUTq26UCZsi{r`7gw_zKE&$M z+GuNrx<4CR>i=dRUn#Hk|G2!g@Z{oGhc*j`$2`>bdireMlN%e)f@W~0l^HX{>F@cq zs(I2Rp}gH|nfF%xOycJDo@rliY&N_1kSb)OP2C}Kdu)Y)^K)P^Xqlp z%l+l=Z`)+ltiNB!5!7gLd9uAl;%fF?p9M>nw9J?x@#*ttPahwXtC!9tM6X+!y0>@t zn(ME>P6A)N%oP|I=r~(F>eu~0&pR#`U(MQ@)py}i{pGp8FDLuYvpFdqUjwSj|NOVk zn^t^3=6OfFwR_rW;mv0SQ&Uqxi_dC)6f9b_=-khp=Fe>|mbUzS&e4DT@TSz$9=^V+ zR#w0E{JJW$@O6j78NsJdpDtOx+&Jfk!T(ds+g@DPd46wA@sXWLv3la1oSZvi^!|Gt zS(bK+Y1-wNU-b8j7%H#7?(GJ?c4@`e-aIb#qJzb+_N|@F8c=uU`>n?;>!lCn3S_SD z{Q2~Cmf%K#tNYTbS1)nsiIbYKvN-gK_>}cRI#X7|@U!69`G&!a-rEJbOw`qj9{yK# z4rR7)y_?h;EemO_cXW76-eB^T!DR_!Uu^aId{9eXP;jD}z_lyP0u$M;XmRG1 zHXMKX`&SC%6#374zgZl7-BvJry+o+&=hN4(DkUkdsy+KH%(Kyg398e0MT6?4J6pVh zHhMxVpCx+NNdwxlJ{#re$SADlqhM(%*?sg-kEHRdD|x@Zy!`U^_Vg1cJU|ytKmWTn ze*e6K&Fq&~g=!}yCrersD5(3-v)O-;dx2<#(%GmyJq!Q4vJn9c$NR4C3Ez7+&;Ik) z+q`D8-)A@6h{(9VPfg8}dk@%Zm5vG+j0*lU6fkHy^v{|hw;?e+$T>4gk9V4H)`#J0`O8< zB_*Y2hV}ny;wm1pe){w&OSH?aU+%1{c_x3cTG@3x? zsjXbOa?k&NzyIaVuldATSXjs-X{3_y_{YoT^BI0zp8xO26wTm>eKnS#W7kehP<(T9 zvwFhgj6QhknYaM7$7}igx~}7o851rpa_y0~pLgNHg@)dRt5$I}u*+36fZDhB_EsBL zf6JLPdGhPh*Nf(O!c!$@73dtW(9lrOsOFwMHrLk0o<7nk%xu;6ZF$}A(0)1Ftla&7 zKAk>!_AKvZz-y(H4Z+dKK@rc|AX4G(&*hTpt-GbKH}_|K2R zuCA^V=gxtqBmRA#t`q6>{oUQ{tv7d<>)*V2Q$$Rx=+hI=dikeMpEAhUR7`kxclYMZ z%W4cxPEHk%I@M=bm+N(l>!-cHx7X(XpU-dZ?VbJm-R|`h`}b8|=7Ox75fsc616`LF z6C=ad-pnbicBN{4`TKkSu7d{T{(ir|Jb1a^oBR9a8K$2uJ$7p4@Av!Xn`U2|a}iWg zzqqs0IBvao`(ek-%$4?O$9g2EOr84i#p3>=Cnp5g?faFr@7F8sU1e`?U1-0(2$Z#a zZoW;}>J%Ay_*?eYU%$k_xz2F*g$n_nK7T&{YhI$n^BimF>0jBmUtL{&{^qjc=jYPj zeqXtK-lLVv=UJskuaplK+i>diX+xgo2@?buw6wKXu32*=X`_IcSeQ1Sf{o1{$K<_n z`fZ5(B7M=@Lj!R^xw*`{66=O&9j1EyVuHXo;hPvgK7D@n0eLj zETgt&u^!ldzs@@?O>J-W_p~oBF8FJ2__3{kGp`*q5E0qzYPR`0#K$ zXgLN`!IKk$akXDVm6VmULpv^CzI=0At~6*mo0*M=;lSH6P_EYz<34Zye~&$A(J5#s zV|M<&nT^csObB(4g-vTr<%HVJJQzdM* zXai`#JMFC0udlC*KS(b;M?)qSGim2` zK2{S@%Y06;OIVngrKM%X-ne7E($D*^$~?RrQQWdl*^2q=Y-K(f3kN?xzIHy@q+44u z|3#b?+|_6BSZ3nn$%o(F-EHbVDz;5HOf8GgSHctmWd_(x#qioF(fF+$;XH1 z=g*%iYHDV?Rjchq|F?W@5%ylu>b$hwBCL$(utCADxjRnZ-O~9j^!r^o^RmHo za^=^gnm1qR3``V|m-XMce8z+c6O4}uByq0%S)=smoJ4bAsz82kyTFE)sE)12F6}F= zzOP#p__3t(baWOfB8}p6cp6a)s%vuiLo%`Kqf~S1;A;{x!e5 z)86*mlarG{Q<0#^?e^IY(RDOl`A2O7B4=(Ivx~B97jO6rhxYS9d6_OyuK!@qwZ|cyR%mAbF{BL zEt)uCLc{5&pVqtNWG&N4u$=4n|I_JbO4p})e_DNVN~p;P;jK##Mjl>cAy+g(Wb&8Q zhH>ks_w?|%^+*K1mX1A=Gi9}q53WWrTgT=rD<6eU&{(Z;IPz7_t3=T7ct=Oa2~E&w zK9sW(Y0hEUGWa&3ju}V?O(bRE))3ZkWAWRF!)ttPc~&xK&k(KNvUg>>A~XRmZ!!JK z5Y@G0hKdZoWx+HnMh%O&0~)TGtrFUe|GhjyYlthu7B;dp1<#`*}S%Q zyQ9{aPW!g@_V4ZLM^&!=SApKV=CL?{QM+MM(xeaxK`2JD;aYy zlclBI{LBuhf+uTAxM2tBn`E=Hvii(0XngV{MMsR=IPJ`e;N34TF9(f!Dk&?!yt+Dk z?kye}iwP4ZOo*yK)-PZGuUXtdd&82}(`Q+iZ+`Z=iOHhu%=cYYyYIfMep}Z3_KIw^ zp7@hzWe1-&Eq2d7{x@p&tLy3A*3q+f9lN^qeb&Z}7xvYj{ibr)7t$3vJLmXgMMcF% z&~4T?H>Y3UIX6)PRMmrqLf+oqetqZNDVo6*4_n3m#Jjt?Ud`T9q$avy$I65s;H@5vy7{oou@cO?DR{U`;S6D2Zn`Jv(5r1 zC=UZE>oOg`<&)2x@%g`Pv3vifq@!GyE?r`>o9Egsmbm>kXuVs-pO422ci&}{cP?Hm z3OT-9NlEC+qeqWCe0`t({eD0F!~{i#nolRyj~qSvb3fmdEn7@>mArIHN>Z{ed-LGs z^7(1Ex8>G+y&BFa>t2jlq{Xs#%NCQm|G)2lzLmXRP*U>bBG+yS`#PJ23l}oV9-pEa z{AWGrh$hgL=b#ou`TbhZVqzw%Y0q4?!xu_j*!}fd^vYGMl5TEFee(1vXupt}-<%s) z4lnYbZ`ab^zB&E;yk&A;0f^>2XH{TeV2`A6n`^h&#`5=Zpd*6s@2j0%74hcIPT}>} zy??)oXV-u3N~^9%-Jg%{p#CLj1@FJVzfYbxk?`im#xL*g&Sqq0Gx>DUJU^-twoLf! zp$7+>JG;9NKP)gvJk%2P{_DHDxBpkYzP1+B0R-*l`TP4j^Mj(D1r{<}Z{4Z?|94H~ z=4U;2pvm&*=jMK_+G`=h=jH9q*wNAP;Pv|bY3Jrxf=(0cleIP~dg76GZjR)K^g>f} ztpv~R)a}hzxl&VoZ6_^D-ulaq9bA}Ae5PPxGUd;oKb!ZZOB}Pj?KjV6=E=$G*KcjB z`ueJP+sivUi`Uj!m%WKt{XmuX_!QPPpFS1w99B?KVQDyZ%1cXIdt-!7OKa=ZE@lpX z{`?CO>#uhwO0=}LCT{%kZqu4os}?O<)HGp&z@fv3eMO@K106#{MHeny_^&Gu*74Yv zRhWEa-rM5!{yE8WejhpFRrYR6!J7!*H|OoEEvv4WzZ4b!ZTEf04zI4RRTgzNEi)wI z*PMR(^gv@QkHiEYPfr#_MX@(!8d|Fsty(3tTeeS*_xM}3*}SV(?U^#g!N*5~lT&Pt zpFxk7-mVpsl-&;`aURcOUw-*|`Ri*Jw&k9cc=UL+Ma>SO2Jqna!MANMGVZ5`MM-s? zE&FEJu-+pyGO{sI;>gj+9X}pj2>vUjqE@A;pTDQLeqp81iub>t*|>*G}TNUP;@kE%tfW)F<>crv%r?(YJK7}*T7=UhX?#rHI{lmsXx!H< zS1R}RHrAT&`xQL1t(RfgSI=> zznPuC&oeMku>5|lIcP1`gLe742ZN&1V+UY|T^64Q@; zg>h9cRT<{heDYiqrp=IjeO)T(YRlKx`zI>9|N8#@(`o(S(9olc`|Z4Do8^Kx(`kpV z1D%ro?Az`9@5lFjI;CAtFMRFL`pt+`d9z^onn4ZPfvz7cYfM}Cb#w03143B|Lr?y z!B}umQAc$CT#xJPV*Q_NW_DC3>tN;J?-`|}&F*_!- zw6I*dB=_a`zVG+iL1+KnDLgLw<;_juhGuqd(4^9ah@=^Y$!+%E4)cR1m3DkO75L@l zbXd>?d|&oxfxd-(97&F3@5|8Dg3 z@NC+&Nx~#U05o06uypCtGqX&&8)h1(|4I&D7jyDhuk_B3$D}2VQckQqf9bXTcYpi8 zTmH9Scy)Dk$r1gmgS>^?Agyc`0Z_q`!qB@oE0=Q-1@xZXm@S#krjc9|L|MuYH2z4ex za)%8%dOMaT&+gN$id=vFwW=-X-UyLJixx$l*%YVy*Zlm?HQ8@o?#$X6we?H9_kZ8= zcmDmhm7i4NYd*3nyY+nd|9(g0x!U5n%5`sLX6pK%F>{|Xbt-80$%luBJG;89oC(lcD>R>C-3An|E$Q;^9Bq^Q9KWZ=O@V z`JCYMuF{<`Dk>@uigy0d7MwjxlRLt1`Q`n8Htjr7`gGEtETdG>ga3~dWX}*i?#wqS zY0|7J4c}w0zfOYed&#O@+&!bWD72~bQ)p9b5e#3gS@qgDO)KH0*dd0(X;!mcKXNTt zvxp~sNZlWFyvISS#%_lga*1fbitm+}rPQt&M8D%hzwi^z^Ce`{`2; zJ~>%%HB>;1ZTtPYy5!8Hs7BRg6K8Y#-JjbdB6473^1kbS>O1ZxZ2q}Ve0B1yGfC_$Xw_3k2a9R{anON_puNtU)6cIfwmxhCS_^w~N1^iV?fL)D z{`m8!=F{iTp!rSPsxP25$3AndrvCX;Bc>l0v)^&~^27Ci*mH z@cSm(cJ@dXYr8Xav!$RhX>IknToK`Mm8$dSg{i!{wN)FmN=sPXZ^@!XO&c~?O-uCh zemJi>;Rr{>rX^|B)AcUwuRq(>ufM+~cDI5)zg5YH+~2qF*J!Vcs}a1l<>T5jRewwG zSKqITzHD~lg_x5e>+;JrN3}onuBI5|7dPO(u{ zRRwJg2i2U#&(8cZHS5`Rysc%<-oH1uu^S@X^5SmQ>$M@Fp&N5<8h!foDPnh-uCTga z&ZLby?&bvr2WQ^hW$HamN72S+Pn~SZ>u0~KzrQO!uBtX~=cQLK0zXupkC`d@1ZlQJ zTvYTZXn(_&3_UsOZGGbI-1e-Tmjie&nW>cl#@zUAecn`sBHD%QkG7Fj?LI*KZAdef9?r z4mOv(zc<%+wi)BTso|QMnsY1)n?NhXCruLK;^x-W(OI%-)24UqmsW}H`6{Lp&9>P6 z@TsXA>g{uGKC0gE`^w6FJEn-dxX7&L+q6dK$FJ;)KZP@lj((TsSpD`E>&=@5PdIkO z?7M#RW~qEX=at8TKfuKtXo}3V;zPotM~@0DWPD~AEWB2|xBC0H{r7g2YQNwA-)^o| zY103He;eL!XSI^)i^_es|9{=JHIc<`^1r{mU0nS9T*clv89w%q8F?ez^btZ8siw; z`diA7iBHDj@8J)BW9O&mni`63I3n_}kQczH` z+)jwS9e>1vMK`QkJtc4Z?tlI-rY{hee*K&IL-*8azN?lzIg=Z=e)^?LL0(>7Q&uNs zoeJetI~C3;b}AHxKWkck<$uT)>s!|76M8^PPmgVZ_jEm98_*6bP@OPw+S#{d!otFr zuN-FZ2|Li$-Oa3EZvK6b-Gc0OJKN6AHaD-Dy)5Ip$nPA^WZU~?s;a6bZ*EN7v&ZJv zoPV=rr3&{S{B+agsGaGxcyXVdRf@UIOJjrI7|%FXrTBAIOzw>`-;L)Jq*fPQwRt-$ zY5qZzu&1jkZ7AEY3E4nss@5c2_Oi<%rdq;j{Na92cb8HCEtXk`l z9K6nJL%=#OgTQ@Y8pHlxP?~A%s$qR>&5D{i} zzLe+Z=59^;_p!g;px}YStu2|(9v&RW`(&+?<3W2+KwEvwcF#4-y=9Pa0CZ!t^rwO) zlH4il>b~DC2QBZqaUt! zhDVMZG042MWb?BvC)RVO?A!O_QTLsK!@Mr;?!wa2(jA8O+&+*SX-?%nS9cA$}? zkPwmB-DRoI&di)LeLDM_2-O{|MRBsWRVJREo)K%qZf(y$zr=I$iSy_APZWB6;7(Z= z_PN3aw2gkk1c6PPH%ov1a70CFOT*T*vr_*)wA+I&yx;fhmA00amWQY3!y}!-|7Ps} z_jUcAPp7o^{Cc$-G~ajRh)WxvY}f6#-;Ph2Hf_?ZS*MK8+k9UATgtLXMO0K2w19tY z^!7`u!}Z;IrCbve6P@KInFKeUy87o&P2SF@VtRYO1c46d`tz$si|9s!?cdNIq=M+|(Fn8|RPft%r?yIr9dGn^v zEECNI$F&dYPWTxW7kBQ)#^jl1xls=NfwS5jp1yi_cQ))TBpsj>AH>ZC-CY?X$ zvsCz#lEyjV?7UJ(j?35g9DexVvcLV))liOg$yCgH1V|9m{|=Hk-w@M{(CVS}F7-DQ#u8xs$+)t~wG^)>H-8+)tE zm1TQP%6q4-UtaxuZh6m)88g`AcW=>YJaILv{_pGfUcJ~|CU+hzb>&Q1SNHGdb2kr< zj=;FMdj;$Yx^BtOv)tU;F7B-^Pkw%GE?YuMYO3j}!j7FLuZ%aWn*QtP(W8u@Gefwz zxjj8SKOT2+b1V9M*8KDP`v1Gn{XKU4c=6At(?6fD|2J7!-7g?8@Zg`HpEIwoldb*z zE%!$A1hIu1i>^NYC?F`k)&sjrUrQyuxOB)QWZkY9Jy33nh>&1-eSN*U znp)exzrTMcgQohDl9FCc{j9V+drggKW=7+g(CMe2-tYIQWz`Drm$5vw$hCXN!!~Kq z$k+kp3DXuC7Jt34&>3{=-uHXe{V!g;aI<1ETx!?9!ulcnhs+uN?L zy;&3|WgPD+6{Jx7^|*XJ=(ru9xmH^n-Sl-m6^g!|RG+^jbamK~<$^P4j+Wo<$Ag~lPEJl)wYd_;kvErVk{-ql~ zwJrrPO$|&3K}$GmemrbXNlDp|c(~2Y zLMd~dly!Lc+Nh&#ywV*#Jt{gnJ>L3zMH=e<{wn-_x7_?%VyCA`2IFZ19?)nN=sfVS zwNa(V>@Vzw4Cu$#ew|t$U0G?FeQnLdHtD<-pX)%w%UQPJD}KFRwQ3c&1yiOb)6~_= zv#+m{T^qgq+2Ve?Ls?smN?u&xwqnbal+p_K_VNNG@i&4_m+I zQ-uw0iOHootXkpE&&@r(E%)|`bLZ5ot!MZ2@G#i@dZ8Rw^YN&gjgw((TaD76Et!{l zX3UUC{`%^wo1t;yvC#0?)Hio` zZx6E<6&3wg7Ze=aJI}US>h<;Y=GWH8=Ys}rLFZXB)twRA!!&a}JD-ffrcIlA{{LG4 z-zaK(UT#Wis$^tjWZUhxd_M}kKX8Vule4L~0J=w`_h2)-wEh1-#cL%d?&1hpmv?8! z#Tn-L^CnK6nhM%*6tOjHYT@HvbE(+fWu~W2otpLJhUyNMPf`y`et&y=IbSiyQEE#A z>zuFWt>5o?+`n?wDxb23%b)TAa(oOsOF{BFvVCr_@tN`H1{=Kh=KpPilEJ7tQ9 zvYy_#4L5U+m0picPf1BJdGgT1SnNd1T$9X6g5u)oE-o$-w$p5_V)Jker-KHvrCsQ@ytG(b|c43Sy%V0Mb(##2Yg{oaSETmf|?20K51!b z5BMUQ!WI;Lom+nI=T)fZ?(e%RVUjTcY>Atj)LiRwvt@pBv;O?~e4f!Ri8HKm51YkY zt_WT4j>H!$YhYcPq_|z2@z5a>{0k~Ujc*XfxdL= '020700') ; \ + (%{collection} == '03') and (%{processing} == 'OFFL') & (%{processor_version} >= '020700') -Pixel selection ---------------- +.. SPECIC FOR EARLIER VERSIONS ... -The :py:class:`.CSO_S5p_Convert` class calls the :py:meth:`.S5p_File.SelectPixels` method -to create a pixel selection mask for the input file. -The selection is done using one or more filters. -First provide a list of filter names:: + Pixel selection + --------------- - cso.s5p.so2.convert.filters : lons lats valid quality sza ground_pixel cloud_fraction + The :py:class:`.CSO_S5p_Convert` class calls the :py:meth:`.S5p_File.SelectPixels` method + to create a pixel selection mask for the input file. + The selection is done using one or more filters. + First provide a list of filter names:: -Then provide for each filter the the input variable to be used for testing, -as a path name in the input file. -The next settings is the type of filter to be used, see the :py:meth:`.S5p_File.SelectPixels` for supported types, -and the other settings required by the type. -The following is an example of a selection on longitude:: + cso.s5p.so2.convert.filters : lons lats valid quality sza ground_pixel cloud_fraction - cso.s5p.so2.convert.filter.lons.var : Geolocation Fields/Longitude - cso.s5p.so2.convert.filter.lons.type : minmax - cso.s5p.so2.convert.filter.lons.minmax : -30.0 45.0 - cso.s5p.so2.convert.filter.lons.units : degrees_east - -Extension to the product guide ------------------------------- - -Several publications report extended data criteria beyond the PUMs quality_flags that should be used to ensure data quality. -Examples of such are the emission source detection paper by *(Fioletov et al., 2020)*, -and the volcanic SO\ :sub:`2` monitoring paper by Theys et al., 2019. -Both publications mention the poor quality of observations at the edges of TROPOMI observation swath -as well as the reduced quality at high Solar Zenith Angles. -The integration time of pixels toward the edge of the swath has been reduced to decrease the pixel size, -however this also reduces the overall quality of the observation (SNR). -Therefor we advise to only select the pixels with id's 25-425, and for really strict cases only 50-400. -Examples of both the edge pixels and SZA effects are shown in the figures below, -with 2 figures from Fioletov et al., 2020 and an example for the SZA based on the CSO results. - -.. topic:: Figure from Fioletov et al. (2020) - - .. figure:: figs/SO2/Example_fig1_fioletov_2020.png - :scale: 85 % - :align: center - :alt: Figure 1 from Fioletov (2020) - -.. topic:: Figure from Fioletov et al. (2020) - - .. figure:: figs/SO2/Example_fig2_fioletov_2020.png - :scale: 85 % - :align: center - :alt: Figure 2 from Fioletov (2020) - -.. figure:: figs/SO2/overpass_example_filters_so2.png - :scale: 50 % - :align: center - :alt: Examples of column, error, and quality number for two orbits. - - *Examples of retrieved SO2 columns, retrieval errors, and quality flags.* - -Furthermore, Fioletov et al., 2020 (Fig below) report large-scale biases in the current TROPOMI product, with TROPOMI showing significantly higher total columns, which can be expected to introduce a potential high bias throughout the domain. -A solution advised by Fioletov et al is to remove the bias by comparing up- and down-wind values around an SO\ :sub:`2` emissions source, but that will not be included in this algorithm. + Then provide for each filter the the input variable to be used for testing, + as a path name in the input file. + The next settings is the type of filter to be used, see the :py:meth:`.S5p_File.SelectPixels` for supported types, + and the other settings required by the type. + The following is an example of a selection on longitude:: + + cso.s5p.so2.convert.filter.lons.var : Geolocation Fields/Longitude + cso.s5p.so2.convert.filter.lons.type : minmax + cso.s5p.so2.convert.filter.lons.minmax : -30.0 45.0 + cso.s5p.so2.convert.filter.lons.units : degrees_east + + Extension to the product guide + ------------------------------ + + Several publications report extended data criteria beyond the PUMs quality_flags that should be used to ensure data quality. + Examples of such are the emission source detection paper by *(Fioletov et al., 2020)*, + and the volcanic SO\ :sub:`2` monitoring paper by Theys et al., 2019. + Both publications mention the poor quality of observations at the edges of TROPOMI observation swath + as well as the reduced quality at high Solar Zenith Angles. + The integration time of pixels toward the edge of the swath has been reduced to decrease the pixel size, + however this also reduces the overall quality of the observation (SNR). + Therefor we advise to only select the pixels with id's 25-425, and for really strict cases only 50-400. + Examples of both the edge pixels and SZA effects are shown in the figures below, + with 2 figures from Fioletov et al., 2020 and an example for the SZA based on the CSO results. + + .. topic:: Figure from Fioletov et al. (2020) + + .. figure:: figs/SO2/Example_fig1_fioletov_2020.png + :scale: 85 % + :align: center + :alt: Figure 1 from Fioletov (2020) + + .. topic:: Figure from Fioletov et al. (2020) + + .. figure:: figs/SO2/Example_fig2_fioletov_2020.png + :scale: 85 % + :align: center + :alt: Figure 2 from Fioletov (2020) + + .. figure:: figs/SO2/overpass_example_filters_so2.png + :scale: 50 % + :align: center + :alt: Examples of column, error, and quality number for two orbits. + + *Examples of retrieved SO2 columns, retrieval errors, and quality flags.* + + Furthermore, Fioletov et al., 2020 (Fig below) report large-scale biases in the current TROPOMI product, with TROPOMI showing significantly higher total columns, which can be expected to introduce a potential high bias throughout the domain. + A solution advised by Fioletov et al is to remove the bias by comparing up- and down-wind values around an SO\ :sub:`2` emissions source, but that will not be included in this algorithm. -.. topic:: Figure from Fioletov et al. (2020) + .. topic:: Figure from Fioletov et al. (2020) - .. figure:: figs/SO2/Example_fig5_fioletov_2020.png - :scale: 85 % - :align: center - :alt: Example of mean SO\ :sub:`2` columns for TROPOMI OMI and OMPS over several regions (Fioletov et al., 2020). + .. figure:: figs/SO2/Example_fig5_fioletov_2020.png + :scale: 85 % + :align: center + :alt: Example of mean SO\ :sub:`2` columns for TROPOMI OMI and OMPS over several regions (Fioletov et al., 2020). Variable specification -- GitLab