From 01a418be73a2ea6ddbe8b74580d4641c8efbf40e Mon Sep 17 00:00:00 2001 From: Clinton Mccrowey Date: Mon, 5 Feb 2024 12:16:33 -0500 Subject: [PATCH] fix many formatting issues within docstrings, add biblioghraphy to manual --- README.rst | 2 +- docs/_build/doctrees/environment.pickle | Bin 702317 -> 804011 bytes docs/_build/doctrees/index.doctree | Bin 191663 -> 216734 bytes .../doctrees/manual/EPA_Disclaimer.doctree | Bin 7868 -> 7912 bytes .../doctrees/manual/Install_pyaqsapi.doctree | Bin 4450 -> 4498 bytes .../doctrees/manual/Introduction.doctree | Bin 5392 -> 5815 bytes .../doctrees/manual/Load_pyaqsapi.doctree | Bin 3678 -> 3700 bytes docs/_build/doctrees/manual/RAQSAPI.doctree | Bin 4456 -> 4476 bytes .../manual/TimelinessofAQSdata.doctree | Bin 3887 -> 4333 bytes .../doctrees/manual/Troubleshooting.doctree | Bin 0 -> 3582 bytes .../doctrees/manual/Using_pyaqsapi.doctree | Bin 10501 -> 11429 bytes .../manual/pyaqsapiFunctions-Brief.doctree | Bin 13461 -> 13770 bytes .../manual/pyaqsapiFunctions-Long.doctree | Bin 162564 -> 165610 bytes .../pyaqsapiusagetipsandprecautions.doctree | Bin 0 -> 19971 bytes docs/_build/html/.buildinfo | 2 +- docs/_build/html/_sources/index.rst.txt | 22 +- .../html/_sources/manual/Introduction.rst.txt | 32 +-- .../html/_sources/manual/RAQSAPI.rst.txt | 5 +- .../manual/TimelinessofAQSdata.rst.txt | 6 +- .../_sources/manual/Troubleshooting.rst.txt | 9 + .../_sources/manual/Using_pyaqsapi.rst.txt | 19 +- .../pyaqsapiusagetipsandprecautions.rst.txt | 58 +++++ docs/_build/html/genindex.html | 18 +- docs/_build/html/index.html | 229 +++++++++++++----- docs/_build/html/manual/Install_pyaqsapi.html | 4 +- docs/_build/html/manual/Introduction.html | 32 +-- docs/_build/html/manual/RAQSAPI.html | 2 +- .../html/manual/TimelinessofAQSdata.html | 8 +- docs/_build/html/manual/Troubleshooting.html | 110 +++++++++ docs/_build/html/manual/Using_pyaqsapi.html | 21 +- .../html/manual/pyaqsapiFunctions-Brief.html | 2 +- .../html/manual/pyaqsapiFunctions-Long.html | 36 +-- .../pyaqsapiusagetipsandprecautions.html | 178 ++++++++++++++ docs/_build/html/objects.inv | Bin 1154 -> 1245 bytes docs/_build/html/searchindex.js | 2 +- docs/_build/spelling/output.txt | 0 docs/conf.py | 16 +- docs/ignored_wordlist.txt | 3 + docs/index.rst | 22 +- docs/manual/Introduction.rst | 32 +-- docs/manual/RAQSAPI.rst | 5 +- docs/manual/TimelinessofAQSdata.rst | 6 +- docs/manual/Troubleshooting.rst | 9 + docs/manual/Using_pyaqsapi.rst | 19 +- docs/manual/pyaqsapi.bib | 78 +++--- .../pyaqsapiusagetipsandprecautions.rst | 58 +++++ docs/pyaqsapi.rst | 8 +- pyaqsapi/bybox/bybox.py | 71 +++--- pyaqsapi/bycbsa/bycbsa.py | 25 +- pyaqsapi/bycounty/bycounty.py | 65 ++--- pyaqsapi/byma/byma.py | 36 +-- pyaqsapi/bypqao/bypqao.py | 32 +-- pyaqsapi/bysite/bysite.py | 112 ++++----- pyaqsapi/bystate/bystate.py | 74 +++--- pyaqsapi/listfunctions.py | 52 ++-- 55 files changed, 1044 insertions(+), 476 deletions(-) create mode 100644 docs/_build/doctrees/manual/Troubleshooting.doctree create mode 100644 docs/_build/doctrees/manual/pyaqsapiusagetipsandprecautions.doctree create mode 100644 docs/_build/html/_sources/manual/Troubleshooting.rst.txt create mode 100644 docs/_build/html/_sources/manual/pyaqsapiusagetipsandprecautions.rst.txt create mode 100644 docs/_build/html/manual/Troubleshooting.html create mode 100644 docs/_build/html/manual/pyaqsapiusagetipsandprecautions.html delete mode 100644 docs/_build/spelling/output.txt create mode 100644 docs/manual/Troubleshooting.rst create mode 100644 docs/manual/pyaqsapiusagetipsandprecautions.rst diff --git a/README.rst b/README.rst index f170f80..3678c64 100644 --- a/README.rst +++ b/README.rst @@ -68,7 +68,7 @@ Protocol (HTTP) so there is no need to install external ODBC drivers, configure ODBC connections or deal with the security vulnerabilities associated with them. Most functions have a parameter, return_header which by default is set to FALSE. If the user decides to set return_header to TRUE, then that function -will return a python 3 AQS_DATAMART_APIv2 object. An AQS_DATAMART_APIv2 object +will return a python 3 AQSAPI_V2 object. An AQSAPI_V2 object has instance methods for retrieving the data requested, header information, and other metadata related to the API call. After each call to the API a five second stall is invoked to help prevent overloading the Data Mart API server diff --git a/docs/_build/doctrees/environment.pickle b/docs/_build/doctrees/environment.pickle index 70de0a69e2b12b2fcb7f83075f1278745cdb6c9f..418509ba7e6fc455a424c22df57071cb650cbff2 100644 GIT binary patch literal 804011 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 GOJ_Q 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 M<3Gv4B9Y_&1BXNulmGw# literal 702317 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 QWsk%30OSQF?9X)kUrhRv4FCWD diff --git a/docs/_build/doctrees/index.doctree b/docs/_build/doctrees/index.doctree index 030de53d8dd4aebe388c5b8d3c7c118ded0f732c..931b44da7785b65ebfc780d63b50a244cf0c74eb 100644 GIT binary patch literal 216734 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%0D{n%_E= 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 literal 191663 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 delta 72 zcmaE1yT_KLfpzM}jVz{2tQo2q*2R+xd6hTkFiqtIaf6FD3-Saof|zB+n+tiru!ERg W#ghej)Hlx&?Pg`{+^ivefEfT~P8Vtb diff --git a/docs/_build/doctrees/manual/Install_pyaqsapi.doctree b/docs/_build/doctrees/manual/Install_pyaqsapi.doctree index b5b71a13b4684155cb9aff23d53480717ea06e80..9a1a295c996a55b8b3f0f8137f36492e87fcc486 100644 GIT binary patch delta 173 zcmaE)G)bAIfpu#8MiyHp0gVjR4C@TF4CV|azYG<>(#dz(r6(scZ3IjBqD!0?VB2iL zypfTyd2#}a2=k+cnUnvs6ob_kVN*MU)qs&Pb#g456jZI~*C3QOlLqWUl2=vvk&uTM#jcTtRj=USn{}Ar!-Ef oodT3C0?SVJVdmI;kX4Iuay?rrLUIB^vY*|bjj?m{ecsK?0GyX3kN^Mx diff --git a/docs/_build/doctrees/manual/Introduction.doctree b/docs/_build/doctrees/manual/Introduction.doctree index c47af48aa19be0891abc04666bc45a0a7198ded8..8faefc02a63e7f2753b04bfbdb0cbbbb8accf0be 100644 GIT binary patch delta 1566 zcmeH{-)mGy6vs2UKf+!&R1?{@n8XSG$i`${VxVF~%7PF6pixnpKn=<4-PxRJ?#^BA zoogZ@(FZ|cD26*e^rbH?NTC$$f`SkF5S%wJ=xoN~$P0gtHyP8+zLrhoU(jCr})jKUUW^xWkO z^E9k~%Y8*vh!g3oHS@U_Hgkt*+6Q%cBHTDy3brZ=rw;-!zQVM5avR&~^?1wkIa z&SK%yW+HthLdgQ5uG4gnJv-v%CuI^)bRHyAPBZB=U9o3A^R5X-&s=ZwNbwCtuS877 zO&-zoXZtvw^_TrAp7q8)GVWbV0?8v*7Z_b&UM!A7UogcRbX_Q*>1pRMdaOBz&|}M? zX#eI^(EigYO?Y@brm+0=vA6jir8SvpdT)}ZRd)jY7Tg2qcf*}R`=L9I_V4-pEB7GU zrGZJe45h_gr1KLgl1*yvnC)8agX(r!=V5FfE83@vZ7v&lf6E&YZ}t>bkNjIT4Gb(9 zdT0lN%^eDQbbQ&XgTelcq;ZUSV9AuVor}?S#*@)*_Nyqv;Sg?^ zz;ANNBrpZ1U>}@F>RoSbiN=g!S&*K+n-~IGZq7FUVBq#o!x4zVAH$mkvBUPvZ2~y;t2lpQHZ(NC*wb delta 1016 zcmeH`PiqrF6u_D8pU^d>R7tcpZJ*lKG@GQP5%nTvV-J;5tTlpYOWf>EI;)%AI6GU- zp{NIuLco+=zlI)iP{fPhz^fNOK?M(9y!jHe2%;yC9v<`K&CGA!8)jY?x;f>s@wPkYZiI|NA`v%se!F-ZX`9ylpVnuV~SG zt(*c*?}s!PB%7ftoR&+q=s;RPM@F7N$3?k}?8+yRpUI^Yu;ZAp(r!^M=tBWjZhAq3 zaxMBGUl@n0%azMub7zP0AP<)BHJt5`qY{)HYF3qL)ZA0%kY6Qdk>4nQ{81^aYY!aP z#d<`@Jusow7R>jc492zVwPmAftQi~C8Wz5@2!8!8HeCe6`}3?8nImWWm8)m)n69cL zzf(^ke^UE-H8F#%C+20AzWM)R|NX_zK6)BIiFac*!4`tL$uhffmQ8KN3@}b(%wWuI z#UabG0?RR-4$kJ{7VUk zKaS~(#acmGXO5V7FYlP delta 54 zcmew&b5Dk)fpu!|MixUR)(q7Q>*C4pc%?TdFdb$Daecwu$q7s>n}b;L*cdxEALQE1 F3;_8e5+wit diff --git a/docs/_build/doctrees/manual/RAQSAPI.doctree b/docs/_build/doctrees/manual/RAQSAPI.doctree index 563a5a7c6ef23010f70d94eb7c258081be611026..01f3fee21f48cdbea169be9872fde78b682ff379 100644 GIT binary patch delta 606 zcmZ`$zfTlF6y8~O5BVXi7h{wFjt8epfnq`|)&@#);fEN5CSG8;8}6-ed&})yfWn*> zCP$cVp0VK%pe5T;QQGNWU}9%WMWcx`r^yir#boBq``-6`@4a8S-#O=l`+57=$=icI z)!jPZK!p<@@jd$B%AxDo5W0&9kAQaI z@TUDYBfZPo_zC|}=9}>LqBw&AqvUC-Y!Q9wv>iytG=VZ>u1SF$Zfn3DeeM>q0S|!c zCRQ5jood+?mY*UsBp0zVqZ=yMN+<`aENZZ=C(ZxUK-tqyRaqDzRAje~#9pjLi9p$> zBfcANh1vk_x05@p9_gp460Ba~8g;cz&a&Y6edS7>9`9sF)$QVCKeVa7Gx@97Aqtw6yz6` zDCDOpBm_AI20I3LD%fO{loS+O>FcLwmSmJB=_Tjq>W2oq79{FJRoErOZ{ET5ov|Kh zvTt!xhI$WYQEFOhQEFat>XgY-G#jVXPSMC?5Q%W-wGeSYGFHOqO zgu7Rn2(Lq239&zRN)Nkp5hN_9BxVQ!oi73sLkNihg(QGNFsEf?fNa+2;ev-($`o(L z&EjlN7+JxAIr$=o^ky{DznGck5*|bSx2qIM!!?tPqLupGdD)G`B^b#x;l`2^5q&v->y=tb{>Ws)eX<*oka_C8b2pvwsUWNwdFq#Q?YdXqW`dSQ zd8<-u#iDZmflmb4TGBAKspnz!abP79ch)P%2XED_v+1WU+Nc_SAu&ZFf~ZX zY)HA!c>UR4o9<|(7ybxcIe9k0008E|8%p7cfr3?;9c3N%?7-8}rUY^ZC66iRaTb{z zbe2gou$C#aEecKH0tzN^UE0(!Oo4~+8*y!zEgj~sXkvu=8m8j$uuVc zHAE3U92^}+kTj=5GE5TEp;_ delta 224 zcmaE>xL%I6fpw}1|3=nSCYB7<4C~2u0t%C7GU;$+F)}c?1~{ruj$?VusSxBC80;9} z$u-%V)s0gjCAB0mGpCqq@+?*@LA@y%?6Ffa93qI-!J{{&bxPxu+9^Q$e1Y~UZ7ye5 zWM=H&JdDH<7a8D<%=8D^7L l@O_*-kAF5(#t)z=%FG#GODEe4NKbAO&}Yi{Jb9adIRJw~NT2`! diff --git a/docs/_build/doctrees/manual/Troubleshooting.doctree b/docs/_build/doctrees/manual/Troubleshooting.doctree new file mode 100644 index 0000000000000000000000000000000000000000..a49200832cbeb2bdfcbddff689b3a575feeec911 GIT binary patch literal 3582 zcmcgvOK%*<5tc~ql1qxqhb6~BEMY>w7{gpjfMLYW#exDO0;7!*J2{aU_s;ZgH#jpr z>4&roAV4`72!RH2aOal%Ip1?K4CI)v=Edd8d7MmO!0qaq>gww6`?}_3?{D93->Cll zjwyvK<|CG-g-W>zej`4llx?A87X6D5n!1{0(>{LT0JvMK}wG;)d_Z zBIWbWUGzj>te*wH$*k3K;w-{am{pk?yyDlBj2QzXe)kHN*S|JWS6&S!EIHSFTKgjz zEi11>-#4ypeZYw5+D3jPd3t}J7Z9K2zd4tM?TF5kr zdrtgR9Ex|us(2UAfp|;2eX`;v;yu4^cw(h0UO9(DO!lm_C|Y}>qW5a~=*Zx?_646) zX0JMY6)H4f@n6)7kHy<#H(~!VYs&RwxPP>e>spoT0L5Z6%}TMD(m$WVnsbX2iE?Lb zG~tnPWtmByMtsf^n_WcAL{@P8*O)AMBBz-BAet&oE_s=8n%^{*S^nAMr=M3d4>LAl zIg6x;4(>lV_#nbbaShN!EPBQ=$0Ie34jvp-&UiiQUf;~wMU-)tMpi|x;Bzc#k&foZ zW!8+MU#h53Hd48?l^+HD6W7W_vWRG#&4#RCcC&t+63j=TD)^`VyB}iL-@N?${RiK? z{Kxn29J4g}gYNzcO;7%RG@Uev@3*LO6W+n^(C^qKNf7sVOQlyQS<5cM>4!_4TJt}y z4=V=qIGCOAG@e|a<+6fjK#-eKbY}?Yi5-W7^EN*D3O;KY}E_KSmhkU&1UFyhS9cFNle;J zvsk!C(tQ#9{uCk&p74c9h~_qFR^jq^4*uo=mZ5>vmvN$Ux`GTs{-n0>j8~TUxwIl~ zZxF25ywF@JD1+vu(l*ZcGmi4D_)WpGZrJmCd@fNn=z}w@Q_uHOK5;WFH+;@?fvUkn zbC$z0K=~6+n+kvNLs_6kG4P;Lcm+Rjc6#*lBO~$q&Fhmf*IMaVup-U4M#U-B1eeB6 zUFn4=y(&uZcb8_CLWsZmVIA};f%ermuTLz!>33-Z0Gbh~PlgQzzn!sS=Gcs*+$qK@ zxY7MKIV;|_nQ zYGsh5x&_N9;7(tmjPNiY!1+bAO z%k`EQ;Mgr}#()VG$q;nAaf_!C?E`fouhTCqf@Yv1A}=Ufiu2w=>w|Nuhrs6^kqfXX zW5zEpjCx^(g|qllAp{8yqRJ( z6{#0H55P=5fmj=RLCqmYpLOZ)B=9J)ymt6#Q9S$2wz)>psin> z^P;8p0|ju>`9x(M7%JD>OUBN7a4q7XUA1~?|5|(qt+u4>ca~!{Gq~R%ABl1#4#96F zD$7u1>;d=3`lH7FH7f8`_#LQ#o(iPGM}xuP*9&$kvS>yxJ2V#td}^)TRoC^~zpg)U zy78y}=vOGWCLl%iF-Hf@SH%H!kJRdQEJ;U5iF#u64*xR$qY*xV(|7-^TlT%?#=7a( z=*;nL@p$~%Z|K^nzgM7S&DX{XwE*8DnBVHQUSV`g7D?t(;>3(}Z8Ie?Z*-5^EH@eb E8}Dd$#Q*>R literal 0 HcmV?d00001 diff --git a/docs/_build/doctrees/manual/Using_pyaqsapi.doctree b/docs/_build/doctrees/manual/Using_pyaqsapi.doctree index acceb7fb15375a06a83ec86cb8469f43d3467309..07a9c498f4e16b977d05b4ab567b9938dea45625 100644 GIT binary patch delta 1820 zcmd5+TWl0n81C%O?sgZ{ZRrh=?&)RQ#njanBxd_k4Dpf%kP<*5WqY=Bw*QRn>^K*p zB)IUvrOAXC&+q`z2V#5{GOxav4M@@#5+gA+CZdTk`alRz`e6LeEbUHdt3LX0cF&pf z{r~r0zVlz0`22Y6TQPRdk-Dn`}SK?DLxh5ArbyzbXZF9o6)Up#ALQ(>P*RdkeKvxFy`ik zld5;YJMW#v4_VkBqAEd?yV+p6qUtln(+}l|P#@uZiGY8&b5J&?K#|0x2rk{=z zxvR_MC&J_uo)sab(X17Nb>$!eR~89-Ze0AmXnPFW5YU0EYtnO|2M8u{%qcaj-KeSz zdsH|HW8F9=q*SIox4k+?b%)Nrbi@*g8uRphiyEruCIiGARdo+$+ytKNc>}p6+jBSJ ziJdlPRgA-12rf@iQ^&2avZ*=45Vba25#kZ(g+AyXkBNFaC6LEldri0cLfzV+J&Zqy zj%L1I)b?(DY6O1BKEE7U6PL)hykonuq^6h9~v6pA6g zfI>MG@8f6U1Gu{p&*0au;)5e(R<&$WDW~evDjppn#=H#`o$Ml&lE$WOi%^rTaOMeb zN%Uq@s5et(A24DAs|SYU!2zpN1V$BR@}9)=uhzFIRWDb}IclpFy&=)v|B_tQA|d@= z3`+=(t|Qkq1*psQ-DN0zv@F%9ks+Fo8#L9h*aE3S`9G=jO4v}SbmSjY3ic{Fe$tTR zemJ$U8sUtaUXw;xgGtojMbzNfJC{&L{{t-yt*3>?16b8x@c^>iPbg9g?`q!DQ4^Vo zDYmEHp5T?W`bzVgQZPqs(0HCIe=~70JaNVbn+X6 zna!A{)-F)U#;_|3TFQ|a8KKfPPJkDaonW16Z7uL?Lu(5;6PeTj%YvfFLE96R*~-=zL+cg4bWJ1=>Px# delta 948 zcmdUt&ubGw6vw-pOhPtQ8Y7WJV<(BR`9;(e3br5yibg~d71Sc7Y`fdeuIVQ1&Nc=W zj94Tz6zhu!q6ZN#y~$qmBwoaWR|Ua?1PY!6J@({mFijNy0T074?|tU|{Jxl3y?}0` zhuevlD90lbCsPJQGW($va>62?;hw>aBMV>nFekt^e~iPBaRmK>E>lz2WGUMw?%6gu z+4?6J7~odhjrOfJOK`52U>IJb!1yLNG?Xuwu_RIvD+caG#-^cYOSmd(l4#&*+j~kE zmt`Z1;fM#ba!Q^QE2rX$IR#2&xbI4!ZWQ>A_Q6+=lOdm7V@VC?&tJ@!&dgoP;cA_d ziiXE=WnPsR=wQCA04Ibftht3Si`EU4!AmloBeE#TdLoGz%A#Qiur34(SkV?M`m#us ziq;#!mH)Am;GdoBEa_^0Nk0XN8-dH-i2yZ8ge2GsC&*#qAW;${htB$}=iUNmD`&m; z$LTxHo@)b;-%9WLhHU6b4;n^$ZOAJ6Ke=qjX5TT|b%>z`XXzn@^X^pjs?Vgm%!6>) zX@CCEcjVafJ-m%z^v*^g7@g%P)S~KcKe@*Q*kp&26$3WV0m~bk;<-K6>G)%wYg(PL zX|6z-oL5A%<<^+k6v<$sO^~~!LAFT8Y_x&nZk~SJJ!yW|;St$`TsnFnBcVF6Vs9ihC?x5~D6%6dAw3wCLZWFnb^!hglVA6+ zXelxxE8fd&H6WY(fJvAV9@LDwmES|i77}<4wTwz0fbG0zX9}bsp(s*_fh?4rR!Tj|B0IZ%j!#1|9$EDjiCQVP5*XHn(F^3U4Jp? ze^b*>Ex5_S`;E_M=FKY|(FBoY5UE0uQEfYuB^akJ%o2#SsbkO-RD4n3qj^oBkGO!y z^1|?NG$V;j2epI?xeZ4?*7GW5ptEx(gEh#z7QRx-+Muf}D=?|U2t4X%Mc$lna9@k(S`ZtpIgbEf! zLyLMxtCE5|)9}bhzpaUaV#O@T4QXUan#D~W_qiAw)lbN1E@jb6= z{hZT&CBzw(GYviUn~Lq`e|HY#$Bn*Kj86{vI*p899t%Vm=A8VgbBtjeGT(KFSzD;D yDp!o=IA<*895@toRr_-{n=N$^gtNhm`KP&P*`-sVok0+*8ka(fpP~}elf=7(%!hwOHU&I4+LBZ5Hk~zcC7Whj@nc{#~ zZZ8Vsgw&8zoY4)xAEvx3vxz$)EGldwd1Ulc^cgE!1mP!2XkTtWMc=TZW(dDhLQC`R zQuGTeS`6W3B~+Imrsx_gS_0u;O6bS@$H%aR-+?q5R(BWVvmmcPOP>ljGyz$w3cD2Y z70Ncg2Wz_{_yXHjXjJbL1_uM}qhb`*$LjS~qA=*EHmNXod~;J6>Q?$t_#Sy-ZiiH? zr5px|)x6-tz1%gCo+Uc0$60WOq_0R~DB^mPC0xA;;F$oBM|lt3zclqcRn*%COTb%} z5X;L}_3rpQB+k63r5{UViy(I*)IffMPDuWMBqocQoGR_1{HzMT7V`I*_zRSNu7chJ z`KL^@nXFs)<))3_-^nYDEqXH@ME#hc>7Mmw;@f3 zCW`7(x(GejE-4ql|3(6N+6>4=Zk^oVzI9v|X+r>HQN^-alMP{GzGTs1)5R`UWYu9i zxaoeH17U6Q%GsGIS4>g;$gmJT6A-b3bU9m)U5YqeTI7%7JLo=0DK(= Av;Y7A diff --git a/docs/_build/doctrees/manual/pyaqsapiFunctions-Long.doctree b/docs/_build/doctrees/manual/pyaqsapiFunctions-Long.doctree index 92a60bd43d34e83b2204b2b121654e07644f871c..edf2e5fa3c5dc7c86d6cf64675f540145710c364 100644 GIT binary patch literal 165610 zcmeIb3A`Lvbtf#z*4ExPY>aIR*|MLE-jnePf;g6K42~^XwhSm>^IY9s?{z=*rmk*D z4?Y{4)d~#^_!(lhkiZNR)=V;FAPyu0LlP4B4e$Zuuw&N15W?~S!vy&L=iIfbtE+ES zw-#INpZ)w^)xEdQJ@@SA+sva+hO z`u3$>!S8h1)nd1UVQHA7s^t(}daFw{KMe5@zprfgb@AJpa<^svDEg&c?O;x{2Qcj_ zx0>p$3agFz8UQ)xx^AP?sWuy-_w;?OX1f!Vz2c(RTJ(2^eyfVlFj&(UEmc-+>n!=b zRnP+F~%1*TdRH}8ZtQ?9|T32*D`qp3{ z0Xnq(%a)je0NPUpXxl31ZR-~OfpemnJO#}!w`OuQ&txr7>CdcPRxwlpVz2;sE zRO8PFUbRuGbwSNu2XE(^wOVs8sKyJs#d@>ct>MMqO0`t+usB|$*(ubTep!%DIhgai zwa(_k=FLky*{gcbIY6ISGRWELj+`6h@~%`!V&oiGt9F96Uz;t~nx$Pff?jZ;M$b%f zF+{UMUUSZy(?Tn- zgcceWlsxGpVoit#=VOK{>)EODBnwNoDJ<hTWha=CpV91k90etOt+*JQr55eK>0E_M81*Y6tb^o}dyy0=E0Qw1Yj>5IVL3 z@@=*kGrtf0daD+cyKSE}bzlFmI^US>wlX}2F+o%y#8!VlB97=Bi;ECcGk$}VcG#`g z{n#|b`!W`Aaq#O(P-_Kk&AgHCiUI1)MinSZ`u6Uw59_3zHonA@-|=HZ6Q864&ka(b z=lAL0bCUt^^SdDv;5LJ2zzQaP4x&lgEJTYT^AL>&%|yK2?avBYp!ICFVa%0+V2@vm z<2}7~r|maFpDn9_9g8);u`5mwf^KI3MTyLk63DeY%hqs6HuvD>bFg8+MSY}{-Fv#n;e(V5*{8rY~6v}V)3nNHhsy2FUWLZ@gN1E=m2#?-pa z1?}dbb&Ix)tg!Ww#NiXyON{5VR-&m|fh3$oTcoU!Xqd7-qQRiG!CPyxi5MkaVB<7` zsTg`v+gcwQ&@BW%!jkig`u4FF}=BCOfX|tGkNfR$=;w5RWpLj{}NP+Telx>w_HmRm5R+DNn z&}f=?Nr7{yNBJyjX_5j6@ir;Tr<$fLpK6l2d_%Mvk1@W(|p3NPEmZK zLAw4HZ3ZZC@p6#klL+vj#@2KP^_zG}!OUQq8Q>-9Ox_FAGI^CSUV^>5E)2awuibFO{0@G9`>VP0k=wHV~;H&u^5yxoQoud~c86u2RB>Qp|p*K#63X z1fntoO8uc|z`GV9eQzt`{~qcGX1rSh1TSgWJGNBY-pxo!R6C2_j>WJO)V(Qm*g)+H zPpfn~t#I?EO;BYsLCc?+Z|%@3 z4)PfxB^)WWr~uJ$u**4BxvF>1AxDIj1>bMy8&PGj7Uc~A$|sPNwMrCjJrJl&{8)*MiFTqYz+&O1btf%SA&14XWOx zccx!$PeTC^kxqw9q|>0nX)3SrRW(ZQEVS}uD^IlYrqFDIC)%lM6*bGsJGfk>SJ2B_ zUbN7IGIuWZPEUM`dY?N1L*+sgvs5lq>n$p- zrYf7&gWltxEhQ9$L0D>6TcT8oL|8XOjf|rBq3sNgKj}vFG*>F&`GjcB#Yis#uv+}? z+==3|Te)U}?X<89^y=EvVP%s{K*7RFc`8HSggO1 z=e=DA5jkqw2lbl2hvb`Hf9N3oGzY+ZQh`!u<%C!9Ds-F}YAy?SP9YQP9F#uNcf%8?qU@B=oxvIad?a z$unT}n;Nx6@wf?z(f0f~^0PXqJQE%FR-vU~1}Iq}d3|Ax1(l%8h2yM8y}Kl!zWhE5 zCaF_1gP9Y^sfAN)kX8wh6e+7e4V96BWTQTvYAo*UfqHI5=WcP~TzJ<_6e$rRV9rAUZ^tWD{KkB+j@3Ij8~ZS*6pgFyp}EP{XZGLghoXJAMcrW~ zOF+Q#Y0^J=mrY@3?71lwb^ov`?6Lx00a2zog0} z8g!6HN(;F+03xjkx1ph|jbRdK=aZ6A?7)If2p$)DM@R11Q5%z+C-)Pok|;^947a}# zE09Z`z78z;dgilKdAjp#w3)0Y;-Q0BMXuA%C%7T%;k)0QDq9}D`z=DcJSvIbc#sS4 z&O*6bPrU|Y`=6O?o%EETaA!S5OmUyX=u%I;#-ZtOJ#{HYDFrNHvg@e;Q7`U_fOwyV zGWrSH0nTN*h7uqoYp95R!eH(isu&=4PZ1&vY)erLqV3%SsiHO}W7kEbx#D(=m>mON z$AQ&8?bJt}MmzPtGTQ0OKz=Um^oL-?hnTz4wbL1BGg(UB@!4m?DaCY_8;+ou1`xbb zNtQTyG?BcelYW?mUbRlTAH@27CRQh%B>GXgTi;U-jT zM7gk7Kw9T~Jv|O<3T|7g)~lV+@({>#z``{>MAlJPKpQ|kQD&vP&%lX5^i3Rcf%sOf z%esJ~Sr~|;Vju_{fB`E8Cu7L)8-b^zLlH=3yl1021kRP(;f+z`;TtHU>Y#Ka4gp2j z%5>-k()zVhw?=_K(;bH>(6Jn$_hhevV_7iTH8)W*;HKNW%_w--e8(ks+~&2hbCy8z zk&#CwL%7kqWYguC{GzvgD^iB?DRtXk^e*vG^4B4C7Vl>CrqG(QB2CRCQD@d_7|3W& zHEq`4p<_m3=hp|(g)QnvqzdKVj7SsXponqO!?>tnOtdhB5@H6!shV7@2!_%Q$uErw zu?He4my`HTh`u(E90vslg9w`Ki-H!@M>&OuBjV8fv|MfxgY=*e%QY^p=ylOA&AuY<*KS2JIPa z&?e|aHA%8AXZzk;gTLK*;>wsEFeFUbQ^=H!eM}p&G>e62;)gV0r~6D;sO^EG+JZQa zj#TqfTdseM^?E6!|2j--R019sO8$bhr^YQSztRJrgOWd zw1ZQ#u$tI76{Q`6qTMFe?HF{pQ^M&G+;oC62aGWtze+%)m_+?)^!PWhK)LkzyFmzF z;nhvmn)zWVGVO?)vOBiSW8>%|2WG*&{h8As z+~CTnyEIg;MCt%j8bmS9T%*3P=+!(hH1y6aG-Pw=2eHs^=haK+Q2&5WUQO>He97SL zgIVyVdGEggX&-PPdC7YMzs|fzOY$~{(IxM_*`euh-g~g_??W~wi`qnwYQ0-WNgcM- z;k|O6#B%|s`1?hHN$I!r;{T0+W(AJPv6GufrvD$^)IF}#q zc?)}$(p*;Wd^MSLvJOC%ZqQV*~70Y|gsm2$1 z{^=)QM4L@;eh5i6JZgB;S6t+3kbFTQAu|hV;HUtsFfszhG5y%&lO!G1TQM+8I{Mr2 z#uJau8S(fS2>1eY9v1QV)T0W`3X_krSs8kGS{8cHvhr_13{PQVaEgKmx^b43L~7?b zj4oxR=g@SxtbDMJ8;>$tbl5ZBXVImJN@e*)EIRVPw5UXHvujq^eA1>Hheao6=**#s z^BX7!9cGtzZhdl2%tUeLYPoinoU3P{Yulpx2M}MCDQa96-C=-5g(!E6?r;FwNU6KB ztfrPye}|=fp@VRc7M)miXDLO5GUqV5lu|{9ro*MwUlXNgwCL1QM$MV57G1yNsVq7+ z`LvYMU+J^x9CK2Csiv4&OzBVOu-6i%$M#yb$tB6Dh&?7&&yrK`&qCR@oca{V@7+vO z>2m75k0>-MLG=iO+DNLu&9a_aQvDMa^TQ4TLP{#J?#_~mNaa5}j4mbBI~?{L^^N27S}1Yuc6=nj+W|~Clt|0GICF4pUy!TY zc)$MQ=7P;aBSJq8*ke+rU?5fOV?Q#q`Qt3KY0H|=fPj9;RFN)g_8&HgQiwQ=ATsN) zVr2#&T+4`0V-bGqz?xD|4jDn%)h%?>Kr>wI) zM@=M5UFE=H492lR=muYm*N=}vqsTn|*wES~S!m7X`OkwOHlg#dcu)19Aw*5~Ab!!{ z@!BkS)I9q+AaM&L(J4+M@a@dAv_u;nMwdK0<G zwVQjY^44Ih3~t7|4ux<&A2$k?CA(c+4vO>6_#A0E?@$~AjRtq*IP3XbHPDr_cVGzG zvP%$@nsnJFj$$K)PB9pKT(z{I=v3Ox?mXXG>pgw@77U=uS8z8bpHuDT*6cjm#vAsW ziG6INV{Hh|M#k8P_)5lBOscJsh}VH@^T2RmHwy>alI+W1lif`F>DJ4yj@(sY(MlVL z7Y-f{EGPKov8AniQ*RZ%YE%MNTI0&mM27|Kt7Finigr4xc7f){8&tLz#>`F@SaBq# zsu8WB9s+nTVenF?p>`4rK1v$y_!$(gHs&id#I^&K58jcX?UT(C zn~IUvC}1tx`vev)*FKG}gFrsctDY{K?>wZ4QByy}P#9hK#Vq*Ny#6&H`+qsGnDijU zx;XPXE#*fYMwh()5r?M3dHu!AcXTRD7H+>d`Aiw`dVite25m8p#Nu~ZfV$H1ATaX+ z8RP7N0Z9?K{m4+;F{^TN_qRY2tI>Iw57|EW7*R7m6rVPjJu3@lH6MQyXnicB)k$ZI z6>#QbTC}4bMwfiN%%SOUK7Kjfjy6&?^Y%8XCUNJ4ye5bowJ^l-6u1z_yQw|zH>xk- z3*JTaxSxeGlsLcG0@jssm4QM2P#n~}fX4aRfTgIrU_CNaw>1mZ*`Cz*KpNNcdZ%k^ zoLKF)KViIBQL{c&pEnqOeijUCzWy%I`#cABlKNS!gfm~$;$7!3y5#Gt9hwg3>)mRj zO&0a+u*;B=Kzc)w9Z+(M#`Nk2E>~K0fGQQH7`Lv~5Gb;>o)}7cO%_VBdG&u|xnId^ zn9i%k13!N?!GrNBgSoe5!JOv79{_D{aUgxkg95|OJV=Xjufyn)2Vd&YG>HcX!_!+O zZmC)7Ex(YDg!p%PEyl~uT{fn7@A2w>r)m3MtZ5`%rp3Kj=3+D5bkG%Asn>hal~*bE zbERJ)R9Sud5@J{BjSOM@b0)&TJ7Vn`*L{D`U)C`|n$0yDRZ0OJ8K+|18Sik{x=JK`8LS@F( z)9;NBUbPnE9MTZh~aAf(hNHI*cw=UsRq!1Xg~nm|xyov;qk=^{BU69PJ=T*^+$f$Oow+ z)Sm`bJ944wH<-*#4wDhedErL=5faX+@_gZw5R?m_!VkLVPHAWQp2A2(vR_P+Jthfb z-0pSuHVwCjTBzsgYVcOqQ_3LEw=ToYrS?Q(YdRIZHOn%HdHu9PTezFPF0{VY$Uyhv zT+po`=z zj3`5orhD&nQf1TK7MqAhWrfxaxZEVkJc=8LakGnTniLz+oGHNv?9_3qGuQuVm8%5r z@P>wvK9Xrc$Pjx__aLI!x{3}8Hmjf8l9JS(yT6&zCpCasXlymnn3@}=WK6M}h2d2V zb?JsQ#dbBCdmB{*;b3uyHgnaWRu1XfUYYQh&)dPCYKY4xD=5Wiwinex9e|Mq8ZebF z0t*?;y{*T@=5Lnt!nma*O0+C0BU0qek7{CBx|oIgUao~ZF$OqYR9b76cFpeYHaqrR z;XB`tJ*P^YSgRRVCphR>7o3XoiB)l)Ul8Zzi=q~Ft$GIngB9=_iyn`GJ+;J}!gr8Ykt<=z zx0ur*WrP|MqwG__(V&Z(yCIIMMp35h&wF$$I7u4mZyff6GB5bMSW)sXarRk*+mbKC zJ3{0w&tBN92Zc@*X9U58DK*<|IvofOsd0bg*NIZZZ9WP(uS%s`b$o`_y^K4fOPvB8 zsz$d|({N@C`m7>P)&`WmVu3Pc>6g0VsDr}5 zN}e6$uNsl~@3}o1kN?37s69&|r^V z9VeXqYn8Y6o?7X2TH)qRo8W@Z1TBANzPX2f-y0M+m7AqhBGM-k6Y{}{8?-ZjKw-oDh^h%G|XyP>hF9bD?cXq*O!)1c~UWerR>rJA<Sa8H1i&6y82+Adz96^hO4~rA+9haMT^T2V?DmXgF#! z(VvFKJuz6=ti#A-h)C_$FlLEJO%c(k=|v(^zm&oc7KC@jB0F-po#nR^kW2A z0-a$#auFa{1%&Y;&{UTA-V>wLwD1c^8fB2~{36mZHzGD^v5JTkh;SCzS_HT@ilg0I z9mFyb?P`1T*gV$4=CTkCagbRFCzll|ej;-3eTOGEI~D9ZP?3yq#=Ck^Uq43IOzQ8e z%zdGRWuHgLR0lc4g=C0}P-uii&#iQYC2fh7O=c^++1AAH=xDVt=oAn);Vr3ptL&bO z)y14>p(7*J1{@I|C(IXM3(uB_$MnbTi|`PM(E(xa8p>c_?bEz>fKqA49bz?wEo~gH z;Z5-%FsmuuT?t@yV-mQMjgGkV=pC1A;=(ZgA{Q+KpOna^OV|ANyl^wPzl!x(kYGpy zi70ReZj!#mLz^o`>5H=iE_M;1_!Ngy_f%zs$+}}ju)4n2O;o6=s1S$*dj-1)jtT0J zo1Yarq+H8@4=tAps_zt&DTinEOWYGzodMmfE43kU+EsrY(epY4*w*1FV2KxXT_Q*H zNdn;-I6)S1@hahqhjFP774L7vRpM39HwXo-tHomVh3{vO8~`~e<7A+Wfw;h(g;nH@h#F{bl8k7B@39Q( zqyT|;Gi7T&*a=*$Hn^Nd${5zqhNTQsL}g6F94b(do3+5L9lzQjP^_hI$=Y-kO@JvP zD$@&1t1=yukUvcPMKl3hVvI0YNJ413QG)T~O>Nzx&h@r}$U9F&h+(4cy6pz5X`$|v z|31NuH{McQ68#PC6L& zQUrkq^}_~%@6Cn4s}m9Uro-6$V_Z*JQS&nf0jpMJz=eSZb$>GubqjxiTeeKC_kfWi zp%Rh?57K}Le1om8>b>MJu$iqe9>aEi<*3R!5p*yCq_mj)(-Y}rktLOgFc_6R)HBg` zMSe?Mt?fMr1A>R|ezWoh9=`i6t}`w(i@F;V`LTzkAc9~=ivycP8H*E#6*rk33Wrs4>CVZz9A1G0OFAC4Hd0~jOcPRfPo=O!Y07a{r}MPL*@59&7!+8&<^ZO=Do zOEsPCoGttLCS_;(_0FO~Gn2EWENNoCmfLwcUmMG&My!a0TrFomQ*yOun_R6wKaZPi z5uVl&NS$39(#jzA%1nr*Z0%EZ56;#W$#c2@6CaoisGnGFu@)LN`^CA|PLw>mpaP82D{!!!KG^7D^TVsz59P>&WF$Qi=M@ zG+4b`>r{~oDbO&SNZ@gbi-2O6h|;$LAQJ&+_zPsTs?6Dp_jF2Z(PQC_(EDv&1Sv^zy( zW!jy9^tml1*Eh^~&k-jY3S`kt77MgbB#wD`&od)WqRc1-S>FID-V|peKItMPaV0uU ztt>aAc}Eck6;nt>(|_7GEwwx=oU0rRQsuGY<}7?!=|Fl$ zR61A*ytGmW)zLd97qhbf^Nu|AhetnVVRu8dGyNcYZ?61v%KcW9TFu6~Cw z(Y1i-jSO&|T)^##0e3;~1Ulw5Xp><%ORm7ueM_olOB@mq+fe@R^2+NFr%~M^cg8hg z>~iiOSMJ&;J@}BUxUL?eN|fioteuhubhx3QH*J-0_Xyu>kA}nf6&$l7Ho`5E zbhbv`Sn%v`q7%vz)gv^Glmu+_f=&siq$@c{AExnmZ<<^K6mf9TfwJ%EfENZ_Nl&jq zw<53<8+uO3FAa)D!;q<8%8sBB@G}~ErWQ_tYo%zYw^k!Vx#-ptL(Z?uLeAD1U0YvB z6#Z)S9(D%FzaD{Wft2BqHf=*vZ_h$fdXvE-(bLGI1>IfG>dL|5$ke;)Sa1rGC zN{8X)87{AIXey7=cxi0Dk&`rbehBrqJGj`A?M6#_tI|nw2Bul))tgkOTg3@SxK|y5 zkc2X<#}@8Shw*}J8C~N*C3|8IGm6pLwMCTHVLLJf7((x|X-1s=#MLI4fA;K|xP{8>c3>y$Cv z3tUNOTkacCS*GfW$vshd(G5@{ZG34_-xNB)O|aC7rA_c5v1eVY6MQ33~QW%nD~o>4x7h^ z)&+2`MI(Vvs?`MW>(uZW5$cr~1bAb5fJ_)QH{|O62`DWF*gsDfhyz9jKMZc?%_JsOlN%Q8-GWoMezo4Hsj9HE13fFGTE?O-2;c3yOw;X$H}R9f4`a zdp4IdtB3kfL2!Ntl64>~M7m`@NdY0>QWp^oaw+9>u@Rw*U@$oF$q3(cAi`3)nhdWU%JiM=?wt?BRh+W;a%i}m3Xap)N(m4K}Y;nalOau?nYa^+((X`qKN=*r}oH|Vl zVIVWA(S~8uL7}n0bv6+C_1TE(Y;(73aoi@A5{-s#DR!N^_SZzGTP z)9gnsoNI+B{s6++gW6V4t?E4 zg5qHzC?b2eUxu5CqXyS710mJi8o}5a#nj4eXpLlMNh2#}VhzLJPy=f;^J*mHYE;uI zvtiY5R*h^_MYMB1lS&Pd-=G?YIi;Y;V@!=;N@X#mMlhq)>>@@~{1o$Of|55n2r)rM z_%KFG5mdRwRDL0qQ$&p*poDmGi?5sq^H5Fwp{JtPIX^Kn?f$-?2L4?ZZv4)XKDDI59mE@;BGy#bjLLE*H! zFPoAsJc4N4+M4m0EM%)~&HY5Pr!dW?JF@bUC_&!NX;x;5->@m0KDq{0a*zdp z{)I4*?W;3(ZX(HOLTJNyY>0K2jclT!vk@%2(d@dcR-K#5@hrrSg4Nt8&5O?wkeLgU zedyp(m$T7AE;?|dfn4jaW)WHYn4({+8tMFz^~5Oq{aJ*jt?W5@ z^fH!K3CSZXcl7t9?5&C_ctLH{v7jW&scc70BbNYDohO7=7zd%TaWYl8YUfKPYwBEP zbpVBjdtr8)pn!dgTKQIC07di9d-AKG<_s7hVh)vT_L@c11@qycT8`0ln}{ z>`;`aSZz!#0#nQ^rC!S9Q>`;?`TZeTes5q2Hh4k+RTXp#VV63#UC_+}^2H9rOUv&r zho%wBZ!jdu7Yp7?^ZltqJi|H&p8JT*-{8+#I1<$a=}nJ?@USZoKIH(C#L*`lno1m{ z7rhsdxV+ZKW=wBKw~iAJ#MMx+m{pYns#;O}$?vK!KouoCDN)5teQKyjuZdl1Wf}zK z-J+%3q-s@PqRg~jEjOz36%5cczr&1yJCD+DTo;FmPO6SaG4!*290rWt|5hogx)Y1a zY&YTzeW+3{GR5!m3^iGfFUw z`s1Ihc;pC@RdJp-d?3D_fKHreoT=VC6`!hBn`-zaB3Tg*^_~9DQOPnRpU4=G#2BN% zNZH(%NnY%*1nL;XMYOzRIDHSw+s1@NRvI55E5;@&#waNg1x2jPWDH^=D+XgyVl*Ma zACHLKj4~pZh={q^r!Zec^rLpR6WIW-H%XdmzG#4abHD=Hu&m5aOKbw*XoFvH17v1ApB ziE3p`N@Z*+B|)J?)yXi_rRDNQHaJI7BqOSkTuNj}mD&u%wyLEXi?uTbk{k;`j)@%m ziP6n^A4iRvwjoEx=@>9N7JLrCX3WshHEHrjJ^i;4&zEKq&vqW+eI%hT5)!(96N;5b zaLI@dmC=vhg;NH}Xf$%F_}mp~a#pE#sn$kM#01 zQI+5-+u7ttlXrCnx!|ja+8dse|JdAN*w*tp{c}CdT#PBk!RS_XwX3~cEDq4DfNo`K4)Dc3G@@{7%0JqoOe{B{h5LS*(WYRx#idK!+w>BNNe7xjt;bnsv_ zJCG)l8I{TyWE85YAW4_Ukx<>Eh;+;&iiE5h!r?41+oBn28~&$3{5>REpM|}-Hef8= zJ-9r;nYqm&bq>584azzY;xNt@6p-~`I(a;vqJh!*I>AZF%+^`CI?mLi^K@SS&SvS+ zIC^x3&dAR(59QPZve#L^G`7$h=T)xXE$Ub_A?V}-SzvaWzevf`ZqTG}TGH~9f z74G_B7W&i9$Onn|zAuO`l0@6nmqZ(CHl$1IG05ssCH3fXI-8V^%IHxg^yu<=6zM#w zY|bc|hh)+&iDc47qRf%$ax|(Ol_oP$POb0pHiQH@n z>f?^hX()V@Wc6C~J`9h1P&V}=Vd0boFvGO!H^`U(>_e|{lBc7(lx4;PUAkp z%OCtXE1f2yQRz*sbQ@~-hP-V^j=6ztc{vi8y1fk6wZmH({vEs^;Q^Z{ZbkxnoUz9 zF?#e#5VSE<=vcmtWF~cMp12N14K(ZqlSj+eJR#&g@lRemMs^>?oRLFhv}%Uhhwn<^ z@gZ3?&2nm2?*JCJH{E9E@NqD>x^WPjMUyUo%8^?eCwFJK(IH+bDigetC&$IxV`1(7 z`e;BI4cU$(RX%#y7TNZZ66K>abw-|!c`Bz5P|?yt?hSlzOv4XkF%4}`<|||^{TH^$ z5|t8(Kj` zI7h7n}#tYMfHp5QRN)G%i|G>vGO!H^`U*FHn@{hWgy zv(jtaNBH)GKWC-aL_8|Jsg+)19KFv0B#EPUIW(0xN>8u(P}PXt)vBFEZ%Y{BvhhYK z@TR@1Ykp%_h=Z3pK6b9D7QSx5&cw7=6wSny(cz5h=HqtxZX?*&YKAy`Q@o`#S*;e7 z`0n;{u%}wWIhj+z%=`?_jjh&@-wQX0JxA2L130c+nBD7fOr* z_5@@>h@%+iL^7^kZHP;dO3&xI zZi4})OqS@10b>_t7rfp6tVBd&&d>3h^V?jOVk|2$@ z9^TN{`LE6*g>CorTO^qNfW==zB-?UNH(R7K5>FnHl%TxV2^Leu+7N!S%#J_GLh#z` z_&QPhn;n$BbZiAJO(ylSad1XsbFlZii{w zmAF&(0GF#CGoCe)^}OJb;%xcVHgw*c(qT&L;;Xm{xm=x_3)=Xue2u2^Xl$rFXkDCR zjbR#PuT}F)IDB#H)=CftJn*_E_L{R&^=s>N_l;8X@?2O`(}wbL(89$=_zX&Ra6Wdm zh>qG2plY#k386X(U*$iN&{Di~s(hT^xLsKU+;7W`9 zY@u~st-05`1^Uo?cF?ZQRbdfSn~hXEV2-+w3ibBbU1q!;xXGd|@1F?iEEtbAhi`Os=shgLPGL4RBgoUJwmkyZT#WO|*5eycpOKC2gaF(pP%rLe>;vu#6LU=N0cVx&GC!86tw;psV z%`&tTbe!6rfV*joCX0)HXO~pTT!v&Mh4#D7$aauwPPiT)s>g`wLB^>wqGMWZy~0*1 z0V{Rp*xKl^TeAoZ+iUy<$&BsHsp($h85Uin=&>Vm#g$Gw^8n+BHCYZ3ba?QErQd=q zl^dgOr{t%40h3 z3WcSNM6I-7?*2wEzCMefvGwAwN!GlMIXqo2o@i0ggc`(sPD&q6aKmvbS;Zl7V~F#e zS%_0>!Cw(&zQaNHNG&Lc*jWoQ;lIXVc&PCn_k3tnL{k}WV=LCf1R)W5TIi5Jjz zTcLMa?dE*juX|G%WrHV;(}K4hV~RgG8EA#IBQbBae>@10nxp_|r`bWg({lZAdGBJ_ z3F=<4>W89K$oE=pw1ys4de?}BW_#XmRA0cbSt_rPQr|=Q2LM0I;Ets4=t#RHiEJZS zy*D7syig|mjt{+K!S3MVDQD!yG~449o(2%A(qKc|8Da2H7GYp(s-spw9(<0uFkMs8 zZ59gd$@;=5ZJ_92M(L^vc9O30wtTjK$wHu7TP-8%{EmZ;klIQRva_~g;{S}p@KRfS z%Au)~wz?b4bSqVf`l6(ChhJ~isC0G9%{y>TOtD@KLvnmrd{SMe)s~%}jyHA7wHpw! zv_}!CSJ7!2*Lw%-rP+P$7Ts2@>6hVo!Mnm|3sho528TZ%G)jxOCmbcLjj)O<;XR5n zGAN-2jW3YDXmDR!YW-= zUut$6okgS)!w%_P${~t?EN26Gelw1xH7^|3N{w%!#imgW z$Xu)QRYc=cOyf=|M!^ow>YQ2V6o=uZIzPdosgpYYDh{Jpwy|x~%ljI(n@FYibnRWH zR?Wzs$$k^|s%){tpD3Bpqnglavr+DrNG-yS;9?KuSgMQ}g;;gn%?#NK1^ScXt~%>T z`&^1a2l3p7jLcHCrgUL(`iLE-<#OCmRP_|ZkyfHwRyo3O8)%;k85z4}P+1n^Sn8RB z%BGq&)w%U|hqG{SeZCON!WE$-?(7!SW#Qs_E2}lP>^HEexHW2P6w-_hVQXycw=_@) zM>WY&uO36`YL2K|pT6=Oa5(r-IT}l!%gG0dcMMKs+#nqpaW)ti7mSSw_~gbh@IZ>G zmWc(}W%Uw}n(SgEa6pRY$jAU@tw*K*0}hj*{+Jbdi6Yu9nvvnY3E{GRfWTKqXRf}+ z#=I?y^0k9Kk0JfLleJ!Yu;-5~Mm7sIVM^Q2oiL>glM4YCQ%VP%DU~%pA=TkF)Pz(I zEvXvOUC$!Awcm6c$?XLPZ$*Ydg@||dn^-M8%VBuwH{I;e)X8u9q?J=hP@}euZuw1d zd;KWY^>-IWv+_4_;m3}|f0P)A{t!ksC(H;j^IomoM)xUUj%RWOW=2pceG zvkj084wGgy+%T55cp|1-!O=_j$e30=vgXPfGq6c(#c{=Lv~o}2HtTwiWwl3M>+!9$ z!DZ4q$L!&2)Cz3T)S>NRdroPLtnA}4jJ3=PR=qWg(6#MlkL2zfS=y!B%lkmm6LRb% zMJEn8IVwYNvId-rJ2Y!xES&deVK!~yJeD}^Jq~t-v~UDdI$Jo*$Zv2MURpT!IW!$$ z;S7eUwz&0`u+&@SxBX(ZgkM_i02>;YDyw>{!tNaX+FL%eM5i&mcr9P_^;G)b z`IVz8>ni6~&fB_gdADf3(L0-z)ier*I@6ldruA|COMd0#+m|Y*-o7LndeqR^0_NTh zG<*yio^d;UxpFBM;|r@IpDp6EmCH8VvvlXuRApsl72O{=RoSc_^v=5$aCln>43FG0 zWoDIpcWZ2D>Ia!<>M4N!d%6cB?c5cB{zeV#lgTI$AbFJ1ZkD^qB-6n_?T&~~&(Y}> zdnsM4ak;s$S?|ujEY|>*O8P$XOInp}QOwo`HwU7<})EQ2@N zTAV)>eP&J)uusW|wu$VfNq%MT)Qz^VtCFK{biJJYSl!0ck3NxqB{sC$TXPlfm6n<; zl!c`M+kK-g4)#I`u>(e1ed4lZVG3tfc2#O5EuSYP^951v9Cq|+?=G`HPlz5-!qQ2S zO4*9E3N08!*x(wprH<9gdf^tr2ds_CRgqQ(VYlW&*k&Sv z?G7`NcHUO~6|yKWqsZCNy;braWroxMUp2t176$NLddMtBz*7nE`SAg6U(;y-zuN*_ zwlILdI2YhgBf#$(8{h@5RJrc@?K}EN<_!jTyOo*11Gy&fJ2Zj&$2NguM44i#Sq}PU z@IEtxNHa5qKg%_RD`^Vv8QT=rkW~+-rVsv)8~9Bd1N`6T0{(Xi_>YYZ_&1cqZD3RC zv|_5KrBmZjzNp0!?X>6A78kJ~D2S4m1+^uI4|lcfKPYG0!bYT&L(3dbv=lSSL3YRN zN#ka05H;mPt%v&(pdTab`5}*)6est?skCI$D?=mS&O#%0)NTur$v2oxQloagyAKO| zL9ZQpKn&V{o(1jN{9v5_)PXgn`5~6a+5F()zv?i&G(W!R(6mpl3nd&?>u)Hr^79_4 zGNK>)!-D4fWJDjFMn?3%GQ@hpNjY7BYe`0&i{8UrfJ4uk()K;{fEcttISbmgj9{E! z#yEF!QN;2%%LpFca~NLAh_f7;I?0Gj+d-$>Zp>B!Y^Q0*L`4|jh@hr-onOOIv~-AV zFz0t`9Y-a9@!+9T2afUAV+RhS*es=mS@vp{Ww$l*b;NA}<2zj=pOHE%Xv)D2445y- z0;ZSPoY9fp_G`Fw|_PSiPzivz@N=CSE8+gNqW`S)&5gkl6; z)DJ_9=1)!fq9XU?mxhGiorQ#KO23|{=$*WF>6HGAG0k1gXl&ydB>Z(2BxpWj41CCe zdLrRCTJm07YaIq@f&6?lIUc0tu@ z#vIC(_q%>XDFU<@h&CC=&m}?62G=={+jL-l!s;tg3)ta+dDdp_gW$to91 z;mrFy{7DYOOWr@up{Wz^A2G?U=Vn=Uo3k3kS- zIVBlmY~vX|dT$maXg*>Lyvu=lB_9c7Ir9+@f4{@*~LK=73+y4 zyUrh$>=MCCYik8_{9O=f(CX|8Q*m**S7N_PE3LzpE{)g{58CKpL|y+`d+qe&&@x_Aj@`cqxvd19tZ zyox5e#Iy7~S9%*O(Ie6ry1AX@(ht*;T)I(0j;rroe{MuK>CbTKSFr?_e4d!!67S;a zE%DTvbTqp)SvR`((@JV-%&Rp$%+^haC9vVLQ?sSB_C}4i&ewGPoV~S^UF3-lv zWfl`3Y`DY{Sv>sl4#P`hO6ji(@4Fvq3)>BZkF-SA)?5gCB`yE;4l|NA-*x&cSrS=A z1AKoXtE`92VjuJf@H@r_cyc0Z(E_|Lk@dn{fWL|W-#a$I?GzQ$huMGk9}MtzE5l>2 z%Qb;l(*#~Uwh2TsRIwSn)65{!%uL}=b4}qjG=={-wkb>!S^nXY$ol&%^k4@fUP~nL zF(!%hK*XVnCQIRes6KC4?x8Fw)|#2|`*{bJlVJ|A6waENhyPoL;iYE&Ylo(NDsPg= z5?9R(*|R!w61zWJC5iv!{tTQIXjpq%P8)cMcz-2&53_*}74sc7ynkjE6l>mR{GQJE zb+XFEQaJNI55K};c**;}85i##F^Q}jvMjr;RbNk>^$cE`bgeo#PbF!8a08>6Zp#9u zrp`AIjKA+dK2kG@={Qp-qu^SH;U#rm<k;Oq273+y4 zvepkvWO3Zm%42bdv^xyA%EN^T4wmWZX>y`~Fte3mLA+pbBA~H&K zeOCA2RM(rMsVRC>ZnT|{5>=Pkth{$!JQ9?LZ0p#^Ou zX*9uuU>K0ek3nHs_7uG>N?SvdFndkPgU*Dn;LxHuzmBtrJX{Vjr%v{?4t^!k=BZNz zIl(-(^vg5H1&fkb;~UTjuvL%A>2AK8R%QiyOLz1BH@>wlissXQ$wFHc}#u&#~eUU>N5f(eG4bh{w+zY?os$h|y`@R62#xiS~R z-b-|_*#TkFOu0gTB}?vQhXKAn_wp<~WEQpcJ_7va@c}L~D~w{3zF4pTmn{s5)^Y*< zegeEQHo)zyN(}gW4Dfa z|3-)5rTTllL(@LJGD&b8)(MVpW+6;l9(;i0!Pl4~(&fPspWyge78GmVXZ-%yf#W3a zi=}YpeIEYH4#P{{f5@S!6Yn1}36Axr=k(?N8*$bX(0f?waB%)YYQVt_jApt#3z(WZ zKS(fM!Z12HW@0+d)X69~$6*UA)PC47$Z*A z{Kq<`LB?NaL5Ai|#>9slctUcgK-yqVhy@^d_;)xAFS%23%NPQX-ynRX1t7nf3t@jt zr1Le08A&1XW&M>b0mxq(;QIrRztTfy2|)gL0{rLW13WnZdBPbQ>#O<#kSEbgzEUp> z;2$Nxk3-jCL2NgSui3g~Hu3I{^9|^xjp47UT)=;ffIn|+z)z~C51Xp#>$1>;t$aRC zByly9M7r`h;sXoM$%107(ip$DIZfyAH!kmG)GJrhSrY5>z~_gNpZN zAxxY1|ABb_rA!eM-WM08+Mc^r9P~gI6l>mR{J!3S<0S8krEunb9{wJO;U(|i>Cn`P z_m7yM;y-3tcAK;QkvQw`7~kofH8^INA*lGJEMRKt{3n9(AqSd})G4OpOr4B^k2wr4 zsq=3fnmSSEq-r`x)%3BC&EO2#l>RBAqBZC}EPOt;5a59eDW07L37U@>17|V@oPzTL zS@E0Uh>g$ho%GgXfRC4Aw`Zps31wCYWlKaRnyb*q!wJRjw|aaJc#S-tt#p( zxHfUnMfG%tk{JLMjUv8S_csi^!k%l6Q|hX(8Cq9;O|u<%SNkC@YTkjO$!gfCmi(Hx zr5*U*RH+yO2uY%28O!+mw`L+ws<*yb_uzW#Pe<#mpDeGz0Lb|&t}n|qfMr${HGEk@ zFrOijqox+Ax&8yb4+HZ_I#h_3CgDsWew=uu5WkUR7Rp-;XpHz7#MUcQi==4aa02ON zOZP0@xdi03fcGqw$e)X1d}!|A!)dX3LaRk@iP;0sFj*m)$u@d^NcX5!8|K3FXYKH= z2^wKH^serL8@n6Swdk1+K1sY2{f05lNRh@^#}sQjg~feY7N)XQ`B!L_??LZjs=Rfu zmqcOg;D6Yl_4QfMs*Qs$6Hf1AoH`i?0{w#(aV(?3OLmvT@X|O?QgaL$jRy%IX&H?V z=R(-m2w@*`n31$${!)J>OGe|f2KfGr#^>~qS+vsE3Gh#k5AfuS#=lsA_hmGGkPGl{ z5a8b(8{h?!@5wohWoH_av051(TR{ynr(_szf?}=K7{4=&UnjLDmcm)B@$ipz7+$Ki(;S-i>5EBLRO1=J8;j zHJC?(sZ_(T`@cEnpOWv`HZ({ECMQ=+OcH4fV6nHna=lw?Y1(;97UXFfzAW*k z9}|13sYS9N{~u*R2ps$DnaI&HB4d%-#5&I<+S)#UMvahm0*z{ua0X5MRsSh8szv`f zH0q5$iAKeUkI>l*1_4R@9;hixZs%uFIvSeWc}H3%gjU7kqQu-zA(KE!+b~k-R040V zS*tboB9H9t@!M6uSPR0@6iD+}thRr4FdTb=Rd6uA;89&ACx5;D9jI~|6XR*e$iV@Sx{Pxwen$h;vJ!j>Ne zgx%*bBWZm72mO^S37Pj8;QJFY@6$tOQIIPL@OO<5@Z^Nd$1K465;7mp1^7_}_4^TM7Jf(6+rmFAO?fr|Dhi*FqS| zi&PNccWa#)p#ZG&w=T{;hLUP|x*81rG#3U}5(a-X0tN>QtYnvmxm*dOh|6>1P?x7A z9E54q#gKzA?JEaix@kEG(?o`r_p@!N_an!pJHOfS(BpdcxXSSu<_NLbpW+BTbEqR! zgQL^wmV-^TW@Daz^NP)GqfE9(vANHiDlX!G+65ZlfQFjRI4i63bDHkK&d-{o;40`7 zx_VcL3NC^^*WGfL=IL*_KId!bvPkx|#2sp45!dIXl?)q$_5UKmN1FA2PcDR=P6)fxVMfyWe}Vo=7VH1@ z2KavK{}1($S#-o11o+bU08h65-)jNhXZ^oF7vPU2z~4PKz*pC+4eS! zxo%>(>+f=bekOtb(eZ-bZ1jQtr5Nbc#DM;lT%bRWK>z14g6{8wmDmURPi)X-69f9s za)Evpf&Opf1wDaa)}E~e%<4KorzQsUW9V(>%DuA*^wsFjdqY+{60j_%X%x?P>*SU0?Z?vIv0mHE4;BI>XNQ%lNM&uE29f`Wg$$P z_tz2c&of0#ct7<#g8wHAiZ$;ueit1$PV&B33TNKu;mZ!gOWwc3p{Wz^A2F4C@6EF8 zHfNnjob{)S?{v-@OXc22vVf_nb3MWMpaV@v>J-y)rcOq|e{vXJQsh^w=g@kNMzksOd2fTLal>P{)+go-{9;b>i@M{O^m3$va7Y$2Xampqo zapkoZ{oSG8s(M?iVJWE9{6^5k9_TrBB9a*6H>IO zT=eS6P_zC3_`Ek=mhPCU&9?;NMo0pK^tY2e#6^x^Nuasub+MP z#a^?x5R^L9u<7|;%Wssi@10VW*R}n6FjKgduKB{h7;dgx^Qv?Fef-tN#VC952?D3t z?XbTjh^M8R4wz!Vs4AxUcb@t z7P?^vd7Q9XZ`Fc6NaaLkJO)^O)9d)VFjBKYmy|UEUBV>;XID*-tO)3UAlWd-j$F(! z6Jw5F#}1T^c<9H1s0B4|mIt$2iRglPsaW2AWB{$?0`yV>w2ZEffkt0{MW!(ZXN!_m z5r5E#4Wr3=n(?M1f^b@~L})1)-FA@BMBDUhL`e)=A3sZpA^kbOHqDm=Rs;LPx}BC} zIN`=>7yW4EC=vQ4T;1>^`-7E}Z(pjMivMJX-m0+Kg^XLOoZCBcNHXF08c5}WR zgdxr+nd+_VG&_E6>4s&!f@%|#@n;w5w#xF}@uhCN9W*+#a;$B=W7U%yjsscR)?0(R zpbpA1!lm9xe+s+i}~KSB#fCULP6W_ zG}{ohn;q{g+i@*9bH2V`8e?;s0I9FmIU-{sfIcj z0FN)q4*J2d?V#0ccV_t($E6!q^a>TfrvF^oJ1N*#1=g@Fp&P13D|;);L9siJ@s8i? zw;RA3T3~}g9Z%K*{iT2=wRCUq_-X@6WEMv)HL2ufskgSehFJJ3uw?IeF|L6@^*$^5BG$QgBF!NL zqAEa94Rc!R9S1vUzKf%yxHN95w<2gP^-gIA*mF^yEe9=73O++@v8}hN)NIUQn!rf4 z3|hspGy9e*t9r-#-A;4XJnF5eg1n9^ck8WLO@cryKTx`!20VeEFmcoJn@6oM=$4za z`|3neCz44N2D5fgrjk-;c26~|3KBhGwpP(+W3l+Jwj9Olz@IX*On1#I10MK%_ z6To-?$1U~N;Q93Wi!KE|k8jVFV#CuDGyM5#c(TcfWOoJanQG9P<8MF!Y^rqXHGFJs z$1j45%ALy64QqO5gC^^3nFK9^eG-jK;x`Oxb3&}`?;RC1_AG7d7JF-iI065H6sxFn19Nm{JAQjUfOrDo zoCKgiS{=w&jDgxq65qX(BTpN!Qu#4Pn^S*G^-d?txrFMu4mfPKxX4l|nA(707p_Jcg!rRec;ZF+7mIdA3Dq_YmeW7v=^vs2R*jr7X5znS7AFcdN z<$aZRFZ{o&(C5?i<24W@3qAVr!PWTj0s3+K8vJ-J{n$u9HqehJuf>nc=*K_NpMOCg z{W<;i4EpWcC*a4!^y7yo;m7ys$5&6mk1x@W|A|{p7d}Zpw&7fog&XL{6v{al*3*xZ zk*r-ffqp!Rz?h*Qub>|<#gA@pEy3SeY%$(2gZ-8F-OKRrXV~{M-1`~k{S5ED4C{V| z^InGWUWRW!!?vH{+RrfUXL$BAEc+Rb{S3o?{{H@MnuMp@+( z0$*Ps^fA7^OTRI`9whWJzRo4wFuv~4`1%`-ukX`ujIXB>N*Q0@BlI!8{*BPb_@YbL z1-|HDL4hyYiYM?z6{-SXDl4GU8hGRqk|hWPE7ec865`Y4Ne-8yGxLCd?M3HIJcvRf0od zP^`X&*agq;1F^qs=@tmamfwbm1%rhU1@ytG3Z!wk7($M!$J)xNtn9m$cy4<$466|K z9?KRF#jHV_1k^^jqu9t(fi-~*Hf?qyxd|Lj*al=6-amiLY(E`?IKe%p07 zk!~RCbL)oXmX%8dVjh98eu22c*vV*ydc7y$Rn%v)e4-;@b+%+)oh!4h&cajCL#@sF z70GKulE_+{_1GeM#IMb5nb+p`M_QY01J;IggS9r>CTp{PVQ=QO>5Q~Cdj_lxX=`h3 z_Dt4h{le=qugz;lTAQ~HSQ~XPvnVd!`qs(XtY3I<=Cyg(NNe-i0c)cUmym1o*~!|h zU-*a2YxD7u*5)Sz)<*4ulWX&n$=a-6_-5v{`T9s}Q#dNwPE*NUxi$rgZud^saWv)g zkSmmGze!K%s^0W7VZoEjvkR#x3T$}m5a|f^O<%N*vTBIidO9vto{6@u2 zQhfv3{W>2StT4IoDsEVzJPEiay<_x@IXH7nwNa{JVZI95u^mZ zhn@v6h*&^C5J7=ZOb`TAP!tq|-@Na(+3a2}et!AmKG~Ufo_U^k-+A}l*}c2I#CP6b zK3=oERwR<$UgHE$TP<5lI`JWi6E~dq6gLRJLQAI7;^+9xV<;Mp*O~@eTEuxVtNdJX zQ_@D_B~DDPA+{SBCtlj@?UI$dQ88O>`pYd`ErtXo1@hdrFooQEVqEa~kT6iTX9 zvnAP*Z7CUxSXZDUseS|+rO8Gc&ih$17P78dg$%bOX_Az={7mb?jbgBxT2;H>#8%SXl7BG&C6!7Szjo!SLd1vX3+_8 zq_&ti+*6Eh^gIcpt&fptacQFD4BCwQc`NJ zWEGq12c44JEmMf&cFTC83HX&4u!4=a!3p@mC;&iDa{^Af79h56bIlJK z>Sb@sn#3zlCy{i~yF+iyTv>l>89)PZV{df<#R`T61XD+Wjk1Em;K0Qaat!L|DVS|Mmu-P&ja6>n{1 zv&`qcm231C@SnhYYg{GX5+iyPnL10{-(xum6MOWm17d&F#PTt*jdfjMbTO+yOo$hH z-Us_XWP41J@3MwlJn0KY(tvc1Cw-LRq$AyA@V8+9Ay3-L8s6tgZ!(ewq>Vi3H!36TJM@@2>6=5p zVx-?6Ru4#AHz&Q1b^W9x9W}15V?tINtOV}!%s*zP_ju+%8JPoI8PEJ;Wz2VtxNXk- zy^+@$^9`erd3{gQFh9tqO7rBx+>t(d8?tUK4`7jP%_w1JEj&fiFiELk(mXM=gSiR@ zuxd$0at%`xk6Z=!`7thBzTXZmUo;kpXPXoMl1*mU5sw--28rkK#6M?dGjzo5M&f`q zT1T7}O-!pR;;&>MH~09+oWtzOvAmxUBX*q-3<0ytoc&SOwOz-)WWrcve}HFygqiKv zvEOcF4_I4u?BA}Gef`|+=In3gZiVX}5#s6OYa|Tl|87qI1nc@$N5B5$WTfxmC50JA z%{R=fnin56zZ&TS)(su~tCiC4F?E?a{X0{au&8-uT5}-&gv^7L==`PVJJyx%#f7_= zIK2$)JMz3wv4-|K-sxV3Xa}eUl93$kb@0eV&^SC_PH|Bjwwe*k3J$UVOw5Z@%$c8O z(@o-;JFd^1Li||kLe`p_Wh)n_ zjuUN5LxK1*bK*BySAjwttISJFzXSV?JnVI5Drz(^dB@_FL(@j$s3r^O*cZSmN$ z;DCSS8~+8cJ0RX%_9IMpR-MkXu+Wp75xok>LHiAT`!#V(;aX__TWx3i1b?uGYvL>7 zD8Xulm}-!caTl7HF4zKK6|~unve>eynEB{N(QW{Y!;!cBz{yr|{FAB?=uur%aq={_VUn}DcFj3V zJZzJ&J1?Kfxg#fK4;w$SMUlEOFjqpP-*gcIyZ|u|n8nDhsRBiXSSYg~= zG2o5E!Z~biXz`Pq)=dZFpEYB#WStk;>-c=#x1P}RuhwG;fiZtOet64UfJ=g(H{7A$ zdHYlEQ1&0Y`%D*0lH$aK&0*>tXiJYx1uew`Gg|r2==x5Q$Xn7O?adY;jGtjX9T1z*Tr@IG#`Wg_Rj zRys6W2ooJU1~bQn?3@atN2;UIaam%?&h^lqtG4@F(f~EfvA#G;5awWe!{B<@28yK> zcF%Ed_hUXVQshRq0ISy=_Kyi(e>QSmZKSSkd!?>ouB$zEi8uG%4`;&(dD5~E=5~nfKPiN>07toaVFurIlmNm?3dwYF?VjoWTEL#==IJ6)$T_f^ zz(hAIPSja!d$6hH8cyVxd9Xe1$iSgA)2+{{lh+)NK5K&~$je7NLA@p5Szp#c*`Zw5 zK#AJbukM1cYHB^!!PtWlkQB_FJM>|e*z3qxcGmVE!ANbZj>EIo+L8TrHU{c*QU@J+ zoJi}jhZtO%?A^_WIjfevwWHICab7U7O$G3`jD?9?i+`Mc0eYrzJyWEfWoH@@4@b$F zKo_N0+4ufXirxC55daj)0IZ0N(soHRUk0pYjEB0R;h2B+7xd5D>XgCcP2j8CE-mw^ zSU^fJOHh=YNAuwzTFy8NKqzJ$W!u*=t@OCX^djkazI>O3@%F#*B=A0M&U*v!KB@3- z6HekCTW%b}Q+`$D?H@1;%*rLRdyYN7t@RA4kj_~~bqu@njJXf#kT}wVUTQ(CbboWU zpLhT6cJbH0yjjV#HlE-eoz+(@mw2}>g?T-EWw*kX8m*r|TIrznh%t{+XpaOErEA`y zZI4FD;2X~STk`=i+?T%r@$kj-5Tf0-X5zfn&`K$<9>9qRluyLpk}EtM-~H3kT(YC# zgQgHRqy9yGUCi~Z05%<(l7)Msue0V{5jQs3f5wf?82ff;f84$Y_6g-H3kdA$8NQkqWUY{4iB!5CM@RuNLEteLwvc69m*Ei06 zoL}EZDqr8u@%|*y({zD5HwKX)&+1|9gea9&K`7lFL_+DwFp><5-pkK)RlNrih@Z5o zoNUowgQs8i2-%t~lYqCtBvdlF=gf{G3k8!E@3h8}4(9RiWJ|s!TL9_`Z(`16CrtF1 z%!R@Vcd`|pN|Z(YK#TlN8b8asFsuW;{WMY2>0^F|bc*1O&`Mdx_3%iE{4{A|59jon zq^-G-3JZCfxeRpai@XfC3pt;Yvm4|r(8+nxC;^Yr?%jO?Ea(!`f`qUv`dzc6B&-KYZ4;CKpq)U%fE|~lEE8u)q z@he=PoV^>9XpGn2GzSKJ0CqPeyL(Q@#)0Olo zOzY?G^7>S+gt2yQD%AoyQ3i$U(tbdS_lN6}xBNiZkKP_klKFFh(|MzjkDSRp@kohh zB2n?6ES{Iqwi(2m4sA`gn4SW$;e!G&vCy4Qk+-!=RZnxNcqTG=sp8##r>OvMtZc^| z#$UJ2adl}Hr}Pjg9img3X;6x@b=4_-Mj9fAI)NcIT;%9|FvY)yNXO=z`ba-39ddit znK<_u-7@uKOxu5eY#vJN^Jkp)D3D9aM{&0JLct;w>U1jxU1QBiJ)3Y_<{E-Fg#NQwWm z5~u%H{MQXIUFvv#Y6oyj{XfKiOBoYZ`VXMASpZ*w)($XKpg3K!WF;^48hGR_FMzYS z0OHMyloK$=X><*LvxUuv(5*_6aTuJ8Gw;$lc{?6e68_F1WGZp@`bqymwB0NcxpFx1 zcTO5c@a>29vk2aoEi-p|Ip`?ho$j1IoGivgv61uXC9qqk^J#(6r-+uX^XYs%szjOZ zX!54{6~kF#BkQ2T8Db~7u&_^>Yq$a2j_EWs8%stJwkjJhWH&TJN0UbM`ZzL(UK&fB z^x;Ti0kkqs-c^9Oq?32dC=Vw(qLcT9J9)u5jXN;+XU38&A_BL4K&G~!F! z&67wJyTOoDAD=+}px?Ym@QHaX8G|hk z%dapniEf;%Rdzwu4V4|j2cVTw+4v|>pQKJmcEd*L}@oTY1P2) znoinjqclYORwwN^9#s-}6JI6lA&aSo*aA`r8g?!rZ-a)oK-1Oa3*4dt`PKB{QZffM zG?0hD;<12TT^hVzTRc&LhQ)(u;b^5So?twxL_^y`a>vEiK<5?YhQKsDv5L$E4TH@! zL;$yevIZwB8YbdiU5;c;H>@MUWSoxrKqGYo>8GRK+a2|3>&cHU+@HOXdCFzQoG-h_z?o(0C2f+7c9xafiv?dyA%l$B8d_ zg(f;k6cC%op|k>&+3rx_QF5xVI*4w(E@@lKL9_-4>K1~%nVCj*(e-;sJdpSwhwv02 z>~xF3p2pWAU(g}%kr+VuibH4v2#4Gv{PiAr*EI3bJ@1ouSd=O6@m`g&D{QN`gK5h6 zD08OnWqAVV+~eq=-JeKDDQwFsh8fyiLL24g`8*yeSx<`)Wp|y%eB_G%_a7mDtTlF&#Ikbp<71*~i#bTapUdVs(- z>*=Na1m2Rjk2UB24DcV#^QZNz3+-UU42?bwV(-8U({=Pm8|Wj}2p#>QZs^nVC1jF0 z|L*6>M8;ovBX@^6|1Q9PtB!x(rvx7X?$`KR(d=U#|E&i8XtY_!|4r#g&fVRED7i@L zm_OES0Zgvb{-2STSt>vEnN*Gasgl4{{ySZHNMh#^BE=Kr(45bS7x~>e`E#<#LkPx> zhABM&?{}uGvQ$3)FcF!P$Pt21^=r$Z6&BerfJzGCf|N#lP4G!vQ;mid&7KJ1?^}~X z4EL>QRRgV*WUjDupUek^sL6aVH}h~HI1n+FY~GL2HOuBCmkv87W!=df!U#Z^=ng^6 z-NLIOw5EeZLYx;!F!0PVSXkr^LQ32lL)66m7RO=~uvqUF0us0IK?vQjhrpLy>>p_m z^wu|QrM>SK;=v8F!F=89x=G&P^6vLCc7>1_158iJA>m}N{6u5Q{aIsTMU$V9iLz^a z$`}r4bwaX|ukAyIRElSfd_CD3mei2% znH$qW`B;t!HN-Lkg-TX3`9M5!O}@$rcaS;vY~bEs=1#G!QWEZXjlVSq%pcT~#5b;Ra1nal*B60B^4JM7> zX~&Bsk0sng7YV*2^pnZ~6K)xue~G*Si|mfnL3>oQs3Aqec|66)q@AgYXs zsw~;Ix=`{4%_NhKzb56D?%c$Sfm#MaDrvSeBWjjr6GlLXi=ugy zgh?m-%v_n}4o^$EFNdi~cP2+`3DBDE4h9o1DWn^&OTvmcgr$J6%q;@u-K}A2-rdGQ zyao{OxP_>4-u+6(u8?<^!!(EF=+IKvS;-on`3JLL=0oF(IPsW&$!lbL&ilbPsvKoxYh8; zHT5cGTp*Ka%6ug-?;k0R*Q7>=SfF$f!mqIn#%$gvqu@N{tubSLbTu?vI9t*QAl9A zJw+$nCluPRDDD21H$cKEXQu~*?GF9{?N8J=#S~SRYY#jmi&?JCd_;CYuJw*EEd;g! zvS&nvTpKMLLsX(gLVt}!`gOMuTxe;omJD-Et1rT%GLR5Ks z;4K-uLfZKsOtYRl!ExH{^&XB6+U-UVi(oSvOj$lt^KNVcnrsJG4^PU28m2)}5xmYB`X#Ehkgsym``VoQVc`Cy%v~!V!TF`q2zo0?2qtHB+`lw(N1#JG?g!j( zuUhR0RH{dtX6&Ot-Zz@h*h<2yA&-DnfM#*DXS$ZLeWMMLgH~3wQX3*m8G;Zv^-Tf1ibsIEUXqa*e z8=17qs>qCb!U>i@IkrTbEHU$mM)KjCJ+2s3|-m`Vcupdu!_^T&r>r=Y_{0zJ)PUINUM?l83kdLvp* zpucc1mjUKycQCY5Vo;D)DXjFy6b1cYjIP8%%+n~AG(0!@;!E1cwVm?j~n zVgh}fV}d5>$V5q?2{DFcfL5_+r7VL;JW>*<#{R!2&=Kb3uLAj@2J(|R@@O(iM}DZ0 zJX*b=BR{|m`6?&S&F0*H2JUal-1Q06$??AqW_xt}-!$?^u=P6rYu)gtRjwMZnG5&@ zn3d}UC`t5hX#@>w!>#~->ByHG$s-V}gIJ_1ky9#-krU_#ESf{z5FSFa8y11RID}N&;;l zvvi+8X{?$+S93EH4>t1(#8eV!VMRI}ddVxdo1f;X>km%|R>9YGLH`EJ;-o~NIrh6g%>RF+l z`D0FWWdj1fmcOjh!O|YY3ia$2S zRUU?IdkV!Y3~%)mD9n~2gH{N`aDeK>prkPDC0qgHK^g;kt2f(|84w2%sJunciPn5h z(7l6?FdfiH3BX91pZfru!*)dFw^in96I&yJS{`C50XU-~rV@awpuTjZz}HoFb12b(vcnw;J>6GGA)nLxeT8Un>X#fs3?O{w7J>ahN=l7VO`CQ6 znCx*m+1!`0FLI!<0D8_HDEpn87`m;W;7jh%iTx#Ne{m>rfbzRL6lxv7#QD+s10;li zcqN$qY2E;Kd*?%M57(*_vlCb4>ZG2GT_JR90MXR=iq%Ogjfn+Knj;gXI!TQ;R3~V~ zz5>MfD%Y4qJW{F?js1VGPR5&)PXh8|4CH5VjeBHjghO98F7_VCz#+O>8a7e0d`qfX%q4wO*B_oV0F@jK08Lh-!W+f>&IV1m)^b@g+f)GKY>Ay1`U-ZIty1Kpd5TX3b6FMYY$R%f--)0Nn3uLcz`$S=lK=PfPUKF|!EBt)nFzJ{1{EFb4vG7}c z_Dyu}WTAH6L0gHf*tXq%3Vy-j1bi%Kl<3 z0cvjwA4lO3z6fi-2mf`3|E{u^B<_&`@{vJ4&Yq7m=i{vTIAi`~TM+#CL4vIbb5s-CcH3tAi9Gn} zj>D3V&Vb9%NAQCll8^R+%g{%)z#r(NEY(NwqY9Fb;8zbMAGHQIqL1L^Qprc~W)k`c zAMQ&of?Zd8YBKl;?#v}0L5V5(2(I<^1>mSA&O=j$t%Od@6KvXd`ci8sE6d`^zHM29 zMOgyPo+$*=jxPy`aY;3pF7|U1jFz^+nOTRhnk1Rdc}ZAY0q$uXTw4_`qm;Ft&7wIsT>o7i?t&vjp$))lubDc|4#X7+48lcXZ zCtWyGzfY5S(&aRVb<=#IO~agdd#=V?f8Ub%yGy_;I=~-wfJ^3U&WxnH=L_{DXU5Wd g^M!VTkjRJQBW-9r#*Y>?awug87(R5@0-?qK0Z1b-WdHyG diff --git a/docs/_build/doctrees/manual/pyaqsapiusagetipsandprecautions.doctree b/docs/_build/doctrees/manual/pyaqsapiusagetipsandprecautions.doctree new file mode 100644 index 0000000000000000000000000000000000000000..a2a6bfbf81aab969cf206ea34f97c0dbc7acc7c1 GIT binary patch literal 19971 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 F{y*Th=AHlm literal 0 HcmV?d00001 diff --git a/docs/_build/html/.buildinfo b/docs/_build/html/.buildinfo index 4368c13..7c4ba3b 100644 --- a/docs/_build/html/.buildinfo +++ b/docs/_build/html/.buildinfo @@ -1,4 +1,4 @@ # Sphinx build info version 1 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 76a68937cbe1e6a63755071eed15d2c3 +config: 0abb323b0f8e893bc66a17fa59e0f212 tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/docs/_build/html/_sources/index.rst.txt b/docs/_build/html/_sources/index.rst.txt index 5a0fcb0..14fcd38 100644 --- a/docs/_build/html/_sources/index.rst.txt +++ b/docs/_build/html/_sources/index.rst.txt @@ -1,27 +1,30 @@ .. pyaqsapi documentation master file, created by - sphinx-quickstart on Mon Oct 4 14:40:23 2021. + sphinx-quickstart on Mon Oct 4 14:40:23 2021. You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. -.. sectionauthor:: Clinton Mccrowey epa.gov> + +.. sectionauthor:: Clinton Mccrowey clinton epa.gov> =========================== pyaqsapi user documentation =========================== .. toctree:: - :maxdepth: 2 - :numbered: - :hidden: + :maxdepth: 2 + :numbered: + :hidden: .. include:: manual/EPA_Disclaimer.rst .. include:: manual/Introduction.rst .. include:: manual/TimelinessofAQSdata.rst -.. include:: manual/RAQSAPI.rst .. include:: manual/Install_pyaqsapi.rst .. include:: manual/Load_pyaqsapi.rst .. include:: manual/Using_pyaqsapi.rst +.. include:: manual/pyaqsapiusagetipsandprecautions.rst .. include:: manual/pyaqsapiFunctions-Long.rst +.. include:: manual/Troubleshooting.rst +.. include:: manual/RAQSAPI.rst pyaqsapi API reference documentation @@ -34,3 +37,10 @@ pyaqsapi index -------------- * :ref:`genindex` + +References +---------- +.. bibliography:: + :style: plain + :list: enumerated + :filter: docname in docnames \ No newline at end of file diff --git a/docs/_build/html/_sources/manual/Introduction.rst.txt b/docs/_build/html/_sources/manual/Introduction.rst.txt index 9de92a8..6e3192b 100644 --- a/docs/_build/html/_sources/manual/Introduction.rst.txt +++ b/docs/_build/html/_sources/manual/Introduction.rst.txt @@ -3,19 +3,19 @@ Introduction The pyaqsapi package for the python 3 programming environment allows a python 3 programming environment to connect to and retrieve data from the United States Environmental Protection Agency’s (US EPA) Air Quality System (AQS) Data Mart -API v2 (Air Quality System)1 interface directly. This package enables the data -user to omit legacy challenges including coercing data from a JSON object to a -usable python 3 object, retrieving multiple years of data, formatting API -requests, retrieving results, handling credentials, requesting multiple -pollutant data and rate limiting data requests. All the basic functionality -of the API have been implemented that are available from the AQS API Data Mart -server. The library connects to AQS Data Mart API via Hypertext Transfer -Protocol (HTTP) so there is no need to install external ODBC drivers, configure -ODBC connections or deal with the security vulnerabilities associated with -them. Most functions have a parameter, return_header which by default is set -to FALSE. If the user decides to set return_header to TRUE, then that function -will return a python 3 AQS_DATAMART_APIv2 object. An AQS_DATAMART_APIv2 object -has instance methods for retrieving the data requested, header information, -and other metadata related to the API call. After each call to the API a five -second stall is invoked to help prevent overloading the Data Mart API server -and to serve as a simple rate limit. +API v2 (Air Quality System) :cite:t:`AQSDataMartWelcome` interface directly. +This package enables the data user to omit legacy challenges including coercing +data from a JSON object to a usable python 3 object, retrieving multiple years +of data, formatting API requests, retrieving results, handling credentials, +requesting multiple pollutant data and rate limiting data requests. +All the basic functionality of the API have been implemented that are available +from the AQS API Data Mart server. The library connects to AQS Data Mart API +via Hypertext Transfer Protocol (HTTP) so there is no need to install external +ODBC drivers, configure ODBC connections or deal with the security +vulnerabilities associated with them. Most functions have a parameter, +return_header which by default is set to FALSE. If the user decides to +set return_header to TRUE, then that function will return a python 3 +AQSAPI_V2 object. An AQSAPI_V2 object has instance methods for retrieving the +data requested, header information, and other metadata related to the API call. +After each call to the API a five second stall is invoked to help prevent +overloading the Data Mart API server and to serve as a simple rate limit. diff --git a/docs/_build/html/_sources/manual/RAQSAPI.rst.txt b/docs/_build/html/_sources/manual/RAQSAPI.rst.txt index d49bb65..41d8abf 100644 --- a/docs/_build/html/_sources/manual/RAQSAPI.rst.txt +++ b/docs/_build/html/_sources/manual/RAQSAPI.rst.txt @@ -2,11 +2,10 @@ About RAQSAPI ============= -pyaqsapi is a port of `RAQSAPI `_ to the +pyaqsapi is a port of :cite:t:`Rpackage:RAQSAPI` to the python 3 programming environment. For anyone that is familiar with RAQSAPI, the pyaqsapi API will feel familiar to you, most of the functions are similar and the parameters sent to each functions are the same. pyaqsapi aims to have feature parity with RAQSAPI and neither project will have features that the other project does not - other than programming language environment or -language preference there is no benefit to using one package over the other. - +language preference there is no benefit to using one package over the other. \ No newline at end of file diff --git a/docs/_build/html/_sources/manual/TimelinessofAQSdata.rst.txt b/docs/_build/html/_sources/manual/TimelinessofAQSdata.rst.txt index 6b76349..03a6666 100644 --- a/docs/_build/html/_sources/manual/TimelinessofAQSdata.rst.txt +++ b/docs/_build/html/_sources/manual/TimelinessofAQSdata.rst.txt @@ -5,6 +5,6 @@ About the timeliness of AQS Data EPA's AQS Datamart API, the service that pyaqsapi retrieves data from, does not host real time (collected now/today) data. If real time data is needed, please -use the AirNow API and direct all questions toward real time data there. RAQSAPI -does not work with AirNow and cannot retrieve real time data. For more details -see section 7.1 of the About AQS Data page. \ No newline at end of file +use the AirNow API and direct all questions toward real time data there. +pyaqsapi does not work with AirNow and cannot retrieve real time data. For more +details see section 7.1 of the About AQS Data page :cite:t:`AboutAQSdata`. \ No newline at end of file diff --git a/docs/_build/html/_sources/manual/Troubleshooting.rst.txt b/docs/_build/html/_sources/manual/Troubleshooting.rst.txt new file mode 100644 index 0000000..6b4e87c --- /dev/null +++ b/docs/_build/html/_sources/manual/Troubleshooting.rst.txt @@ -0,0 +1,9 @@ +.. index:: Troubleshooting + +Troubleshooting +=============== + +Parameters must be supplied exactly as they are specified, for example the +stateFIPS for Alabama is "01", entering a value of "1" for the stateFIPS +may lead to unexpected results. Do not omit leading zeros in parameters that +expect them. \ No newline at end of file diff --git a/docs/_build/html/_sources/manual/Using_pyaqsapi.rst.txt b/docs/_build/html/_sources/manual/Using_pyaqsapi.rst.txt index b384238..fe44152 100644 --- a/docs/_build/html/_sources/manual/Using_pyaqsapi.rst.txt +++ b/docs/_build/html/_sources/manual/Using_pyaqsapi.rst.txt @@ -2,16 +2,17 @@ Using pyaqsapi ============== -For those who are already familiar with using RAQSAPI then the pyaqsapi API -should feel familiar with a few minor differences regarding how the data is -returned. +For those who are already familiar with using :cite:t:`Rpackage:RAQSAPI` +RAQSAPI then the pyaqsapi API should feel familiar with a few minor differences +regarding how the data is returned. -All data is returned using pandas Data Frames. Exported functions from pyaqsapi -have a parameter RETURN_HEADER, by default this parameter is False. When False -these functions simply return the requested data as a pandas Data Frame. If -RETURN_HEADER is manually set to True an AQSAPI_V2 python 3 object is returned. -Use the get_data() class method to retrieve the data, get_header() class -method to retrieve header information. +By default data is returned as a pandas Data Frames :cite:t:`pandas_DataFrame`. +Exported functions from pyaqsapi have a parameter RETURN_HEADER, by default +this parameter is False. When False functions simply return the requested +data as a pandas Data Frame. If RETURN_HEADER is manually set to True a list of +AQSAPI_V2 python 3 objects are returned. Use the get_data() class method to +retrieve the data and the get_header() class method to retrieve header +information. .. index:: sign_up diff --git a/docs/_build/html/_sources/manual/pyaqsapiusagetipsandprecautions.rst.txt b/docs/_build/html/_sources/manual/pyaqsapiusagetipsandprecautions.rst.txt new file mode 100644 index 0000000..0ca0c1f --- /dev/null +++ b/docs/_build/html/_sources/manual/pyaqsapiusagetipsandprecautions.rst.txt @@ -0,0 +1,58 @@ +.. index:: Usage tips and precautions + +Usage tips and precautions +========================== + +This section contains suggestions for completing certain data related tasks. + +* Determine if or how much data exists for a time-parameter-geography + combination: + + * Retrieve data using the annualdata service. + * If no records are returned, we do not have the data. + * If records are returned, use the observation count to determine the + temporal and geographic distribution of the data. + +* Monthly averages: + + * AQS does not routinely calculate monthly aggregate statistics. + * If you need these, you must calculate them yourself. + * These can be calculated from the sample data or the daily data without + loss of fidelity. + +* Determine a single value for a site with collocated monitors: + + * Many sites will have collocated monitors - monitors collecting the same + parameter at the same time. + * The API currently provides only monitor level values. (site-level values + will be added in the future.) + * For some criteria pollutants (PM2.5, ozone, lead, and NO2), the + regulations define procedures for defining a single site-level value. + * For other pollutants, determining a single site-level value is left to + the investigator. + +* **Please adhere to the following when using the AQS Data Mart API**: + + * *Limit the size of queries*. The AQS Data Mart contains billions of + values and you may request more than you intend. If you are unsure of + the amount of data, start small and work your way up. Please limit + queries to 1,000,000 rows of data each. You can use the + "observation count" field on the annualdata service to determine how + much data exists for a time-parameter-geography combination. + * *Limit the frequency of queries*. The AQS Data Mart can process a limited + load. Please wait for one request to complete before submitting another + and do not make more than 10 requests per minute. + * Be advised that RAQSAPI is capable of retrieving results for multiple + pollutants, this can result in the amount of data being returned being + multiplied by the number of pollutants being requested. + * Be advised that the AQS Data Mart API limits certain data requests to + one year of data at a time with the exception of the Monitor service. + In order to retrieve multiple years of data for these functions the + RAQSAPI library conveniently sends multiple API requests to the Data Mart + API server, one request for each year, this can result in the amount of + data being returned being multiplied by the number of years of data being + requested. + +**The AQS Data Mart administrators may disable accounts without notice for +failure to adhere to these terms (Though they will contact the offending +user via the email address provided)** \ No newline at end of file diff --git a/docs/_build/html/genindex.html b/docs/_build/html/genindex.html index 0ecaa5a..a740e2a 100644 --- a/docs/_build/html/genindex.html +++ b/docs/_build/html/genindex.html @@ -108,7 +108,7 @@

F

I

@@ -116,7 +116,7 @@

I

L

@@ -124,7 +124,7 @@

L

R

@@ -136,7 +136,7 @@

S

 @@ -145,6 +145,10 @@

T

+
@@ -152,7 +156,11 @@

T

U

+
diff --git a/docs/_build/html/index.html b/docs/_build/html/index.html index ced9773..8e40cad 100644 --- a/docs/_build/html/index.html +++ b/docs/_build/html/index.html @@ -49,11 +49,11 @@
  • AQS DataMart Disclaimer
  • Introduction
  • About the timeliness of AQS Data
    • -
  • About RAQSAPI
  • Install pyaqsapi
  • Load pyaqsapi
  • Using pyaqsapi
  • Sign up and setting up user credentials with the pyaqsapi library
    • +
  • Usage tips and precautions
  • Functions Exported by pyaqsapi
  • Variable descriptions and usage
  • pyaqsapi functional families +
    • +
  • Troubleshooting
    • +
  • About RAQSAPI
    • @@ -144,54 +149,44 @@

    Introduction interface directly. +This package enables the data user to omit legacy challenges including coercing +data from a JSON object to a usable python 3 object, retrieving multiple years +of data, formatting API requests, retrieving results, handling credentials, +requesting multiple pollutant data and rate limiting data requests. +All the basic functionality of the API have been implemented that are available +from the AQS API Data Mart server. The library connects to AQS Data Mart API +via Hypertext Transfer Protocol (HTTP) so there is no need to install external +ODBC drivers, configure ODBC connections or deal with the security +vulnerabilities associated with them. Most functions have a parameter, +return_header which by default is set to FALSE. If the user decides to +set return_header to TRUE, then that function will return a python 3 +AQSAPI_V2 object. An AQSAPI_V2 object has instance methods for retrieving the +data requested, header information, and other metadata related to the API call. +After each call to the API a five second stall is invoked to help prevent +overloading the Data Mart API server and to serve as a simple rate limit.

    About the timeliness of AQS Data

    -

    EPA's AQS Datamart API, the service that pyaqsapi retrieves data from, does not +

    EPA’s AQS Datamart API, the service that pyaqsapi retrieves data from, does not host real time (collected now/today) data. If real time data is needed, please -use the AirNow API and direct all questions toward real time data there. RAQSAPI -does not work with AirNow and cannot retrieve real time data. For more details -see section 7.1 of the About AQS Data page.

    -
    -
    -

    About RAQSAPI

    -

    pyaqsapi is a port of RAQSAPI to the -python 3 programming environment. For anyone that is familiar with RAQSAPI, -the pyaqsapi API will feel familiar to you, most of the functions are similar -and the parameters sent to each functions are the same. pyaqsapi aims to have -feature parity with RAQSAPI and neither project will have features that the -other project does not - other than programming language environment or -language preference there is no benefit to using one package over the other.

    +use the AirNow API and direct all questions toward real time data there. +pyaqsapi does not work with AirNow and cannot retrieve real time data. For more +details see section 7.1 of the About AQS Data page .

    -

    Install pyaqsapi

    +

    Install pyaqsapi

    To install pyaqsapi first clone the pyaqsapi repository.

    git clone https://github.com/USEPA/pyaqsapi.git
    -

    Next, in the project's root directory use pip to install the proper +

    Next, in the project’s root directory use pip to install the proper dependencies that are required to build and install pyaqsapi.

    pip install -r requirements.txt
    -

    While still in the project's root directory use setuptools to build and pip +

    While still in the project’s root directory use setuptools to build and pip to install the package.

    python -m build .
 python -m pip install .
@@ -199,7 +194,7 @@ 
    Introduction
-
    Load pyaqsapi
    
+
    Load pyaqsapi
    
 
    Like any other python package make sure that you are loading pyaqsapi in the
 same virtual environment where pyaqsapi was installed. Load pyaqsapi in the
 same any other python package is loaded.
    
@@ -208,19 +203,20 @@ 
    Introduction
-
    Using pyaqsapi
    
-
    For those who are already familiar with using RAQSAPI then the pyaqsapi API
-should feel familiar with a few minor differences regarding how the data is
-returned.
    
-
    All data is returned using pandas Data Frames. Exported functions from pyaqsapi
-have a parameter RETURN_HEADER, by default this parameter is False. When False
-these functions simply return the requested data as a pandas Data Frame. If
-RETURN_HEADER is manually set to True an AQSAPI_V2 python 3 object is returned.
-Use the get_data() class method to retrieve the data, get_header() class
-method to retrieve header information.
    
+
    Using pyaqsapi
    
+
    For those who are already familiar with using 
+RAQSAPI then the pyaqsapi API should feel familiar with a few minor differences
+regarding how the data is returned.
    
+
    By default data is returned as a pandas Data Frames .
+Exported functions from pyaqsapi have a parameter RETURN_HEADER, by default
+this parameter is False. When False functions simply return the requested
+data as a pandas Data Frame. If RETURN_HEADER is manually set to True a list of
+AQSAPI_V2 python 3 objects are returned. Use the get_data() class method to
+retrieve the data and the get_header() class method to retrieve header
+information.
    -

    Sign up and setting up user credentials with the pyaqsapi library

    +

    Sign up and setting up user credentials with the pyaqsapi library

    If you have not already done so you will need to sign up with AQS Data Mart using aqs_sign_up function, this function takes one input, “email,” which is a python 3 character object, that represents the email address that you want @@ -242,7 +238,7 @@

    Introduction +

    Usage tips and precautions

    +

    This section contains suggestions for completing certain data related tasks.

    +
      +

    • Determine if or how much data exists for a time-parameter-geography +combination:

      +
      +
        +

      • Retrieve data using the annualdata service.

        • +

      • If no records are returned, we do not have the data.

        • +

      • If records are returned, use the observation count to determine the +temporal and geographic distribution of the data.

        • +
      +
      +
      • +

    • Monthly averages:

      +
      +
        +

      • AQS does not routinely calculate monthly aggregate statistics.

        • +

      • If you need these, you must calculate them yourself.

        • +

      • These can be calculated from the sample data or the daily data without +loss of fidelity.

        • +
      +
      +
      • +

    • Determine a single value for a site with collocated monitors:

      +
      +
        +

      • Many sites will have collocated monitors - monitors collecting the same +parameter at the same time.

        • +

      • The API currently provides only monitor level values. (site-level values +will be added in the future.)

        • +

      • For some criteria pollutants (PM2.5, ozone, lead, and NO2), the +regulations define procedures for defining a single site-level value.

        • +

      • For other pollutants, determining a single site-level value is left to +the investigator.

        • +
      +
      +
      • +

    • Please adhere to the following when using the AQS Data Mart API:

      +
      +
        +
      • +
        Limit the size of queries. The AQS Data Mart contains billions of

        values and you may request more than you intend. If you are unsure of +the amount of data, start small and work your way up. Please limit +queries to 1,000,000 rows of data each. You can use the +“observation count” field on the annualdata service to determine how +much data exists for a time-parameter-geography combination.

        +
        +
        +
        • +
      • +
        Limit the frequency of queries. The AQS Data Mart can process a limited

        load. Please wait for one request to complete before submitting another +and do not make more than 10 requests per minute.

        +
        +
        +
        • +

      • Be advised that RAQSAPI is capable of retrieving results for multiple +pollutants, this can result in the amount of data being returned being +multiplied by the number of pollutants being requested.

        • +

      • Be advised that the AQS Data Mart API limits certain data requests to +one year of data at a time with the exception of the Monitor service. +In order to retrieve multiple years of data for these functions the +RAQSAPI library conveniently sends multiple API requests to the Data Mart +API server, one request for each year, this can result in the amount of +data being returned being multiplied by the number of years of data being +requested.

        • +
      +
      +
      • +
    +

    The AQS Data Mart administrators may disable accounts without notice for +failure to adhere to these terms (Though they will contact the offending +user via the email address provided)

    +

    Functions Exported by pyaqsapi

    The pyaqsapi package includes the following submodules which are not @@ -394,7 +465,7 @@

    Variable descriptions and usage -
    cbdate (optional):

    a date object which represents the "beginning date of last change" that +

    cbdate (optional):

    a date object which represents the “beginning date of last change” that indicates when the data was last updated. cbdate is used to filter data based on the change date. Only data that changed on or after this date will be returned. This is an optional variable which defaults to None.

    @@ -402,7 +473,7 @@

    Variable descriptions and usage -
    cedate (optional):

    a date object which represents the "end date of last change" that indicates +

    cedate (optional):

    a date object which represents the “end date of last change” that indicates when the data was last updated. cedate is used to filter data based on the change date. Only data that changed on or before this date will be returned. This is an optional variable which defaults to None.

    @@ -436,7 +507,7 @@

    Variable descriptions and usage
    email:

    a character object which represents the email account that will be used to -register with the AQS API or change an existing user's key. A verification +register with the AQS API or change an existing user’s key. A verification email will be sent to the account specified.

    @@ -611,7 +682,7 @@

    Data Mart API list functionsaqs_counties_by_state() aqs_counties_by_state takes one parameter, stateFIPS, which is a two digit state FIPS code for the state being requested represented as a @@ -674,8 +745,8 @@

    Data Mart aggregate functions
  • -
    cbdate:

    a date object which represents a "beginning date of last -change" that indicates when the data was last updated. +

    cbdate:

    a date object which represents a “beginning date of last +change” that indicates when the data was last updated. cbdate is used to filter data based on the change date. Only data that changed on or after this date will be returned. This is an optional variable which defaults to @@ -684,7 +755,7 @@

    Data Mart aggregate functions -
    cedate:

    a date object which represents an "end date of last change" +

    cedate:

    a date object which represents an “end date of last change” that indicates when the data was last updated. cedate is used to filter data based on the change date. Only data that changed on or before this date will be returned. This @@ -719,7 +790,7 @@

    Data Mart aggregate functions
  • -
    cbdate:

    a date object which represents a "beginning date of last change" +

    cbdate:

    a date object which represents a “beginning date of last change” that indicates when the data was last updated. cbdate is used to filter data based on the change date. Only data that changed on or after this date will be returned. This is an optional variable which @@ -728,7 +799,7 @@

    Data Mart aggregate functions -
    cedate:

    a date object which represents an "end date of last change" +

    cedate:

    a date object which represents an “end date of last change” that indicates when the data was last updated. cedate is used to filter data based on the change date. Only data that changed on or before this date will be returned. This @@ -749,8 +820,8 @@

    Data Mart aggregate functions
  • -
    cbdate:

    a date object which represents a "beginning date of last -change" that indicates when the data was last updated. cbdate +

    cbdate:

    a date object which represents a “beginning date of last +change” that indicates when the data was last updated. cbdate is used to filter data based on the change date. Only data that changed on or after this date will be returned. This is an optional variable which defaults to None.

    @@ -758,7 +829,7 @@

    Data Mart aggregate functions -
    cedate:

    a date object which represents an "end date of last change" +

    cedate:

    a date object which represents an “end date of last change” that indicates when the data was last updated. cedate is used to filter data based on the change date. Only data that changed on or before this date will be returned. This is an @@ -779,7 +850,7 @@

    Data Mart aggregate functions
  • -
    cbdate:

    a date object which represents a "beginning date of last change" that +

    cbdate:

    a date object which represents a “beginning date of last change” that indicates when the data was last updated. cbdate is used to filter data based on the change date. Only data that changed on or after this date will be returned. This is an optional variable which @@ -788,7 +859,7 @@

    Data Mart aggregate functions -
    cedate:

    a date object which represents an "end date of last change" +

    cedate:

    a date object which represents an “end date of last change” that indicates when the data was last updated. cedate is used to filter data based on the change date. Only data that changed on or before this date will be returned. This is an @@ -813,15 +884,15 @@

    Data Mart aggregate functions
    Quality Assurance - Collocated Assessments:

    Quality assurance data - collocated assessments. Collocated assessments are pairs of samples collected by different samplers at the same time -and place. (These are "operational" samplers, assessments with -independently calibrated samplers are called "audits".). Functions using +and place. (These are “operational” samplers, assessments with +independently calibrated samplers are called “audits”.). Functions using this service contain qa_collocated_assessments in the function name.

  • Quality Assurance - Flow Rate Verifications:

    Quality assurance data - flow rate verifications. Several times per year, -each PM monitor must have it's (fixed) flow rate verified by an operator +each PM monitor must have it’s (fixed) flow rate verified by an operator taking a measurement of the flow rate. Functions using this service contain qa_flowrateverification in the function name.

    @@ -829,7 +900,7 @@

    Data Mart aggregate functions
    Quality Assurance - Flow Rate Audits:

    Quality assurance data - flow rate audits. At least twice year, each PM -monitor must have it's flow rate measurement audited by an expert using a +monitor must have it’s flow rate measurement audited by an expert using a different method than is used for flow rate verifications. Functions using this service contain qa_flowrateaudit in the function name.

    @@ -1260,6 +1331,23 @@

    pyaqsapi Miscellaneous functions +

    Troubleshooting

    +

    Parameters must be supplied exactly as they are specified, for example the +stateFIPS for Alabama is “01”, entering a value of “1” for the stateFIPS +may lead to unexpected results. Do not omit leading zeros in parameters that +expect them.

    +

    • +
    +

    About RAQSAPI

    +

    pyaqsapi is a port of to the +python 3 programming environment. For anyone that is familiar with RAQSAPI, +the pyaqsapi API will feel familiar to you, most of the functions are similar +and the parameters sent to each functions are the same. pyaqsapi aims to have +feature parity with RAQSAPI and neither project will have features that the +other project does not - other than programming language environment or +language preference there is no benefit to using one package over the other.

    pyaqsapi API reference documentation

      @@ -1272,6 +1360,17 @@

      pyaqsapi indexIndex

    +
    +

    References

    +
    +
      +

    1. AQS DataMart welcome. Aug 2018. URL: https://aqs.epa.gov/aqsweb/documents/data_mart_welcome.html.

      2. +

    2. About AQS data. May 2019. Version 1.1. URL: https://aqs.epa.gov/aqsweb/documents/about_aqs_data.html.

      3. +

    3. Pandas.Dataframe. January 2024. URL: https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.html.

      4. +

    4. Clinton Mccrowey. A R extension to retrieve ambient air monitoring data from the United States Environmental Protection Agency’s (US EPA) Air Quality System (AQS) DataMart API V2 interface. 2022. URL: https://github.com/USEPA/RAQSAPI.

      5. +
    +
    +
    diff --git a/docs/_build/html/manual/Install_pyaqsapi.html b/docs/_build/html/manual/Install_pyaqsapi.html index 49c0ad2..91c3633 100644 --- a/docs/_build/html/manual/Install_pyaqsapi.html +++ b/docs/_build/html/manual/Install_pyaqsapi.html @@ -77,13 +77,13 @@ 
    git clone https://github.com/USEPA/pyaqsapi.git
    -

    Next, in the project's root directory use pip to install the proper +

    Next, in the project’s root directory use pip to install the proper dependencies that are required to build and install pyaqsapi.

    pip install -r requirements.txt
    -

    While still in the project's root directory use setuptools to build and pip +

    While still in the project’s root directory use setuptools to build and pip to install the package.

    python -m build .
 python -m pip install .
diff --git a/docs/_build/html/manual/Introduction.html b/docs/_build/html/manual/Introduction.html
index 197142f..a223bf1 100644
--- a/docs/_build/html/manual/Introduction.html
+++ b/docs/_build/html/manual/Introduction.html
@@ -76,22 +76,22 @@ 
    Introduction interface directly.
+This package enables the data user to omit legacy challenges including coercing
+data from a JSON object to a usable python 3 object, retrieving multiple years
+of data, formatting API requests, retrieving results, handling credentials,
+requesting multiple pollutant data and rate limiting data requests.
+All the basic functionality of the API have been implemented that are available
+from the AQS API Data Mart server. The library connects to AQS Data Mart API
+via Hypertext Transfer Protocol (HTTP) so there is no need to install external
+ODBC drivers, configure ODBC connections or deal with the security
+vulnerabilities associated with them. Most functions have a parameter,
+return_header which by default is set to FALSE. If the user decides to
+set return_header to TRUE, then that function will return a python 3
+AQSAPI_V2 object. An AQSAPI_V2 object has instance methods for retrieving the
+data requested, header information, and other metadata related to the API call.
+After each call to the API a five second stall is invoked to help prevent
+overloading the Data Mart API server and to serve as a simple rate limit.
    
 
 
 
diff --git a/docs/_build/html/manual/RAQSAPI.html b/docs/_build/html/manual/RAQSAPI.html
index 9b24c36..532f02d 100644
--- a/docs/_build/html/manual/RAQSAPI.html
+++ b/docs/_build/html/manual/RAQSAPI.html
@@ -73,7 +73,7 @@
              
   
    
 
    About RAQSAPI
    
-
    pyaqsapi is a port of RAQSAPI to the
+
    pyaqsapi is a port of  to the
 python 3 programming environment. For anyone that is familiar with RAQSAPI,
 the pyaqsapi API will feel familiar to you, most of the functions are similar
 and the parameters sent to each functions are the same. pyaqsapi aims to have
diff --git a/docs/_build/html/manual/TimelinessofAQSdata.html b/docs/_build/html/manual/TimelinessofAQSdata.html
index bb8963c..1aae813 100644
--- a/docs/_build/html/manual/TimelinessofAQSdata.html
+++ b/docs/_build/html/manual/TimelinessofAQSdata.html
@@ -73,11 +73,11 @@
              
   
    
 
    About the timeliness of AQS Data
    
-
    EPA's AQS Datamart API, the service that pyaqsapi retrieves data from, does not
+
    EPA’s AQS Datamart API, the service that pyaqsapi retrieves data from, does not
 host real time (collected now/today) data. If real time data is needed, please
-use the AirNow API and direct all questions toward real time data there. RAQSAPI
-does not work with AirNow and cannot retrieve real time data. For more details
-see section 7.1 of the About AQS Data page.
    
+use the AirNow API and direct all questions toward real time data there.
+pyaqsapi does not work with AirNow and cannot retrieve real time data. For more
+details see section 7.1 of the About AQS Data page .
    
 
    
 
 
diff --git a/docs/_build/html/manual/Troubleshooting.html b/docs/_build/html/manual/Troubleshooting.html
new file mode 100644
index 0000000..8df966e
--- /dev/null
+++ b/docs/_build/html/manual/Troubleshooting.html
@@ -0,0 +1,110 @@
+
+
+
+  
+
+  
+  Troubleshooting — pyaqsapi  documentation
+      
+      
+
+  
+  
+  
+        
+        
+        
+        
+        
+    
+    
+     
+
+
+ 
+  
    
+    
+
+    
    
+
+      
    
+        
    
+          
    
+  
+  
    
+
    
+          
    
+           
    
+             
+  
    
+
    Troubleshooting
    
+
    Parameters must be supplied exactly as they are specified, for example the
+stateFIPS for Alabama is “01”, entering a value of “1” for the stateFIPS
+may lead to unexpected results. Do not omit leading zeros in parameters that
+expect them.
    
+
    
+
+
+           
    
+          
    
+          
    
+
+  
    
+
+  
    
+    
    © Copyright 2024, US Environmental Protection Agency.
    
+  
    
+
+  Built with Sphinx using a
+    theme
+    provided by Read the Docs.
+   
+
+
    
+        
    
+      
    
+    
    
+  
    
+   
+
+
+
\ No newline at end of file
diff --git a/docs/_build/html/manual/Using_pyaqsapi.html b/docs/_build/html/manual/Using_pyaqsapi.html
index 64cac2b..72daea3 100644
--- a/docs/_build/html/manual/Using_pyaqsapi.html
+++ b/docs/_build/html/manual/Using_pyaqsapi.html
@@ -74,15 +74,16 @@
              
   
    
 
    Using pyaqsapi
    
-
    For those who are already familiar with using RAQSAPI then the pyaqsapi API
-should feel familiar with a few minor differences regarding how the data is
-returned.
    
-
    All data is returned using pandas Data Frames. Exported functions from pyaqsapi
-have a parameter RETURN_HEADER, by default this parameter is False. When False
-these functions simply return the requested data as a pandas Data Frame. If
-RETURN_HEADER is manually set to True an AQSAPI_V2 python 3 object is returned.
-Use the get_data() class method to retrieve the data, get_header() class
-method to retrieve header information.
    
+
    For those who are already familiar with using 
+RAQSAPI then the pyaqsapi API should feel familiar with a few minor differences
+regarding how the data is returned.
    
+
    By default data is returned as a pandas Data Frames .
+Exported functions from pyaqsapi have a parameter RETURN_HEADER, by default
+this parameter is False. When False functions simply return the requested
+data as a pandas Data Frame. If RETURN_HEADER is manually set to True a list of
+AQSAPI_V2 python 3 objects are returned. Use the get_data() class method to
+retrieve the data and the get_header() class method to retrieve header
+information.
    
 
    
 
    
 
    Sign up and setting up user credentials with the pyaqsapi library
    
@@ -107,7 +108,7 @@
 authentication but only account monitoring. Each time pyaqsapi is loaded and
 before using any of it’s functions use the aqs_credentials function to enter in
 the user credentials so that pyaqsapi can access the AQS Data Mart server.
    
-
    Both pyaqsapi and RAQSAPI use the US Environmental Protection Agency's Air
+
    Both pyaqsapi and RAQSAPI use the US Environmental Protection Agency’s Air
 Quality Service DataMart to retrieve data. The same credentials can be used for
 access to either project. Note however, that AQS and AQS DataMart are similar
 and related data sources, however the credentials used to access AQS are not the
diff --git a/docs/_build/html/manual/pyaqsapiFunctions-Brief.html b/docs/_build/html/manual/pyaqsapiFunctions-Brief.html
index ff192e2..332848e 100644
--- a/docs/_build/html/manual/pyaqsapiFunctions-Brief.html
+++ b/docs/_build/html/manual/pyaqsapiFunctions-Brief.html
@@ -125,7 +125,7 @@ 
    Data Mart aggregate functions
-
    cbdate (optional):
    a date object which represents the "beginning date of last change" that
+
    cbdate (optional):
    a date object which represents the “beginning date of last change” that
 indicates when the data was last updated. cbdate is used to filter data
 based on the change date. Only data that changed on or after this
 date will be returned. This is an optional variable which defaults to None.
    
@@ -233,7 +233,7 @@ 
    Variable descriptions and usage
-
    cedate (optional):
    a date object which represents the "end date of last change" that indicates
+
    cedate (optional):
    a date object which represents the “end date of last change” that indicates
 when the data was last updated. cedate is used to filter data based on the
 change date. Only data that changed on or before this date will be
 returned. This is an optional variable which defaults to None.
    
@@ -267,7 +267,7 @@ 
    Variable descriptions and usage
 
    email:
    a character object which represents the email account that will be used to
-register with the AQS API or change an existing user's key. A verification
+register with the AQS API or change an existing user’s key. A verification
 email will be sent to the account specified.
    
 
    
 
@@ -442,7 +442,7 @@ 
    Data Mart API list functionsaqs_counties_by_state()
 aqs_counties_by_state takes one parameter, stateFIPS, which is a two
 digit state FIPS code for the state being requested represented as a
@@ -505,8 +505,8 @@ 
    Data Mart aggregate functions
 
  • 
-
    cbdate:
    a date object which represents a "beginning date of last
-change" that indicates when the data was last updated.
+
    cbdate:
    a date object which represents a “beginning date of last
+change” that indicates when the data was last updated.
 cbdate is used to filter data based on the change date.
 Only data that changed on or after this date will be
 returned. This is an optional variable which defaults to
@@ -515,7 +515,7 @@ 
    Data Mart aggregate functions
-
    cedate:
    a date object which represents an "end date of last change"
+
    cedate:
    a date object which represents an “end date of last change”
 that indicates when the data was last updated. cedate is
 used to filter data based on the change date. Only data
 that changed on or before this date will be returned. This
@@ -550,7 +550,7 @@ 
    Data Mart aggregate functions
 
  • 
-
    cbdate:
    a date object which represents a "beginning date of last change"
+
    cbdate:
    a date object which represents a “beginning date of last change”
 that indicates when the data was last updated. cbdate is used to
 filter data based on the change date. Only data that changed on or
 after this date will be returned. This is an optional variable which
@@ -559,7 +559,7 @@ 
    Data Mart aggregate functions
-
    cedate:
    a date object which represents an "end date of last change"
+
    cedate:
    a date object which represents an “end date of last change”
 that indicates when the data was last updated. cedate is
 used to filter data based on the change date. Only data
 that changed on or before this date will be returned. This
@@ -580,8 +580,8 @@ 
    Data Mart aggregate functions
 
  • 
-
    cbdate:
    a date object which represents a "beginning date of last
-change" that indicates when the data was last updated. cbdate
+
    cbdate:
    a date object which represents a “beginning date of last
+change” that indicates when the data was last updated. cbdate
 is used to filter data based on the change date. Only data
 that changed on or after this date will be returned. This is
 an optional variable which defaults to None.
    
@@ -589,7 +589,7 @@ 
    Data Mart aggregate functions
-
    cedate:
    a date object which represents an "end date of last change"
+
    cedate:
    a date object which represents an “end date of last change”
 that indicates when the data was last updated. cedate is used
 to filter data based on the change date. Only data that
 changed on or before this date will be returned. This is an
@@ -610,7 +610,7 @@ 
    Data Mart aggregate functions
 
  • 
-
    cbdate:
    a date object which represents a "beginning date of last change" that
+
    cbdate:
    a date object which represents a “beginning date of last change” that
 indicates when the data was last updated. cbdate is used to filter
 data based on the change date. Only data that changed on or after
 this date will be returned. This is an optional variable which
@@ -619,7 +619,7 @@ 
    Data Mart aggregate functions
-
    cedate:
    a date object which represents an "end date of last change"
+
    cedate:
    a date object which represents an “end date of last change”
 that indicates when the data was last updated. cedate is used
 to filter data based on the change date. Only data that
 changed on or before this date will be returned. This is an
@@ -644,15 +644,15 @@ 
    Data Mart aggregate functions
 
    Quality Assurance - Collocated Assessments:
    Quality assurance data - collocated assessments. Collocated assessments
 are pairs of samples collected by different samplers at the same time
-and place. (These are "operational" samplers, assessments with
-independently calibrated samplers are called "audits".). Functions using
+and place. (These are “operational” samplers, assessments with
+independently calibrated samplers are called “audits”.). Functions using
 this service contain qa_collocated_assessments in the function name.
    
 
    
 
    
 
    • 
 
  • 
 
    Quality Assurance - Flow Rate Verifications:
    Quality assurance data - flow rate verifications. Several times per year,
-each PM monitor must have it's (fixed) flow rate verified by an operator
+each PM monitor must have it’s (fixed) flow rate verified by an operator
 taking a measurement of the flow rate. Functions using this service contain
 qa_flowrateverification in the function name.
    
 
    
@@ -660,7 +660,7 @@ 
    Data Mart aggregate functions
 
    Quality Assurance - Flow Rate Audits:
    Quality assurance data - flow rate audits. At least twice year, each PM
-monitor must have it's flow rate measurement audited by an expert using a
+monitor must have it’s flow rate measurement audited by an expert using a
 different method than is used for flow rate verifications. Functions using
 this service contain qa_flowrateaudit in the function name.
    
 
    
diff --git a/docs/_build/html/manual/pyaqsapiusagetipsandprecautions.html b/docs/_build/html/manual/pyaqsapiusagetipsandprecautions.html
new file mode 100644
index 0000000..c4b148b
--- /dev/null
+++ b/docs/_build/html/manual/pyaqsapiusagetipsandprecautions.html
@@ -0,0 +1,178 @@
+
+
+
+  
+
+  
+  Usage tips and precautions — pyaqsapi  documentation
+      
+      
+
+  
+  
+  
+        
+        
+        
+        
+        
+    
+    
+     
+
+
+ 
+  
    
+    
+
+    
    
+
+      
    
+        
    
+          
    
+  
+  
    
+
    
+          
    
+           
    
+             
+  
    
+
    Usage tips and precautions
    
+
    This section contains suggestions for completing certain data related tasks.
    
+
      
+
    • Determine if or how much data exists for a time-parameter-geography
+combination:
      
+
      
+
        
+
      • Retrieve data using the annualdata service.
        • 
+
      • If no records are returned, we do not have the data.
        • 
+
      • If records are returned, use the observation count to determine the
+temporal and geographic distribution of the data.
        • 
+
      
+
      
+
      • 
+
    • Monthly averages:
      
+
      
+
        
+
      • AQS does not routinely calculate monthly aggregate statistics.
        • 
+
      • If you need these, you must calculate them yourself.
        • 
+
      • These can be calculated from the sample data or the daily data without
+loss of fidelity.
        • 
+
      
+
      
+
      • 
+
    • Determine a single value for a site with collocated monitors:
      
+
      
+
        
+
      • Many sites will have collocated monitors - monitors collecting the same
+parameter at the same time.
        • 
+
      • The API currently provides only monitor level values. (site-level values
+will be added in the future.)
        • 
+
      • For some criteria pollutants (PM2.5, ozone, lead, and NO2), the
+regulations define procedures for defining a single site-level value.
        • 
+
      • For other pollutants, determining a single site-level value is left to
+the investigator.
        • 
+
      
+
      
+
      • 
+
    • Please adhere to the following when using the AQS Data Mart API:
      
+
      
+
        
+
      • 
+
        Limit the size of queries. The AQS Data Mart contains billions of
        values and you may request more than you intend. If you are unsure of
+the amount of data, start small and work your way up. Please limit
+queries to 1,000,000 rows of data each. You can use the
+“observation count” field on the annualdata service to determine how
+much data exists for a time-parameter-geography combination.
        
+
        
+
        
+
        • 
+
      • 
+
        Limit the frequency of queries. The AQS Data Mart can process a limited
        load. Please wait for one request to complete before submitting another
+and do not make more than 10 requests per minute.
        
+
        
+
        
+
        • 
+
      • Be advised that RAQSAPI is capable of retrieving results for multiple
+pollutants, this can result in the amount of data being returned being
+multiplied by the number of pollutants being requested.
        • 
+
      • Be advised that the AQS Data Mart API limits certain data requests to
+one year of data at a time with the exception of the Monitor service.
+In order to retrieve multiple years of data for these functions the
+RAQSAPI library conveniently sends multiple API requests to the Data Mart
+API server, one request for each year, this can result in the amount of
+data being returned being multiplied by the number of years of data being
+requested.
        • 
+
      
+
      
+
      • 
+
    
+
    The AQS Data Mart administrators may disable accounts without notice for
+failure to adhere to these terms (Though they will contact the offending
+user via the email address provided)
    
+
    
+
+
+           
    
+          
    
+          
    
+
+  
    
+
+  
    
+    
    © Copyright 2024, US Environmental Protection Agency.
    
+  
    
+
+  Built with Sphinx using a
+    theme
+    provided by Read the Docs.
+   
+
+
    
+        
    
+      
    
+    
    
+  
    
+   
+
+
+
\ No newline at end of file
diff --git a/docs/_build/html/objects.inv b/docs/_build/html/objects.inv
index 42c5e0dbf19418e49ccc98803e57e8e64b77aba0..176a17874ac266f3cbe42ead75104d8700d4f20b 100644
GIT binary patch
delta 1131
zcmV-x1eE)N3Ec^hfqzI3?txqM+MD|Y1cctXf=}LQIUorrOOYTm7Wj)iDz&8Rx&-BD?x>E>;c
zujzUVzqWOunWzNQhfII-o#
z5hpgB*ibIlWK@4Lsy|xQhe-7{s9vv}L!NF+`i_Hg`w782P?xMe!-prd$vgP>3gtUu
z?1`}>h7V8J@~(UEO#SOdRH9~DNRvm-v@SZdsa|8+1AhMd0nX5GQrrs3dx3i^^@%b*Xkx};BITKCj4pnLN%3t^=wOi&cz*;)nl!gyQJTH96v
zd9cbjUoP;z4?4P_zO*4V6mvhp0&p!w+1d(cfPX_k5Bdhh&oVAZxvcF0A|}F2Qc(2}
zLuAQy5&Jg3aHcC|#+(FL(!XoF5~d`2%*jCAwe;Y=;0?19oi2CUzVI32lQC>*_C(Kec_{I^pwDyiR{6b
z4}boPJ?L3fzFDnxqX|N*;GCveqexvgk`|;58$p_LCc}9MgUE~`7)H@}R*5pv1{-tI
zETcZRgO`BQp&>@2D{1>qU*JufWDoOi{v}URD6Z9t;PrgnwtL;`*>CuY%S{IVUw0t@?w5foB*2Mh64W
zxJxr;3me{gT_$HTS2*(%q-Fu$pzl5?Q;~diXBVI+d?Va$|dKTyZ$MnUvVQ(vExir_5l)^-N94Q-^%w$*V
zbi{-Wll|?=PljVU{HfMVCw7UeU)2)(1kCGnr)Xz8)#98jb-z11h|Q>VDaKrAjO}RO
xdG>tRv~WV2>|Xy8$q3YoN~#LUnqGyW?hAkEx^#Fr#LZ34#fbfq&>8+ygi0b#Lw$5Fkd~dbd}Dl4zR%MJgn+-)OOSvTU11XrQn7sS3{eIZ)@Bh5GLcU`dPP_1}
zPi_Me|Bko|Cr%Vx3dOA@`a~d@EKg-n1(2Y)oGPZZFoN88TO0SfsH
z0ZGSOFylxrY$h25ny8E~`|a^_AJQslnJ}LQ`5nOyafc-2J7&64PH=ln>!Wqd@y+`v
zUs*R6eyvpIgjSY5XmuWVI~Z`KBKDA2zXtS
zN6;-?O_;Utg{q7bZO%-I|NPfVHsvGJZ%}MYPg{E0)6NFA=r``k+ube;U(vqn?4><6|;}MLwsvbg!
zB)Tp_-{u$2bfwIg69J3*cWqb1lqlH5v$10_TOugew#AKVZz&Ok@PaeB(#&5{A~
zaTjMy7IupDx-e%lS2VGlnd~x7ZpNB5bbn~x@8QUwSaDXQDhX3L$qdf{Mlktu9}tID
zB?TNB;vC}mBVNm$!_EMIdJn?oc8UK0!

diff --git a/docs/_build/html/searchindex.js b/docs/_build/html/searchindex.js
index 0af815a..9495aed 100644
--- a/docs/_build/html/searchindex.js
+++ b/docs/_build/html/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["index", "manual/EPA_Disclaimer", "manual/Install_pyaqsapi", "manual/Introduction", "manual/Load_pyaqsapi", "manual/RAQSAPI", "manual/TimelinessofAQSdata", "manual/Using_pyaqsapi", "manual/pyaqsapiFunctions-Brief", "manual/pyaqsapiFunctions-Long"], "filenames": ["index.rst", "manual/EPA_Disclaimer.rst", "manual/Install_pyaqsapi.rst", "manual/Introduction.rst", "manual/Load_pyaqsapi.rst", "manual/RAQSAPI.rst", "manual/TimelinessofAQSdata.rst", "manual/Using_pyaqsapi.rst", "manual/pyaqsapiFunctions-Brief.rst", "manual/pyaqsapiFunctions-Long.rst"], "titles": ["pyaqsapi user documentation", "EPA Disclaimer", "Install pyaqsapi", "Introduction", "Load pyaqsapi", "About RAQSAPI", "About the timeliness of AQS Data", "Using pyaqsapi", "Data Mart aggregate functions", "Functions Exported by pyaqsapi"], "terms": {"thi": [0, 1, 3, 7, 9], "softwar": [0, 1], "applic": [0, 1], "wa": [0, 1, 4, 9], "develop": [0, 1], "u": [0, 1, 3, 7, 8, 9], "": [0, 1, 2, 3, 6, 7, 9], "environment": [0, 1, 3, 7], "protect": [0, 1, 3, 7], "usepa": [0, 1, 2], "No": [0, 1], "warranti": [0, 1], "express": [0, 1], "impli": [0, 1], "i": [0, 1, 3, 4, 5, 6, 7, 8, 9], "made": [0, 1], "regard": [0, 1, 7], "accuraci": [0, 1], "util": [0, 1], "system": [0, 1, 3, 9], "nor": [0, 1], "shall": [0, 1], "act": [0, 1], "distribut": [0, 1], "constitut": [0, 1], "ani": [0, 1, 4, 7, 9], "The": [0, 1, 3, 7, 8, 9], "ha": [0, 1, 3], "relinquish": [0, 1], "control": [0, 1, 8, 9], "inform": [0, 1, 3, 7, 9], "longer": [0, 1, 8, 9], "respons": [0, 1, 9], "integr": [0, 1], "confidenti": [0, 1], "avail": [0, 1, 3, 8, 9], "specif": [0, 1, 9], "commerci": [0, 1], "product": [0, 1], "process": [0, 1], "servic": [0, 1, 6, 7, 8, 9], "mark": [0, 1], "trademark": [0, 1], "manufactur": [0, 1], "otherwis": [0, 1], "doe": [0, 1, 5, 6, 7], "endors": [0, 1], "recommend": [0, 1], "favor": [0, 1], "seal": [0, 1], "logo": [0, 1], "manner": [0, 1], "activ": [0, 1], "unit": [0, 1, 3], "state": [0, 1, 3, 8, 9], "govern": [0, 1], "v2": [0, 1, 3], "current": [0, 1], "beta": [0, 1], "phase": [0, 1], "interfac": [0, 1, 3], "been": [0, 1, 3, 9], "final": [0, 1], "mean": [0, 1, 7, 9], "certain": [0, 1, 9], "mai": [0, 1, 7], "chang": [0, 1, 7, 9], "remov": [0, 1], "without": [0, 1, 7], "notic": [0, 1], "As": [0, 1], "result": [0, 1, 3, 8, 9], "packag": [0, 1, 2, 3, 4, 5, 7, 9], "also": [0, 1, 7], "reflect": [0, 1], "respect": [0, 1, 9], "improv": [0, 1], "design": [0, 1], "author": [0, 1], "assum": [0, 1], "liabil": [0, 1], "problem": [0, 1], "occur": [0, 1, 9], "hardwar": [0, 1], "account": [0, 1, 7, 9], "python": [0, 2, 3, 4, 5, 7], "3": [0, 3, 5, 7, 9], "program": [0, 3, 5, 9], "environ": [0, 3, 4, 5], "allow": [0, 3], "connect": [0, 3, 9], "retriev": [0, 3, 6, 7, 8, 9], "from": [0, 3, 6, 7, 8, 9], "air": [0, 3, 7, 9], "1": [0, 3, 6], "directli": [0, 3, 9], "enabl": [0, 3], "omit": [0, 3], "legaci": [0, 3], "challeng": [0, 3, 9], "includ": [0, 3, 9], "coerc": [0, 3, 9], "json": [0, 3], "object": [0, 3, 7, 9], "usabl": [0, 3], "multipl": [0, 3, 8, 9], "year": [0, 3, 8, 9], "format": [0, 3, 8, 9], "request": [0, 3, 7, 8, 9], "handl": [0, 3, 9], "pollut": [0, 3, 9], "rate": [0, 3, 8, 9], "limit": [0, 3, 9], "all": [0, 3, 6, 7, 8, 9], "basic": [0, 3], "have": [0, 3, 5, 7, 9], "implement": [0, 3, 9], "ar": [0, 2, 3, 4, 5, 7, 8, 9], "server": [0, 3, 7], "via": [0, 3, 9], "hypertext": [0, 3], "transfer": [0, 3], "protocol": [0, 3], "http": [0, 2, 3, 9], "so": [0, 3, 7], "need": [0, 3, 6, 7], "extern": [0, 3], "odbc": [0, 3], "driver": [0, 3], "configur": [0, 3], "deal": [0, 3], "secur": [0, 3], "vulner": [0, 3], "associ": [0, 3], "them": [0, 3], "most": [0, 3, 5, 9], "paramet": [0, 3, 5, 7, 9], "return_head": [0, 3, 7, 9], "which": [0, 3, 7, 8, 9], "default": [0, 3, 7, 9], "fals": [0, 3, 7, 9], "If": [0, 3, 6, 7, 9], "decid": [0, 3, 9], "true": [0, 3, 7, 9], "return": [0, 3, 7, 8, 9], "aqs_datamart_apiv2": [0, 3], "an": [0, 3, 7, 9], "instanc": [0, 3], "method": [0, 3, 7, 9], "header": [0, 3, 7], "other": [0, 3, 4, 5, 9], "relat": [0, 3, 7, 8, 9], "call": [0, 3, 7, 8, 9], "after": [0, 3, 7, 9], "each": [0, 3, 5, 7, 8, 9], "five": [0, 3], "second": [0, 3], "stall": [0, 3], "invok": [0, 3], "help": [0, 3], "prevent": [0, 3], "overload": [0, 3], "serv": [0, 3], "simpl": [0, 3, 9], "host": [0, 6], "real": [0, 6], "time": [0, 6, 7, 8, 9], "collect": [0, 6, 9], "now": [0, 6], "todai": [0, 6], "pleas": [0, 6], "airnow": [0, 6], "direct": [0, 6, 9], "question": [0, 6], "toward": [0, 6], "work": [0, 6], "cannot": [0, 6], "For": [0, 5, 6, 7, 9], "more": [0, 6, 8, 9], "detail": [0, 6, 9], "see": [0, 6, 9], "section": [0, 6, 9], "7": [0, 6, 8], "page": [0, 6], "port": [0, 5], "anyon": [0, 5], "familiar": [0, 5, 7], "feel": [0, 5, 7], "you": [0, 4, 5, 7], "similar": [0, 5, 7], "sent": [0, 5, 7, 9], "same": [0, 4, 5, 7, 9], "aim": [0, 5], "featur": [0, 5], "pariti": [0, 5], "neither": [0, 5], "project": [0, 2, 5, 7], "than": [0, 5, 9], "languag": [0, 5], "prefer": [0, 5], "benefit": [0, 5], "one": [0, 5, 7, 8, 9], "over": [0, 5], "To": [0, 2], "first": [0, 2], "clone": [0, 2], "repositori": [0, 2], "git": [0, 2], "github": [0, 2], "com": [0, 2], "next": [0, 2], "root": [0, 2], "directori": [0, 2], "pip": [0, 2], "proper": [0, 2], "depend": [0, 2], "requir": [0, 2, 9], "build": [0, 2], "r": [0, 2], "txt": [0, 2], "while": [0, 2], "still": [0, 2], "setuptool": [0, 2], "m": [0, 2], "like": [0, 4], "make": [0, 4, 8, 9], "sure": [0, 4], "virtual": [0, 4], "where": [0, 4, 8], "import": [0, 4], "those": [0, 7], "who": [0, 7], "alreadi": [0, 7], "should": [0, 7, 9], "few": [0, 7], "minor": [0, 7], "differ": [0, 7, 8, 9], "how": [0, 7, 8, 9], "panda": [0, 7, 9], "frame": [0, 7], "when": [0, 7, 9], "simpli": [0, 7], "manual": [0, 7], "aqsapi_v2": [0, 7, 9], "get_data": [0, 7], "class": [0, 7, 9], "get_head": [0, 7], "done": [0, 7], "aqs_sign_up": [0, 7, 9], "take": [0, 7, 8, 9], "input": [0, 7], "email": [0, 7, 9], "charact": [0, 7, 9], "repres": [0, 7, 9], "address": [0, 7], "want": [0, 7, 9], "success": [0, 7], "messag": [0, 7], "provid": [0, 7, 8, 9], "new": [0, 7], "kei": [0, 7, 9], "access": [0, 7], "can": [0, 7, 9], "regener": [0, 7], "exist": [0, 7, 9], "gener": [0, 7], "A": [0, 7, 9], "e": [0, 7, 9], "mail": [0, 7], "given": [0, 7, 9], "store": [0, 7, 9], "global": [0, 7], "everi": [0, 7, 9], "modul": [0, 7], "valid": [0, 7, 9], "reject": [0, 7], "password": [0, 7], "treat": [0, 7], "plain": [0, 7], "text": [0, 7], "attempt": [0, 7], "encrypt": [0, 7], "would": [0, 7], "usernam": [0, 7, 9], "combin": [0, 7, 9], "suppli": [0, 7], "intend": [0, 7], "authent": [0, 7], "onli": [0, 7, 9], "befor": [0, 7, 9], "aqs_credenti": [0, 7, 9], "enter": [0, 7], "both": [0, 7, 9], "either": [0, 7, 8], "note": [0, 7, 8, 9], "howev": [0, 7], "sourc": [0, 7], "do": [0, 7, 9], "creat": [0, 7], "sinc": [0, 7], "ew": [0, 7], "follow": [0, 9], "submodul": [0, 9], "bycbsa": [0, 8, 9], "byma": [0, 8, 9], "With": [0, 9], "entir": [0, 9], "aqs_cbsa": [0, 9], "aqs_class": [0, 9], "aqs_counties_by_st": [0, 9], "aqs_fields_by_servic": [0, 9], "aqs_isavail": [0, 9], "aqs_knownissu": [0, 9], "aqs_ma": [0, 9], "aqs_parameters_by_class": [0, 9], "aqs_pqao": [0, 9], "aqs_removehead": [0, 9], "aqs_revisionhistori": [0, 9], "aqs_sampledur": [0, 9], "aqs_sites_by_counti": [0, 9], "aqs_stat": [0, 9], "annualsummari": [0, 9], "dailysummari": [0, 9], "helperfunct": [0, 9], "quarterlysummari": [0, 9], "sampledata": [0, 8, 9], "qa_annualperformanceev": [0, 8, 9], "qa_annualperformanceevaltransact": [0, 8, 9], "qa_blank": [0, 8, 9], "qa_collocated_assess": [0, 8, 9], "qa_flowrateaudit": [0, 9], "qa_flowrateverif": [0, 8, 9], "qa_one_point_qc": [0, 8, 9], "qa_pep_audit": [0, 8, 9], "transactionsampl": [0, 8, 9], "qa_annualpeferomanceev": [0, 9], "bypqao": [0, 8, 9], "name": [0, 8, 9], "accord": [0, 9], "filter": [0, 9], "full": [0, 8, 9], "These": [0, 8, 9], "variou": [0, 9], "alphabet": [0, 9], "Not": [0, 9], "ref": [0, 9], "aqsobject": [0, 9], "type": [0, 9], "wheen": [0, 9], "bdate": [0, 9], "date": [0, 9], "begin": [0, 9], "select": [0, 9], "cbdate": [0, 9], "option": [0, 9], "last": [0, 9], "indic": [0, 9], "updat": [0, 9], "none": [0, 9], "cedat": [0, 9], "end": [0, 9], "countycod": [0, 9], "digit": [0, 9], "fip": [0, 9], "code": [0, 9], "counti": [0, 8, 9], "being": [0, 8, 9], "lead": [0, 9], "zero": [0, 9], "tabl": [0, 9], "durat": [0, 9], "string": [0, 9], "sampl": [0, 8, 9], "valu": [0, 9], "actual": [0, 9], "calcul": [0, 9], "8": [0, 9], "hour": [0, 9], "co": [0, 9], "o": [0, 9], "roll": [0, 9], "averag": [0, 9], "6": [0, 9], "dai": [0, 9], "pm": [0, 9], "pb": [0, 9], "month": [0, 9], "edat": [0, 9], "regist": [0, 9], "verif": [0, 8, 9], "specifi": [0, 9], "conjunct": [0, 9], "ma_cod": [0, 9], "4": [0, 9], "maxlat": [0, 9], "maximum": [0, 8, 9], "geograph": [0, 9], "decim": [0, 9], "north": [0, 9], "posit": [0, 9], "south": [0, 9], "maxlon": [0, 9], "east": [0, 9], "west": [0, 9], "80": [0, 9], "less": [0, 9], "70": [0, 9], "minlat": [0, 9], "minimum": [0, 9], "minlon": [0, 9], "singl": [0, 9], "datafram": [0, 9], "gov": [0, 9], "aqsweb": [0, 9], "data_api": [0, 9], "html": [0, 9], "_": [0, 9], "complet": [0, 8, 9], "through": [0, 9], "sitenum": [0, 9], "site": [0, 8, 9], "number": [0, 9], "within": [0, 8, 9], "statefip": [0, 9], "2": [0, 9], "pqao_cod": [0, 9], "two": [0, 9], "meta": [0, 9], "statu": [0, 9], "overview": [0, 9], "known": [0, 9], "issu": [0, 9], "usual": [0, 9], "identifi": [0, 9], "intern": [0, 9], "some": [0, 9], "correct": [0, 9], "queri": [0, 9], "histori": [0, 9], "group": [0, 8, 9], "By": [0, 9], "categori": [0, 9], "datat": [0, 9], "instead": [0, 9], "argument": [0, 9], "construct": [0, 9], "criteria": [0, 9], "receiv": [0, 9], "county_cod": [0, 9], "three": [0, 9], "encod": [0, 9], "contain": [0, 9], "restrict": [0, 8, 9], "amount": [0, 8, 9], "per": [0, 8, 9], "abl": [0, 8, 9], "repeat": [0, 8, 9], "There": [0, 8, 9], "5": [0, 9], "arrang": [0, 9], "10": [0, 9], "fourteen": [0, 9], "oper": [0, 9], "sampler": [0, 9], "etc": [0, 9], "fine": [0, 9], "grain": [0, 9], "report": [0, 9], "hourli": [0, 9], "sometim": [0, 9], "minut": [0, 9], "12": [0, 9], "sever": [0, 9], "geographi": [0, 9], "accept": [0, 9], "addit": [0, 9], "o_3": [0, 9], "daili": [0, 8, 9], "summari": [0, 8, 9], "summar": [0, 9], "level": [0, 9], "midnight": [0, 9], "basi": [0, 9], "local": [0, 9], "annual": [0, 8, 9], "yearli": [0, 9], "maxima": [0, 9], "percentil": [0, 9], "annualdata": [0, 8, 9], "quarterli": [0, 9], "quarterlydata": [0, 9], "blank": [0, 8, 9], "unexpos": [0, 9], "devic": [0, 9], "g": [0, 9], "transport": [0, 9], "expos": [0, 9], "assess": [0, 8, 9], "contamin": [0, 9], "dure": [0, 9], "colloc": [0, 8, 9], "pair": [0, 9], "place": [0, 9], "independ": [0, 9], "calibr": [0, 9], "audit": [0, 8, 9], "flow": [0, 8, 9], "must": [0, 9], "fix": [0, 9], "verifi": [0, 9], "measur": [0, 9], "At": [0, 9], "least": [0, 9], "twice": [0, 9], "expert": [0, 9], "One": [0, 8, 9], "point": [0, 8, 9], "raw": [0, 8, 9], "check": [0, 9], "week": [0, 9], "gaseou": [0, 9], "concentr": [0, 9], "determin": [0, 9], "perform": [0, 8, 9], "pep": [0, 8, 9], "evalu": [0, 8, 9], "estim": [0, 9], "total": [0, 9], "bia": [0, 9], "transact": [0, 8, 9], "submiss": [0, 8, 9], "rd": [0, 8, 9], "upload": [0, 9], "conduct": [0, 9], "onc": [0, 9], "percent": [0, 9], "between": [0, 9], "aqs_qa_annualperformanceev": [0, 9], "aqs_qa_annualperformanceevaltransact": [0, 9], "defin": [0, 8, 9], "censu": [0, 8, 9], "bureau": [0, 8, 9], "cbsa_cod": [0, 9], "save": [0, 9], "output": [0, 9], "anoth": [0, 9], "later": [0, 9], "thei": [0, 9], "just": [0, 9], "agenc": [1, 3, 7, 8], "refer": [1, 9], "us": [1, 2, 5, 6, 9], "data": [1, 3, 7], "mart": [1, 3, 7], "api": [1, 3, 5, 6, 7, 8], "function": [1, 3, 5, 7], "qualiti": [1, 3, 7, 8], "document": [1, 9], "user": [1, 3, 9], "pyaqsapi": [3, 5, 6, 8], "epa": [3, 6, 9], "aq": [3, 4, 7, 8, 9], "credenti": 3, "librari": [3, 9], "instal": [3, 4], "set": [3, 9], "metadata": 3, "datamart": [6, 7, 9], "raqsapi": [6, 7], "export": 7, "variabl": 7, "load": [7, 9], "monitor": [7, 8], "famili": 8, "seven": 8, "bysit": 8, "bycounti": 8, "bystat": 8, "latitud": 8, "longitud": 8, "bound": 8, "box": 8, "bybox": 8, "primari": 8, "assur": 8, "organ": 8, "core": 8, "base": 8, "statist": 8, "area": 8, "13": 8, "thirteen": 8, "dailydata": 8, "aqs_qa_flowrateaudit": 8, "list": 8, "abov": 8, "about": 9}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"pyaqsapi": [0, 2, 4, 7, 9], "user": [0, 7], "document": 0, "epa": [0, 1], "disclaim": [0, 1], "aq": [0, 1, 6], "datamart": [0, 1], "introduct": [0, 3], "about": [0, 5, 6], "timeli": [0, 6], "data": [0, 6, 8, 9], "raqsapi": [0, 5], "instal": [0, 2], "load": [0, 4], "us": [0, 7], "sign": [0, 7, 9], "up": [0, 7, 9], "set": [0, 7], "credenti": [0, 7, 9], "librari": [0, 7], "function": [0, 8, 9], "export": [0, 9], "variabl": [0, 9], "descript": [0, 9], "usag": [0, 9], "famili": [0, 9], "mart": [0, 8, 9], "api": [0, 9], "metadata": [0, 9], "list": [0, 9], "aggreg": [0, 8, 9], "bysit": [0, 9], "bycounti": [0, 9], "bystat": [0, 9], "monitor": [0, 9], "agenc": [0, 9], "ma": [0, 9], "core": [0, 9], "base": [0, 9], "statist": [0, 9], "area": [0, 9], "cbsa": [0, 9], "primari": [0, 9], "qualiti": [0, 9], "assur": [0, 9], "organ": [0, 9], "pqao": [0, 9], "latitud": [0, 9], "longitud": [0, 9], "bound": [0, 9], "box": [0, 9], "bybox": [0, 9], "miscellan": [0, 9], "refer": 0, "index": 0}, "envversion": {"sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinxcontrib.bibtex": 9, "sphinx": 60}, "alltitles": {"pyaqsapi user documentation": [[0, "pyaqsapi-user-documentation"]], "EPA Disclaimer": [[0, "epa-disclaimer"], [1, "epa-disclaimer"]], "AQS DataMart Disclaimer": [[0, "aqs-datamart-disclaimer"], [1, "aqs-datamart-disclaimer"]], "Introduction": [[0, "introduction"], [3, "introduction"]], "About the timeliness of AQS Data": [[0, "about-the-timeliness-of-aqs-data"], [6, "about-the-timeliness-of-aqs-data"]], "About RAQSAPI": [[0, "about-raqsapi"], [5, "about-raqsapi"]], "Install pyaqsapi": [[0, "install-pyaqsapi"], [2, "install-pyaqsapi"]], "Load pyaqsapi": [[0, "load-pyaqsapi"], [4, "load-pyaqsapi"]], "Using pyaqsapi": [[0, "using-pyaqsapi"], [7, "using-pyaqsapi"]], "Sign up and setting up user credentials with the pyaqsapi library": [[0, "sign-up-and-setting-up-user-credentials-with-the-pyaqsapi-library"], [7, "sign-up-and-setting-up-user-credentials-with-the-pyaqsapi-library"]], "Functions Exported by pyaqsapi": [[0, "functions-exported-by-pyaqsapi"], [9, "functions-exported-by-pyaqsapi"]], "Variable descriptions and usage": [[0, "variable-descriptions-and-usage"], [9, "variable-descriptions-and-usage"]], "pyaqsapi functional families": [[0, "pyaqsapi-functional-families"], [9, "pyaqsapi-functional-families"]], "Sign up and credentials": [[0, "sign-up-and-credentials"], [9, "sign-up-and-credentials"]], "Data Mart API metadata functions": [[0, "data-mart-api-metadata-functions"], [9, "data-mart-api-metadata-functions"]], "Data Mart API list functions": [[0, "data-mart-api-list-functions"], [9, "data-mart-api-list-functions"]], "Data Mart aggregate functions": [[0, "data-mart-aggregate-functions"], [8, "data-mart-aggregate-functions"], [9, "data-mart-aggregate-functions"]], "Data Mart aggregate functions bysite": [[0, "data-mart-aggregate-functions-bysite"], [9, "data-mart-aggregate-functions-bysite"]], "Data Mart aggregate functions bycounty": [[0, "data-mart-aggregate-functions-bycounty"], [9, "data-mart-aggregate-functions-bycounty"]], "Data Mart aggregate functions bystate": [[0, "data-mart-aggregate-functions-bystate"], [9, "data-mart-aggregate-functions-bystate"]], "Data Mart aggregate functions by Monitoring agency (MA)": [[0, "data-mart-aggregate-functions-by-monitoring-agency-ma"], [9, "data-mart-aggregate-functions-by-monitoring-agency-ma"]], "Data Mart aggregate functions by Core Based Statistical Area (cbsa)": [[0, "data-mart-aggregate-functions-by-core-based-statistical-area-cbsa"], [9, "data-mart-aggregate-functions-by-core-based-statistical-area-cbsa"]], "Data Mart aggregate functions by Primary Quality Assurance Organization (pqao)": [[0, "data-mart-aggregate-functions-by-primary-quality-assurance-organization-pqao"], [9, "data-mart-aggregate-functions-by-primary-quality-assurance-organization-pqao"]], "Data Mart aggregate functions by latitude/longitude bounding box (bybox)": [[0, "data-mart-aggregate-functions-by-latitude-longitude-bounding-box-bybox"], [9, "data-mart-aggregate-functions-by-latitude-longitude-bounding-box-bybox"]], "pyaqsapi Miscellaneous functions": [[0, "pyaqsapi-miscellaneous-functions"], [9, "pyaqsapi-miscellaneous-functions"]], "pyaqsapi API reference documentation": [[0, "pyaqsapi-api-reference-documentation"]], "pyaqsapi index": [[0, "pyaqsapi-index"]]}, "indexentries": {"epa disclaimer": [[0, "index-0"], [1, "index-0"]], "functions exported by pyaqsapi": [[0, "index-7"], [9, "index-0"]], "raqsapi": [[0, "index-2"], [5, "index-0"]], "install pyaqsapi": [[0, "index-3"], [2, "index-0"]], "load pyaqsapi": [[0, "index-4"], [4, "index-0"]], "sign_up": [[0, "index-6"], [7, "index-1"]], "timeliness of aqs data": [[0, "index-1"], [6, "index-0"]], "use pyaqsapi": [[0, "index-5"], [7, "index-0"]], "aggregate functions": [[8, "index-0"]], "services": [[8, "index-1"]]}})
\ No newline at end of file
+Search.setIndex({"docnames": ["index", "manual/EPA_Disclaimer", "manual/Install_pyaqsapi", "manual/Introduction", "manual/Load_pyaqsapi", "manual/RAQSAPI", "manual/TimelinessofAQSdata", "manual/Troubleshooting", "manual/Using_pyaqsapi", "manual/pyaqsapiFunctions-Brief", "manual/pyaqsapiFunctions-Long", "manual/pyaqsapiusagetipsandprecautions"], "filenames": ["index.rst", "manual/EPA_Disclaimer.rst", "manual/Install_pyaqsapi.rst", "manual/Introduction.rst", "manual/Load_pyaqsapi.rst", "manual/RAQSAPI.rst", "manual/TimelinessofAQSdata.rst", "manual/Troubleshooting.rst", "manual/Using_pyaqsapi.rst", "manual/pyaqsapiFunctions-Brief.rst", "manual/pyaqsapiFunctions-Long.rst", "manual/pyaqsapiusagetipsandprecautions.rst"], "titles": ["pyaqsapi user documentation", "EPA Disclaimer", "Install pyaqsapi", "Introduction", "Load pyaqsapi", "About RAQSAPI", "About the timeliness of AQS Data", "Troubleshooting", "Using pyaqsapi", "Data Mart aggregate functions", "Functions Exported by pyaqsapi", "Usage tips and precautions"], "terms": {"thi": [0, 1, 3, 8, 10, 11], "softwar": [0, 1], "applic": [0, 1], "wa": [0, 1, 4, 10], "develop": [0, 1], "u": [0, 1, 3, 8, 9, 10], "": [0, 1, 2, 3, 6, 8, 10], "environment": [0, 1, 3, 8], "protect": [0, 1, 3, 8], "usepa": [0, 1, 2], "No": [0, 1], "warranti": [0, 1], "express": [0, 1], "impli": [0, 1], "i": [0, 1, 3, 4, 5, 6, 7, 8, 9, 10, 11], "made": [0, 1], "regard": [0, 1, 8], "accuraci": [0, 1], "util": [0, 1], "system": [0, 1, 3, 10], "nor": [0, 1], "shall": [0, 1], "act": [0, 1], "distribut": [0, 1, 11], "constitut": [0, 1], "ani": [0, 1, 4, 8, 10], "The": [0, 1, 3, 8, 9, 10, 11], "ha": [0, 1, 3], "relinquish": [0, 1], "control": [0, 1, 9, 10], "inform": [0, 1, 3, 8, 10], "longer": [0, 1, 9, 10], "respons": [0, 1, 10], "integr": [0, 1], "confidenti": [0, 1], "avail": [0, 1, 3, 9, 10], "specif": [0, 1, 10], "commerci": [0, 1], "product": [0, 1], "process": [0, 1, 11], "servic": [0, 1, 6, 8, 9, 10, 11], "mark": [0, 1], "trademark": [0, 1], "manufactur": [0, 1], "otherwis": [0, 1], "doe": [0, 1, 5, 6, 8, 11], "endors": [0, 1], "recommend": [0, 1], "favor": [0, 1], "seal": [0, 1], "logo": [0, 1], "manner": [0, 1], "activ": [0, 1], "unit": [0, 1, 3], "state": [0, 1, 3, 9, 10], "govern": [0, 1], "v2": [0, 1, 3], "current": [0, 1, 11], "beta": [0, 1], "phase": [0, 1], "interfac": [0, 1, 3], "been": [0, 1, 3, 10], "final": [0, 1], "mean": [0, 1, 8, 10], "certain": [0, 1, 10, 11], "mai": [0, 1, 7, 8, 11], "chang": [0, 1, 8, 10], "remov": [0, 1], "without": [0, 1, 8, 11], "notic": [0, 1, 11], "As": [0, 1], "result": [0, 1, 3, 7, 9, 10, 11], "packag": [0, 1, 2, 3, 4, 5, 8, 10], "also": [0, 1, 8], "reflect": [0, 1], "respect": [0, 1, 10], "improv": [0, 1], "design": [0, 1], "author": [0, 1], "assum": [0, 1], "liabil": [0, 1], "problem": [0, 1], "occur": [0, 1, 10], "hardwar": [0, 1], "account": [0, 1, 8, 10, 11], "python": [0, 2, 3, 4, 5, 8], "3": [0, 3, 5, 8, 10], "program": [0, 3, 5, 10], "environ": [0, 3, 4, 5], "allow": [0, 3], "connect": [0, 3, 10], "retriev": [0, 3, 6, 8, 9, 10, 11], "from": [0, 3, 6, 8, 9, 10, 11], "air": [0, 3, 8, 10], "directli": [0, 3, 10], "enabl": [0, 3], "omit": [0, 3, 7], "legaci": [0, 3], "challeng": [0, 3, 10], "includ": [0, 3, 10], "coerc": [0, 3, 10], "json": [0, 3], "object": [0, 3, 8, 10], "usabl": [0, 3], "multipl": [0, 3, 9, 10, 11], "year": [0, 3, 9, 10, 11], "format": [0, 3, 9, 10], "request": [0, 3, 8, 9, 10, 11], "handl": [0, 3, 10], "pollut": [0, 3, 10, 11], "rate": [0, 3, 9, 10], "limit": [0, 3, 10, 11], "all": [0, 3, 6, 9, 10], "basic": [0, 3], "have": [0, 3, 5, 8, 10, 11], "implement": [0, 3, 10], "ar": [0, 2, 3, 4, 5, 7, 8, 9, 10, 11], "server": [0, 3, 8, 11], "via": [0, 3, 10, 11], "hypertext": [0, 3], "transfer": [0, 3], "protocol": [0, 3], "http": [0, 2, 3, 10], "so": [0, 3, 8], "need": [0, 3, 6, 8, 11], "extern": [0, 3], "odbc": [0, 3], "driver": [0, 3], "configur": [0, 3], "deal": [0, 3], "secur": [0, 3], "vulner": [0, 3], "associ": [0, 3], "them": [0, 3, 7, 11], "most": [0, 3, 5, 10], "paramet": [0, 3, 5, 7, 8, 10, 11], "return_head": [0, 3, 8, 10], "which": [0, 3, 8, 9, 10], "default": [0, 3, 8, 10], "fals": [0, 3, 8, 10], "If": [0, 3, 6, 8, 10, 11], "decid": [0, 3, 10], "true": [0, 3, 8, 10], "return": [0, 3, 8, 9, 10, 11], "aqsapi_v2": [0, 3, 8, 10], "an": [0, 3, 8, 10], "instanc": [0, 3], "method": [0, 3, 8, 10], "header": [0, 3, 8], "other": [0, 3, 4, 5, 10, 11], "relat": [0, 3, 8, 9, 10, 11], "call": [0, 3, 8, 9, 10], "after": [0, 3, 8, 10], "each": [0, 3, 5, 8, 9, 10, 11], "five": [0, 3], "second": [0, 3], "stall": [0, 3], "invok": [0, 3], "help": [0, 3], "prevent": [0, 3], "overload": [0, 3], "serv": [0, 3], "simpl": [0, 3, 10], "host": [0, 6], "real": [0, 6], "time": [0, 6, 8, 9, 10, 11], "collect": [0, 6, 10, 11], "now": [0, 6], "todai": [0, 6], "pleas": [0, 6, 11], "airnow": [0, 6], "direct": [0, 6, 10], "question": [0, 6], "toward": [0, 6], "work": [0, 6, 11], "cannot": [0, 6], "For": [0, 5, 6, 8, 10, 11], "more": [0, 6, 9, 10, 11], "detail": [0, 6, 10], "see": [0, 6, 10], "section": [0, 6, 10, 11], "7": [0, 6, 9], "1": [0, 6, 7, 11], "page": [0, 6], "To": [0, 2], "first": [0, 2], "clone": [0, 2], "repositori": [0, 2], "git": [0, 2], "github": [0, 2], "com": [0, 2], "next": [0, 2], "project": [0, 2, 5, 8], "root": [0, 2], "directori": [0, 2], "pip": [0, 2], "proper": [0, 2], "depend": [0, 2], "requir": [0, 2, 10], "build": [0, 2], "r": [0, 2], "txt": [0, 2], "while": [0, 2], "still": [0, 2], "setuptool": [0, 2], "m": [0, 2], "like": [0, 4], "make": [0, 4, 9, 10, 11], "sure": [0, 4], "you": [0, 4, 5, 8, 11], "same": [0, 4, 5, 8, 10, 11], "virtual": [0, 4], "where": [0, 4, 9], "import": [0, 4], "those": [0, 8], "who": [0, 8], "alreadi": [0, 8], "familiar": [0, 5, 8], "should": [0, 8, 10], "feel": [0, 5, 8], "few": [0, 8], "minor": [0, 8], "differ": [0, 8, 9, 10], "how": [0, 8, 9, 10, 11], "By": [0, 8, 10], "panda": [0, 8, 10], "frame": [0, 8], "when": [0, 8, 10, 11], "simpli": [0, 8], "manual": [0, 8], "get_data": [0, 8], "class": [0, 8, 10], "get_head": [0, 8], "done": [0, 8], "aqs_sign_up": [0, 8, 10], "take": [0, 8, 9, 10], "one": [0, 5, 8, 9, 10, 11], "input": [0, 8], "email": [0, 8, 10, 11], "charact": [0, 8, 10], "repres": [0, 8, 10], "address": [0, 8, 11], "want": [0, 8, 10], "success": [0, 8], "messag": [0, 8], "sent": [0, 5, 8, 10], "provid": [0, 8, 9, 10, 11], "new": [0, 8], "kei": [0, 8, 10], "access": [0, 8], "can": [0, 8, 10, 11], "regener": [0, 8], "exist": [0, 8, 10, 11], "gener": [0, 8], "A": [0, 8, 10], "e": [0, 8, 10], "mail": [0, 8], "given": [0, 8, 10], "store": [0, 8, 10], "global": [0, 8], "everi": [0, 8, 10], "modul": [0, 8], "valid": [0, 8, 10], "reject": [0, 8], "password": [0, 8], "treat": [0, 8], "plain": [0, 8], "text": [0, 8], "attempt": [0, 8], "encrypt": [0, 8], "would": [0, 8], "usernam": [0, 8, 10], "combin": [0, 8, 10, 11], "suppli": [0, 7, 8], "intend": [0, 8, 11], "authent": [0, 8], "onli": [0, 8, 10, 11], "befor": [0, 8, 10, 11], "aqs_credenti": [0, 8, 10], "enter": [0, 7, 8], "both": [0, 8, 10], "either": [0, 8, 9], "note": [0, 8, 9, 10], "howev": [0, 8], "similar": [0, 5, 8], "sourc": [0, 8], "do": [0, 7, 8, 10, 11], "creat": [0, 8], "sinc": [0, 8], "ew": [0, 8], "contain": [0, 10, 11], "suggest": [0, 11], "complet": [0, 9, 10, 11], "task": [0, 11], "determin": [0, 10, 11], "much": [0, 11], "geographi": [0, 10, 11], "annualdata": [0, 9, 10, 11], "record": [0, 11], "we": [0, 11], "observ": [0, 11], "count": [0, 11], "tempor": [0, 11], "geograph": [0, 10, 11], "monthli": [0, 11], "averag": [0, 10, 11], "routin": [0, 11], "calcul": [0, 10, 11], "must": [0, 7, 10, 11], "yourself": [0, 11], "These": [0, 9, 10, 11], "sampl": [0, 9, 10, 11], "daili": [0, 9, 10, 11], "loss": [0, 11], "fidel": [0, 11], "singl": [0, 10, 11], "valu": [0, 7, 10, 11], "site": [0, 9, 10, 11], "colloc": [0, 9, 10, 11], "mani": [0, 11], "level": [0, 10, 11], "ad": [0, 11], "futur": [0, 11], "some": [0, 10, 11], "criteria": [0, 10, 11], "pm2": [0, 11], "5": [0, 10, 11], "ozon": [0, 11], "lead": [0, 7, 10, 11], "no2": [0, 11], "regul": [0, 11], "defin": [0, 9, 10, 11], "procedur": [0, 11], "left": [0, 11], "investig": [0, 11], "adher": [0, 11], "follow": [0, 10, 11], "size": [0, 11], "queri": [0, 10, 11], "billion": [0, 11], "than": [0, 5, 10, 11], "unsur": [0, 11], "amount": [0, 9, 10, 11], "start": [0, 11], "small": [0, 11], "your": [0, 11], "wai": [0, 11], "000": [0, 11], "row": [0, 11], "field": [0, 11], "frequenc": [0, 11], "wait": [0, 11], "submit": [0, 11], "anoth": [0, 10, 11], "10": [0, 10, 11], "per": [0, 9, 10, 11], "minut": [0, 10, 11], "Be": [0, 11], "advis": [0, 11], "capabl": [0, 11], "being": [0, 9, 10, 11], "multipli": [0, 11], "number": [0, 10, 11], "except": [0, 11], "In": [0, 11], "order": [0, 11], "conveni": [0, 11], "send": [0, 11], "administr": [0, 11], "disabl": [0, 11], "failur": [0, 11], "term": [0, 11], "though": [0, 11], "thei": [0, 7, 10, 11], "contact": [0, 11], "offend": [0, 11], "submodul": [0, 10], "bycbsa": [0, 9, 10], "byma": [0, 9, 10], "With": [0, 10], "entir": [0, 10], "aqs_cbsa": [0, 10], "aqs_class": [0, 10], "aqs_counties_by_st": [0, 10], "aqs_fields_by_servic": [0, 10], "aqs_isavail": [0, 10], "aqs_knownissu": [0, 10], "aqs_ma": [0, 10], "aqs_parameters_by_class": [0, 10], "aqs_pqao": [0, 10], "aqs_removehead": [0, 10], "aqs_revisionhistori": [0, 10], "aqs_sampledur": [0, 10], "aqs_sites_by_counti": [0, 10], "aqs_stat": [0, 10], "annualsummari": [0, 10], "dailysummari": [0, 10], "helperfunct": [0, 10], "quarterlysummari": [0, 10], "sampledata": [0, 9, 10], "qa_annualperformanceev": [0, 9, 10], "qa_annualperformanceevaltransact": [0, 9, 10], "qa_blank": [0, 9, 10], "qa_collocated_assess": [0, 9, 10], "qa_flowrateaudit": [0, 10], "qa_flowrateverif": [0, 9, 10], "qa_one_point_qc": [0, 9, 10], "qa_pep_audit": [0, 9, 10], "transactionsampl": [0, 9, 10], "qa_annualpeferomanceev": [0, 10], "bypqao": [0, 9, 10], "name": [0, 9, 10], "accord": [0, 10], "filter": [0, 10], "full": [0, 9, 10], "variou": [0, 10], "alphabet": [0, 10], "Not": [0, 10], "ref": [0, 10], "aqsobject": [0, 10], "type": [0, 10], "wheen": [0, 10], "bdate": [0, 10], "date": [0, 10], "begin": [0, 10], "select": [0, 10], "cbdate": [0, 10], "option": [0, 10], "last": [0, 10], "indic": [0, 10], "updat": [0, 10], "none": [0, 10], "cedat": [0, 10], "end": [0, 10], "countycod": [0, 10], "digit": [0, 10], "fip": [0, 10], "code": [0, 10], "counti": [0, 9, 10], "zero": [0, 7, 10], "tabl": [0, 10], "durat": [0, 10], "string": [0, 10], "actual": [0, 10], "8": [0, 10], "hour": [0, 10], "co": [0, 10], "o": [0, 10], "roll": [0, 10], "6": [0, 10], "dai": [0, 10], "pm": [0, 10], "pb": [0, 10], "month": [0, 10], "edat": [0, 10], "regist": [0, 10], "verif": [0, 9, 10], "specifi": [0, 7, 10], "conjunct": [0, 10], "ma_cod": [0, 10], "4": [0, 10], "maxlat": [0, 10], "maximum": [0, 9, 10], "decim": [0, 10], "north": [0, 10], "posit": [0, 10], "south": [0, 10], "maxlon": [0, 10], "east": [0, 10], "west": [0, 10], "80": [0, 10], "less": [0, 10], "70": [0, 10], "minlat": [0, 10], "minimum": [0, 10], "minlon": [0, 10], "datafram": [0, 10], "gov": [0, 10], "aqsweb": [0, 10], "data_api": [0, 10], "html": [0, 10], "_": [0, 10], "through": [0, 10], "sitenum": [0, 10], "within": [0, 9, 10], "statefip": [0, 7, 10], "2": [0, 10], "pqao_cod": [0, 10], "two": [0, 10], "meta": [0, 10], "statu": [0, 10], "overview": [0, 10], "known": [0, 10], "issu": [0, 10], "usual": [0, 10], "identifi": [0, 10], "intern": [0, 10], "correct": [0, 10], "histori": [0, 10], "group": [0, 9, 10], "categori": [0, 10], "datat": [0, 10], "instead": [0, 10], "argument": [0, 10], "construct": [0, 10], "receiv": [0, 10], "county_cod": [0, 10], "three": [0, 10], "encod": [0, 10], "restrict": [0, 9, 10], "abl": [0, 9, 10], "repeat": [0, 9, 10], "There": [0, 9, 10], "arrang": [0, 10], "fourteen": [0, 10], "oper": [0, 10], "sampler": [0, 10], "etc": [0, 10], "fine": [0, 10], "grain": [0, 10], "report": [0, 10], "hourli": [0, 10], "sometim": [0, 10], "12": [0, 10], "sever": [0, 10], "accept": [0, 10], "addit": [0, 10], "o_3": [0, 10], "summari": [0, 9, 10], "summar": [0, 10], "midnight": [0, 10], "basi": [0, 10], "local": [0, 10], "annual": [0, 9, 10], "yearli": [0, 10], "maxima": [0, 10], "percentil": [0, 10], "quarterli": [0, 10], "quarterlydata": [0, 10], "blank": [0, 9, 10], "unexpos": [0, 10], "devic": [0, 10], "g": [0, 10], "transport": [0, 10], "expos": [0, 10], "assess": [0, 9, 10], "contamin": [0, 10], "dure": [0, 10], "pair": [0, 10], "place": [0, 10], "independ": [0, 10], "calibr": [0, 10], "audit": [0, 9, 10], "flow": [0, 9, 10], "fix": [0, 10], "verifi": [0, 10], "measur": [0, 10], "At": [0, 10], "least": [0, 10], "twice": [0, 10], "expert": [0, 10], "One": [0, 9, 10], "point": [0, 9, 10], "raw": [0, 9, 10], "check": [0, 10], "week": [0, 10], "gaseou": [0, 10], "concentr": [0, 10], "perform": [0, 9, 10], "pep": [0, 9, 10], "evalu": [0, 9, 10], "estim": [0, 10], "total": [0, 10], "bia": [0, 10], "transact": [0, 9, 10], "submiss": [0, 9, 10], "rd": [0, 9, 10], "upload": [0, 10], "conduct": [0, 10], "onc": [0, 10], "percent": [0, 10], "between": [0, 10], "aqs_qa_annualperformanceev": [0, 10], "aqs_qa_annualperformanceevaltransact": [0, 10], "censu": [0, 9, 10], "bureau": [0, 9, 10], "cbsa_cod": [0, 10], "save": [0, 10], "output": [0, 10], "later": [0, 10], "just": [0, 10], "exactli": [0, 7], "exampl": [0, 7], "alabama": [0, 7], "01": [0, 7], "unexpect": [0, 7], "expect": [0, 7], "port": [0, 5], "anyon": [0, 5], "aim": [0, 5], "featur": [0, 5], "pariti": [0, 5], "neither": [0, 5], "languag": [0, 5], "prefer": [0, 5], "benefit": [0, 5], "over": [0, 5], "d": 0, "ata": 0, "art": 0, "welcom": 0, "aug": 0, "2018": 0, "url": 0, "data_mart_welcom": 0, "2019": 0, "version": 0, "about_aqs_data": 0, "atafram": 0, "januari": 0, "2024": 0, "pydata": 0, "org": 0, "doc": 0, "c": 0, "linton": 0, "ccrowei": 0, "extens": 0, "ambient": 0, "nite": 0, "tate": 0, "nvironment": 0, "p": 0, "rotect": 0, "genci": 0, "ir": 0, "q": 0, "ualiti": 0, "ystem": 0, "v": 0, "2022": 0, "agenc": [1, 3, 8, 9], "refer": [1, 10], "us": [1, 2, 5, 6, 10, 11], "data": [1, 3, 8, 11], "mart": [1, 3, 8, 11], "api": [1, 3, 5, 6, 8, 9, 11], "function": [1, 3, 5, 8, 11], "qualiti": [1, 3, 8, 9], "document": [1, 10], "user": [1, 3, 10, 11], "pyaqsapi": [3, 5, 6, 9], "epa": [3, 6, 10], "aq": [3, 4, 8, 9, 10, 11], "credenti": 3, "librari": [3, 10, 11], "instal": [3, 4], "set": [3, 10], "metadata": 3, "datamart": [6, 8, 10], "raqsapi": [8, 11], "export": 8, "list": [8, 9], "variabl": 8, "load": [8, 10, 11], "monitor": [8, 9, 11], "famili": 9, "seven": 9, "bysit": 9, "bycounti": 9, "bystat": 9, "latitud": 9, "longitud": 9, "bound": 9, "box": 9, "bybox": 9, "primari": 9, "assur": 9, "organ": 9, "core": 9, "base": 9, "statist": [9, 11], "area": 9, "13": 9, "thirteen": 9, "dailydata": 9, "aqs_qa_flowrateaudit": 9, "abov": 9, "about": 10, "aggreg": 11, "up": 11}, "objects": {}, "objtypes": {}, "objnames": {}, "titleterms": {"pyaqsapi": [0, 2, 4, 8, 10], "user": [0, 8], "document": 0, "epa": [0, 1], "disclaim": [0, 1], "aq": [0, 1, 6], "datamart": [0, 1], "introduct": [0, 3], "about": [0, 5, 6], "timeli": [0, 6], "data": [0, 6, 9, 10], "instal": [0, 2], "load": [0, 4], "us": [0, 8], "sign": [0, 8, 10], "up": [0, 8, 10], "set": [0, 8], "credenti": [0, 8, 10], "librari": [0, 8], "usag": [0, 10, 11], "tip": [0, 11], "precaut": [0, 11], "function": [0, 9, 10], "export": [0, 10], "variabl": [0, 10], "descript": [0, 10], "famili": [0, 10], "mart": [0, 9, 10], "api": [0, 10], "metadata": [0, 10], "list": [0, 10], "aggreg": [0, 9, 10], "bysit": [0, 10], "bycounti": [0, 10], "bystat": [0, 10], "monitor": [0, 10], "agenc": [0, 10], "ma": [0, 10], "core": [0, 10], "base": [0, 10], "statist": [0, 10], "area": [0, 10], "cbsa": [0, 10], "primari": [0, 10], "qualiti": [0, 10], "assur": [0, 10], "organ": [0, 10], "pqao": [0, 10], "latitud": [0, 10], "longitud": [0, 10], "bound": [0, 10], "box": [0, 10], "bybox": [0, 10], "miscellan": [0, 10], "troubleshoot": [0, 7], "raqsapi": [0, 5], "refer": 0, "index": 0}, "envversion": {"sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinxcontrib.bibtex": 9, "sphinx": 60}, "alltitles": {"pyaqsapi user documentation": [[0, "pyaqsapi-user-documentation"]], "EPA Disclaimer": [[0, "epa-disclaimer"], [1, "epa-disclaimer"]], "AQS DataMart Disclaimer": [[0, "aqs-datamart-disclaimer"], [1, "aqs-datamart-disclaimer"]], "Introduction": [[0, "introduction"], [3, "introduction"]], "About the timeliness of AQS Data": [[0, "about-the-timeliness-of-aqs-data"], [6, "about-the-timeliness-of-aqs-data"]], "Install pyaqsapi": [[0, "install-pyaqsapi"], [2, "install-pyaqsapi"]], "Load pyaqsapi": [[0, "load-pyaqsapi"], [4, "load-pyaqsapi"]], "Using pyaqsapi": [[0, "using-pyaqsapi"], [8, "using-pyaqsapi"]], "Sign up and setting up user credentials with the pyaqsapi library": [[0, "sign-up-and-setting-up-user-credentials-with-the-pyaqsapi-library"], [8, "sign-up-and-setting-up-user-credentials-with-the-pyaqsapi-library"]], "Usage tips and precautions": [[0, "usage-tips-and-precautions"], [11, "usage-tips-and-precautions"]], "Functions Exported by pyaqsapi": [[0, "functions-exported-by-pyaqsapi"], [10, "functions-exported-by-pyaqsapi"]], "Variable descriptions and usage": [[0, "variable-descriptions-and-usage"], [10, "variable-descriptions-and-usage"]], "pyaqsapi functional families": [[0, "pyaqsapi-functional-families"], [10, "pyaqsapi-functional-families"]], "Sign up and credentials": [[0, "sign-up-and-credentials"], [10, "sign-up-and-credentials"]], "Data Mart API metadata functions": [[0, "data-mart-api-metadata-functions"], [10, "data-mart-api-metadata-functions"]], "Data Mart API list functions": [[0, "data-mart-api-list-functions"], [10, "data-mart-api-list-functions"]], "Data Mart aggregate functions": [[0, "data-mart-aggregate-functions"], [9, "data-mart-aggregate-functions"], [10, "data-mart-aggregate-functions"]], "Data Mart aggregate functions bysite": [[0, "data-mart-aggregate-functions-bysite"], [10, "data-mart-aggregate-functions-bysite"]], "Data Mart aggregate functions bycounty": [[0, "data-mart-aggregate-functions-bycounty"], [10, "data-mart-aggregate-functions-bycounty"]], "Data Mart aggregate functions bystate": [[0, "data-mart-aggregate-functions-bystate"], [10, "data-mart-aggregate-functions-bystate"]], "Data Mart aggregate functions by Monitoring agency (MA)": [[0, "data-mart-aggregate-functions-by-monitoring-agency-ma"], [10, "data-mart-aggregate-functions-by-monitoring-agency-ma"]], "Data Mart aggregate functions by Core Based Statistical Area (cbsa)": [[0, "data-mart-aggregate-functions-by-core-based-statistical-area-cbsa"], [10, "data-mart-aggregate-functions-by-core-based-statistical-area-cbsa"]], "Data Mart aggregate functions by Primary Quality Assurance Organization (pqao)": [[0, "data-mart-aggregate-functions-by-primary-quality-assurance-organization-pqao"], [10, "data-mart-aggregate-functions-by-primary-quality-assurance-organization-pqao"]], "Data Mart aggregate functions by latitude/longitude bounding box (bybox)": [[0, "data-mart-aggregate-functions-by-latitude-longitude-bounding-box-bybox"], [10, "data-mart-aggregate-functions-by-latitude-longitude-bounding-box-bybox"]], "pyaqsapi Miscellaneous functions": [[0, "pyaqsapi-miscellaneous-functions"], [10, "pyaqsapi-miscellaneous-functions"]], "Troubleshooting": [[0, "troubleshooting"], [7, "troubleshooting"]], "About RAQSAPI": [[0, "about-raqsapi"], [5, "about-raqsapi"]], "pyaqsapi API reference documentation": [[0, "pyaqsapi-api-reference-documentation"]], "pyaqsapi index": [[0, "pyaqsapi-index"]], "References": [[0, "references"]]}, "indexentries": {"epa disclaimer": [[0, "index-0"], [1, "index-0"]], "functions exported by pyaqsapi": [[0, "index-7"], [10, "index-0"]], "raqsapi": [[0, "index-9"], [5, "index-0"]], "troubleshooting": [[0, "index-8"], [7, "index-0"]], "usage tips and precautions": [[0, "index-6"], [11, "index-0"]], "install pyaqsapi": [[0, "index-2"], [2, "index-0"]], "load pyaqsapi": [[0, "index-3"], [4, "index-0"]], "sign_up": [[0, "index-5"], [8, "index-1"]], "timeliness of aqs data": [[0, "index-1"], [6, "index-0"]], "use pyaqsapi": [[0, "index-4"], [8, "index-0"]], "aggregate functions": [[9, "index-0"]], "services": [[9, "index-1"]]}})
\ No newline at end of file
diff --git a/docs/_build/spelling/output.txt b/docs/_build/spelling/output.txt
deleted file mode 100644
index e69de29..0000000
diff --git a/docs/conf.py b/docs/conf.py
index a730a87..6aeedb7 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -39,7 +39,7 @@
     "sphinx.ext.autosectionlabel",
 ]
 
-# bibtext file location
+# sphinxcontrib.bibtex bibtext file location
 bibtex_bibfiles = ["manual/pyaqsapi.bib"]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -53,11 +53,12 @@
     "Thumbs.db",
     ".DS_Store",
     "setup.py",
-    "*modules.rst",
     "*setup.rst",
-    "pyaqsapi*.rst",
     "*pyaqsapiFunctions-Brief.rst",
     "genindex.rst",
+    "*pyaqsapi.by*",
+    "*modules.rst",
+    "*pyaqsapi.rst",
 ]
 
 # get rid of those duplicate label warnings when embedding a child rst file
@@ -76,6 +77,11 @@
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ["_static"]
 
+# -- Options for sphinxcontrib.bibtex -----------------------------------------
+bibtex_reference_style = "label"
+bibtex_default_style = "plain"
+bibtex_tooltips = True
+
 # -- Options for Napolean output ---------------------------------------------
 napolean_include_private_with_doc = False
 napolean_include_special_with_doc = False
@@ -84,7 +90,7 @@
 napolean_use_rtype = True
 napolean_reprocess_types = True
 napoleon_google_docstring = True
-napoleon_numpy_docstring = True
+# napoleon_numpy_docstring = True
 
 # -- Options for sphinxcontrib-spelling ---------------------------------------
 spelling_lang = "en_US"
@@ -94,7 +100,7 @@
 spelling_show_whole_line = True
 spelling_warning = True
 spelling_verbose = True
-spelling_ignore_pypi_package_names = False
+spelling_ignore_pypi_package_names = True
 spelling_ignore_python_builtins = True
 spelling_ignore_contributor_names = True
 
diff --git a/docs/ignored_wordlist.txt b/docs/ignored_wordlist.txt
index c3965bd..e3b8455 100644
--- a/docs/ignored_wordlist.txt
+++ b/docs/ignored_wordlist.txt
@@ -2,6 +2,7 @@ annualdata
 annualsummary
 annualperformanceeval
 annualperformanceevaltransaction
+API
 aqs
 Barnstable
 bdate
@@ -23,6 +24,7 @@ DataFrame
 Datamart
 durations
 edate
+EPA
 Fairhope
 flowrate
 flowrateaudit
@@ -35,6 +37,7 @@ listfunctions
 maxima
 maxlat
 maxlon
+Mccrowey
 metadatafunctions
 Millbrook
 minlat
diff --git a/docs/index.rst b/docs/index.rst
index 5a0fcb0..14fcd38 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,27 +1,30 @@
 .. pyaqsapi documentation master file, created by
-   sphinx-quickstart on Mon Oct  4 14:40:23 2021.
+   sphinx-quickstart on Mon Oct 4 14:40:23 2021.
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-.. sectionauthor:: Clinton Mccrowey  epa.gov>
+
+.. sectionauthor:: Clinton Mccrowey  clinton  epa.gov>
 
 ===========================
 pyaqsapi user documentation
 ===========================
 
 .. toctree::
-  :maxdepth: 2
-  :numbered:
-  :hidden:
+   :maxdepth: 2
+   :numbered:
+   :hidden:
 
 .. include:: manual/EPA_Disclaimer.rst
 .. include:: manual/Introduction.rst
 .. include:: manual/TimelinessofAQSdata.rst
-.. include:: manual/RAQSAPI.rst
 .. include:: manual/Install_pyaqsapi.rst
 .. include:: manual/Load_pyaqsapi.rst
 .. include:: manual/Using_pyaqsapi.rst
+.. include:: manual/pyaqsapiusagetipsandprecautions.rst
 .. include:: manual/pyaqsapiFunctions-Long.rst
+.. include:: manual/Troubleshooting.rst
+.. include:: manual/RAQSAPI.rst
 
 
 pyaqsapi API reference documentation
@@ -34,3 +37,10 @@ pyaqsapi index
 --------------
 
 * :ref:`genindex`
+
+References
+----------
+.. bibliography::
+   :style: plain
+   :list: enumerated
+   :filter: docname in docnames
\ No newline at end of file
diff --git a/docs/manual/Introduction.rst b/docs/manual/Introduction.rst
index 9de92a8..6e3192b 100644
--- a/docs/manual/Introduction.rst
+++ b/docs/manual/Introduction.rst
@@ -3,19 +3,19 @@ Introduction
 The pyaqsapi package for the python 3 programming environment allows a python 3
 programming environment to connect to and retrieve data from the United States
 Environmental Protection Agency’s (US EPA) Air Quality System (AQS) Data Mart
-API v2 (Air Quality System)1 interface directly. This package enables the data
-user to omit legacy challenges including coercing data from a JSON object to a
-usable python 3 object, retrieving multiple years of data, formatting API
-requests, retrieving results, handling credentials, requesting multiple
-pollutant data and rate limiting data requests. All the basic functionality
-of the API have been implemented that are available from the AQS API Data Mart
-server. The library connects to AQS Data Mart API via Hypertext Transfer
-Protocol (HTTP) so there is no need to install external ODBC drivers, configure
-ODBC connections or deal with the security vulnerabilities associated with
-them. Most functions have a parameter, return_header which by default is set
-to FALSE. If the user decides to set return_header to TRUE, then that function
-will return a python 3 AQS_DATAMART_APIv2 object. An AQS_DATAMART_APIv2 object
-has instance methods for retrieving the data requested, header information,
-and other metadata related to the API call. After each call to the API a five
-second stall is invoked to help prevent overloading the Data Mart API server
-and to serve as a simple rate limit.
+API v2 (Air Quality System) :cite:t:`AQSDataMartWelcome` interface directly.
+This package enables the data user to omit legacy challenges including coercing
+data from a JSON object to a usable python 3 object, retrieving multiple years
+of data, formatting API requests, retrieving results, handling credentials,
+requesting multiple pollutant data and rate limiting data requests.
+All the basic functionality of the API have been implemented that are available
+from the AQS API Data Mart server. The library connects to AQS Data Mart API
+via Hypertext Transfer Protocol (HTTP) so there is no need to install external
+ODBC drivers, configure ODBC connections or deal with the security
+vulnerabilities associated with them. Most functions have a parameter,
+return_header which by default is set to FALSE. If the user decides to
+set return_header to TRUE, then that function will return a python 3 
+AQSAPI_V2 object. An AQSAPI_V2 object has instance methods for retrieving the
+data requested, header information, and other metadata related to the API call.
+After each call to the API a five second stall is invoked to help prevent
+overloading the Data Mart API server and to serve as a simple rate limit.
diff --git a/docs/manual/RAQSAPI.rst b/docs/manual/RAQSAPI.rst
index d49bb65..41d8abf 100644
--- a/docs/manual/RAQSAPI.rst
+++ b/docs/manual/RAQSAPI.rst
@@ -2,11 +2,10 @@
 
 About RAQSAPI
 =============
-pyaqsapi is a port of `RAQSAPI `_ to the
+pyaqsapi is a port of :cite:t:`Rpackage:RAQSAPI` to the
 python 3 programming environment. For anyone that is familiar with RAQSAPI, 
 the pyaqsapi API will feel familiar to you, most of the functions are similar 
 and the parameters sent to each functions are the same. pyaqsapi aims to have 
 feature parity with RAQSAPI and neither project will have features that the
 other project does not - other than programming language environment or
-language preference there is no benefit to using one package over the other.
-
+language preference there is no benefit to using one package over the other.
\ No newline at end of file
diff --git a/docs/manual/TimelinessofAQSdata.rst b/docs/manual/TimelinessofAQSdata.rst
index 6b76349..03a6666 100644
--- a/docs/manual/TimelinessofAQSdata.rst
+++ b/docs/manual/TimelinessofAQSdata.rst
@@ -5,6 +5,6 @@ About the timeliness of AQS Data
 
 EPA's AQS Datamart API, the service that pyaqsapi retrieves data from, does not
 host real time (collected now/today) data. If real time data is needed, please
-use the AirNow API and direct all questions toward real time data there. RAQSAPI
-does not work with AirNow and cannot retrieve real time data. For more details
-see section 7.1 of the About AQS Data page.
\ No newline at end of file
+use the AirNow API and direct all questions toward real time data there.
+pyaqsapi does not work with AirNow and cannot retrieve real time data. For more
+details see section 7.1 of the About AQS Data page :cite:t:`AboutAQSdata`.
\ No newline at end of file
diff --git a/docs/manual/Troubleshooting.rst b/docs/manual/Troubleshooting.rst
new file mode 100644
index 0000000..6b4e87c
--- /dev/null
+++ b/docs/manual/Troubleshooting.rst
@@ -0,0 +1,9 @@
+.. index:: Troubleshooting
+
+Troubleshooting
+===============
+
+Parameters must be supplied exactly as they are specified, for example the
+stateFIPS for Alabama is "01", entering a value of "1" for the stateFIPS
+may lead to unexpected results. Do not omit leading zeros in parameters that
+expect them.
\ No newline at end of file
diff --git a/docs/manual/Using_pyaqsapi.rst b/docs/manual/Using_pyaqsapi.rst
index b384238..fe44152 100644
--- a/docs/manual/Using_pyaqsapi.rst
+++ b/docs/manual/Using_pyaqsapi.rst
@@ -2,16 +2,17 @@
 
 Using pyaqsapi
 ==============
-For those who are already familiar with using RAQSAPI then the pyaqsapi API
-should feel familiar with a few minor differences regarding how the data is
-returned.
+For those who are already familiar with using :cite:t:`Rpackage:RAQSAPI`
+RAQSAPI then the pyaqsapi API should feel familiar with a few minor differences
+regarding how the data is returned.
 
-All data is returned using pandas Data Frames. Exported functions from pyaqsapi
-have a parameter RETURN_HEADER, by default this parameter is False. When False
-these functions simply return the requested data as a pandas Data Frame. If
-RETURN_HEADER is manually set to True an AQSAPI_V2 python 3 object is returned.
-Use the get_data() class method to retrieve the data, get_header() class
-method to retrieve header information.
+By default data is returned as a pandas Data Frames :cite:t:`pandas_DataFrame`.
+Exported functions from pyaqsapi have a parameter RETURN_HEADER, by default
+this parameter is False. When False functions simply return the requested
+data as a pandas Data Frame. If RETURN_HEADER is manually set to True a list of
+AQSAPI_V2 python 3 objects are returned. Use the get_data() class method to
+retrieve the data and the get_header() class method to retrieve header
+information.
 
 .. index:: sign_up
 
diff --git a/docs/manual/pyaqsapi.bib b/docs/manual/pyaqsapi.bib
index 59226a1..58c4a73 100644
--- a/docs/manual/pyaqsapi.bib
+++ b/docs/manual/pyaqsapi.bib
@@ -1,49 +1,49 @@
-@misc{cleanairact,
-      authors = "Environmental Protection Agency",
-      title = "Overview of the {C}lean {A}ir {A}ct and {A}ir {P}ollution",
-      month = "February",
-      year = "2021",
-      url = "https://www.epa.gov/clean-air-act-overview"
+@online{cleanairact,
+        authors = "{US} {E}nvironmental {P}rotection {A}gency",
+        title = "Overview of the {C}lean {A}ir {A}ct and {A}ir {P}ollution",
+        month = "February",
+        year = "2021",
+        url = "https://www.epa.gov/clean-air-act-overview"
 }
 
-@electronic{AboutAQSdata,
-      authors = "US EPA AQS Data Mart Team",
-      title = "About {AQS} Data",
-      month = "May",
-      year = "2019",
-      url = "https://aqs.epa.gov/aqsweb/documents/about_aqs_data.html",
-      note = "Version 1.1"
+@online{AboutAQSdata,
+        authors = "{US} {EPA} {AQS} {D}ata{M}art Team",
+        title = "About {AQS} Data",
+        month = "May",
+        year = "2019",
+        url = "https://aqs.epa.gov/aqsweb/documents/about_aqs_data.html",
+        note = "Version 1.1"
 }
 
-@electronic{website:GNUproject,
-      authors = "Free Software Foundation",
-      title = "GNU Operating System",
-      month = "Feburaury",
-      year = "2020",
-      url = "https://www.gnu.org"
+@online{website:GNUproject,
+        authors = "{F}ree {S}oftware {F}oundation",
+        title = "{GNU} Operating System",
+        month = "February",
+        year = "2020",
+        url = "https://www.gnu.org"
 }
 
-@electronic{AQSDataMartWelcome,
-      authors = "US EPA AQS Data Mart Team",
-      title = "AQS Data Mart Welcome",
-      month = "Aug",
-      year = "2018",
-      url = "https://aqs.epa.gov/aqsweb/documents/data_mart_welcome.html"
+@online{AQSDataMartWelcome,
+        authors = "{US} {EPA} {AQS} {D}ata{M}art Team",
+        title = "{AQS} {D}ata{M}art Welcome",
+        month = "Aug",
+        year = "2018",
+        url = "https://aqs.epa.gov/aqsweb/documents/data_mart_welcome.html"
 }
 
-@Manual{package:lintr,
-   title = {lintr: A 'Linter' for R Code},
-   author = {Jim Hester and Florent Angly and Russ Hyde},
-   year = {2020},
-   note = {R package version 2.0.1},
-   url = {https://CRAN.R-project.org/package=lintr},
+@Misc{Rpackage:RAQSAPI,
+      title = "A {R} extension to retrieve ambient air monitoring data from
+               the {U}nited {S}tates {E}nvironmental {P}rotection {A}gency’s
+               ({US EPA}) {A}ir
+               {Q}uality {S}ystem ({AQS}) {D}ata{M}art {API} {V}2 interface",
+      author = "{C}linton {M}ccrowey",
+      year = {2022},
+      url = {https://github.com/USEPA/RAQSAPI},
 }
 
-@Misc{py3package:RAQSAPI,
-   title = {A R extension to retrieve ambient air monitoring data from
-            the United States Environmental Protection Agency’s (US EPA) Air
-            Quality System (AQS) Data Mart API v2 interface},
-   author = {Clinton Mccrowey},
-   year = {2022},
-   url = {https://github.com/USEPA/RAQSAPI},
-}
+@online{pandas_DataFrame,
+        title = "pandas.{D}ataFrame",
+        month = "January",
+        year = "2024",
+        url = "https://pandas.pydata.org/docs/reference/api/pandas.DataFrame.html"
+}
\ No newline at end of file
diff --git a/docs/manual/pyaqsapiusagetipsandprecautions.rst b/docs/manual/pyaqsapiusagetipsandprecautions.rst
new file mode 100644
index 0000000..0ca0c1f
--- /dev/null
+++ b/docs/manual/pyaqsapiusagetipsandprecautions.rst
@@ -0,0 +1,58 @@
+.. index:: Usage tips and precautions
+
+Usage tips and precautions
+==========================
+
+This section contains suggestions for completing certain data related tasks.
+
+* Determine if or how much data exists for a time-parameter-geography
+  combination:
+
+    * Retrieve data using the annualdata service.
+    * If no records are returned, we do not have the data.
+    * If records are returned, use the observation count to determine the
+      temporal and geographic distribution of the data.
+
+* Monthly averages:
+
+    * AQS does not routinely calculate monthly aggregate statistics.
+    * If you need these, you must calculate them yourself.
+    * These can be calculated from the sample data or the daily data without
+      loss of fidelity.
+
+* Determine a single value for a site with collocated monitors:
+
+    * Many sites will have collocated monitors - monitors collecting the same
+      parameter at the same time.
+    * The API currently provides only monitor level values. (site-level values
+      will be added in the future.)
+    * For some criteria pollutants (PM2.5, ozone, lead, and NO2), the
+      regulations define procedures for defining a single site-level value.
+    * For other pollutants, determining a single site-level value is left to
+      the investigator.
+
+* **Please adhere to the following when using the AQS Data Mart API**:
+
+    * *Limit the size of queries*. The AQS Data Mart contains billions of
+       values and you may request more than you intend. If you are unsure of
+       the amount of data, start small and work your way up. Please limit
+       queries to 1,000,000 rows of data each. You can use the
+       "observation count" field on the annualdata service to determine how
+       much data exists for a time-parameter-geography combination.
+    * *Limit the frequency of queries*. The AQS Data Mart can process a limited
+       load. Please wait for one request to complete before submitting another
+       and do not make more than 10 requests per minute.
+    * Be advised that RAQSAPI is capable of retrieving results for multiple
+      pollutants, this can result in the amount of data being returned being
+      multiplied by the number of pollutants being requested.
+    * Be advised that the AQS Data Mart API limits certain data requests to
+      one year of data at a time with the exception of the Monitor service.
+      In order to retrieve multiple years of data for these functions the
+      RAQSAPI library conveniently sends multiple API requests to the Data Mart
+      API server, one request for each year, this can result in the amount of
+      data being returned being multiplied by the number of years of data being
+      requested.
+
+**The AQS Data Mart administrators may disable accounts without notice for
+failure to adhere to these terms (Though they will contact the offending
+user via the email address provided)**
\ No newline at end of file
diff --git a/docs/pyaqsapi.rst b/docs/pyaqsapi.rst
index b2cad20..48ffb40 100644
--- a/docs/pyaqsapi.rst
+++ b/docs/pyaqsapi.rst
@@ -1,5 +1,11 @@
 pyaqsapi API reference documentation
-================
+====================================
+
+objects exported by pyaqsapi
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+APIAQSAPI_V2
+.. autoclass:: AQSAPI_V2
+   :members: set_data, set_header, get_data, get_header, get_status_code, get_header, get_url, get_header, get_request_time
 
 pyaqsapi base Package
 ~~~~~~~~~~~~~~~~~~~~~
diff --git a/pyaqsapi/bybox/bybox.py b/pyaqsapi/bybox/bybox.py
index 8023bc4..8fdec75 100644
--- a/pyaqsapi/bybox/bybox.py
+++ b/pyaqsapi/bybox/bybox.py
@@ -50,14 +50,14 @@ def monitors(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of all ozone monitors in the vicinity of
     central Alabama that operated in 1995.
 
     import pyaqsapi as aqs
     from datetime import date
-    ....
+
     aqs.bybox.monitors(parameter="44201",
                        bdate=date(year=1995, month=1, day=1),
                        edate=date(year=1995, month=12, day=31),
@@ -69,8 +69,8 @@ def monitors(
     Returns
     -------
     pandas DataFrame or an AQSAPI_V2 object
-        Returns a table of monitors from a latitude/longitude bounding
-        box (_by_box).
+    Returns a table of monitors from a latitude/longitude bounding
+    box (_by_box).
 
     """
     # The monitors service does not is able to oull multiple years of data
@@ -156,21 +156,22 @@ def sampledata(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing all ozone samples in the vicinity of
     central Alabama between May 1, 2015 - May 2, 2017.
 
-        import pyaqsapi as aqs
-        from datetime import date
-        ....
-        aqs.bybox.sampledata(parameter="44201",
-                             bdate=date(year=2015, month=5, day=1),
-                             edate=date(year=2015, month=5, day=2),
-                             minlat="33.3",
-                             maxlat="33.6",
-                             minlon="-87.0",
-                             maxlon="-86.7")
+    import pyaqsapi as aqs
+    from datetime import date
+
+    aqs.bybox.sampledata(parameter="44201",
+                         bdate=date(year=2015, month=5, day=1),
+                         edate=date(year=2015, month=5, day=2),
+                         minlat="33.3",
+                         maxlat="33.6",
+                         minlon="-87.0",
+                         maxlon="-86.7")
+
     Returns
     -------
     (pandas DataFrame or an AQSAPI_V2 object): sample data for all monitors
@@ -247,21 +248,21 @@ def annualsummary(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing ozone annual summaries in the vicinity of
     central Alabama for the first two days of May, 2015.
 
-        import pyaqsapi as aqs
-        from datetime import date
-        ...
-        aqs.bybox.annualsummary(parameter="44201",
-                                bdate=date(year=2015, month=5, day=1),
-                                edate=date(year=2015, month=5, day=2),
-                                minlat="33.3",
-                                maxlat="33.6",
-                                minlon="-87.0",
-                                maxlon="-86.7")
+    import pyaqsapi as aqs
+    from datetime import date
+
+    aqs.bybox.annualsummary(parameter="44201",
+                            bdate=date(year=2015, month=5, day=1),
+                            edate=date(year=2015, month=5, day=2),
+                            minlat="33.3",
+                            maxlat="33.6",
+                            minlon="-87.0",
+                            maxlon="-86.7")
 
     Returns
     -------
@@ -337,8 +338,8 @@ def dailysummary(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of ozone daily summaries in the vicinity of
     central Alabama for the first two days of May 2015::
 
@@ -405,8 +406,8 @@ def quarterlysummary(
     stateFIPS and county_code provided for bdate - edate time frame.
     Variables returned include mean value, maxima, percentiles, and etc.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of quarterly summary to be
     retrieved at a time. This function conveniently extracts date
     information from the bdate and edate parameters then makes repeated
@@ -446,8 +447,8 @@ def quarterlysummary(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing ozone quarterly summaries
     in the vicinity of central Alabama for each quarter in
     between 2015 - 2017::
diff --git a/pyaqsapi/bycbsa/bycbsa.py b/pyaqsapi/bycbsa/bycbsa.py
index e63ba71..c9d72a7 100644
--- a/pyaqsapi/bycbsa/bycbsa.py
+++ b/pyaqsapi/bycbsa/bycbsa.py
@@ -42,8 +42,8 @@ def monitors(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of NO2 monitors for the
     Charlotte-Concord-Gastonia, NC cbsa that were operating
     on January 01, 2017::
@@ -136,8 +136,8 @@ def sampledata(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame which contains NO2 data
     for Charlotte-Concord-Gastonia, NC cbsa for
     January 1, 2015 - January 01, 2017::
@@ -214,8 +214,8 @@ def annualsummary(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of annual summary NO2
     data the for Charlotte-Concord-Gastonia, NC cbsa on
     January 01, 2017::
@@ -293,8 +293,8 @@ def dailysummary(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Returns a DataFrame of NO2 daily summary
     data the for Charlotte-Concord-Gastonia, NC cbsa on
     January 01, 2017::
@@ -342,8 +342,8 @@ def quarterlysummary(
     Return quarterly summary data aggregated by Core Based Statistical Area
     (cbsa_code).
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of quarterly summary to be
     retrieved at a time. This function conveniently extracts date
     information from the bdate and edate parameters then makes repeated
@@ -384,8 +384,9 @@ def quarterlysummary(
              to None.
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
-    Example
-    -------
+
+    Examples
+    --------
     Return a DataFrame of NO2 quarterly summary
     data the for Charlotte-Concord-Gastonia, NC cbsa for
     each quarter in 2017.::
diff --git a/pyaqsapi/bycounty/bycounty.py b/pyaqsapi/bycounty/bycounty.py
index 2b54d2a..42aa802 100644
--- a/pyaqsapi/bycounty/bycounty.py
+++ b/pyaqsapi/bycounty/bycounty.py
@@ -52,8 +52,8 @@ def monitors(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return an DataFrame containing all SO2 monitors in
     Hawaii County, HI that were operating on May 1, 2015::
 
@@ -149,8 +149,8 @@ def qa_flowrateaudit(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of flow rate audit data for
     Jefferson County, AL for January 2018::
 
@@ -240,8 +240,8 @@ def qa_one_point_qc(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of flow rate audit data for
     Jefferson County, AL for January 2018::
 
@@ -301,8 +301,8 @@ def qa_pep_audit(
     (PEP) audit data aggregated by parameter code, stateFIPS and countycode for
     bdate - edate time frame.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of pep audit data
     to be retrieved at a time. This function conveniently extracts date
     information from the bdate and edate parameters then makes repeated
@@ -346,8 +346,8 @@ def qa_pep_audit(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame with PEP Audit data for FRM
     PM2.5 in Madison County, AL for 2017::
 
@@ -456,8 +456,8 @@ def sampledata(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return all FRM/FEM PM2.5 data for Wake County, NC between
     January 1, 2015 - February 28, 2016::
 
@@ -547,8 +547,9 @@ def annualsummary(
              to None.
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
-    Example
-    -------
+
+    Examples
+    --------
     Returns all FRM/FEM PM2.5 data for Wake County, NC between
     January 1, 2015 - February 28, 2016::
 
@@ -642,8 +643,8 @@ def qa_blanks(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame with PM2.5 blank data for
     Colbert County, AL for January 2018::
 
@@ -736,8 +737,8 @@ def dailysummary(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return an aqs S3 object of daily summary FRM/FEM PM2.5 data
     for Wake County, NC between January and February 2016::
 
@@ -828,8 +829,8 @@ def qa_collocated_assessments(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame with collocated assessment data
     for FRM PM2.5 in Madison County, AL for January 2013::
 
@@ -920,8 +921,8 @@ def qa_flowrateverification(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Returns a DataFrame of flow rate verification data for
     Colbert County, AL for January 2018::
 
@@ -1014,8 +1015,8 @@ def transactionsample(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return all FRM/FEM transaction data for
     Wake County, NC on February 23, 2016::
 
@@ -1107,8 +1108,8 @@ def qa_annualperformanceeval(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing annual performance evaluation data (raw)
     for ozone in Baldwin County, AL for 2017 in RD format::
 
@@ -1203,8 +1204,8 @@ def qa_annualperformanceevaltransaction(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing annual performance evaluation data (raw)
     for ozone in Baldwin County, AL for 2017 in RD format::
 
@@ -1268,8 +1269,8 @@ def quarterlysummary(
     stateFIPS and county_code provided for bdate - edate time frame.
     Variables returned include mean value, maxima, percentiles, and etc.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of quarterly summary to be
     retrieved at a time. This function conveniently extracts date
     information from the bdate and edate parameters then makes repeated
@@ -1316,8 +1317,8 @@ def quarterlysummary(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing quarterly summaries for
     FRM/FEM PM2.5 data for Wake County, NC for each quarter of 2016::
 
diff --git a/pyaqsapi/byma/byma.py b/pyaqsapi/byma/byma.py
index dddb8b2..79678be 100644
--- a/pyaqsapi/byma/byma.py
+++ b/pyaqsapi/byma/byma.py
@@ -36,8 +36,8 @@ def qa_flowrateaudit(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of flow rate audit data
     for FRM PM2.5 January 2016 - January 2018 where the Monitoring Agency is
     the Jefferson County, AL  Department of Health (agency 0550)::
@@ -109,8 +109,8 @@ def qa_one_point_qc(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of ozone One Point QC data
     in January 2018 where the Monitoring Agency is the
     Massachusetts Department of Environmental Protection (agency 0660)::
@@ -183,8 +183,8 @@ def qa_pep_audit(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of PEP audit data in June 2017 where the
     Monitoring Agency is the Alabama Department
     of Environmental Management (agency 0013)::
@@ -263,8 +263,8 @@ def qa_blanks(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing PM2.5 blank data in
     January 2018 where the Monitoring Agency is the Alabama
     Department of Environmental Management (agency 0013)::
@@ -337,8 +337,8 @@ def qa_collocated_assessments(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing collocated assessment
     data for FRM PM2.5 January 2013 where the Monitoring Agency is
     the Alabama Department of Environmental Management (agency 0013)::
@@ -415,8 +415,8 @@ def qa_flowrateverification(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing collocated assessment
     data for FRM PM2.5 January 2013 where the Monitoring Agency is
     the Alabama Department of Environmental Management (agency 0013)::
@@ -495,8 +495,8 @@ def transactionsample(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of ozone transaction sample data for all monitors
     operated by South Coast Air Quality Management District collected
     on May 15, 2015::
@@ -570,8 +570,8 @@ def qa_annualpeferomanceeval(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing annual performance evaluation data for
     ozone where the monitoring agency is the Alabama Department of
     Environmental Management (MA_code 0013).::
@@ -650,8 +650,8 @@ def qa_annualperformanceevaltransaction(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing annual performance evaluation data for
     ozone in where the MA is the Alabama Department of Environmental
     Management (MA_code 0013) for 2017 in RD format.::
diff --git a/pyaqsapi/bypqao/bypqao.py b/pyaqsapi/bypqao/bypqao.py
index f4cf1a3..decfa56 100644
--- a/pyaqsapi/bypqao/bypqao.py
+++ b/pyaqsapi/bypqao/bypqao.py
@@ -40,8 +40,8 @@ def qa_flowrateaudit(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of flow rate audit data for January
     2018 where the PQAO is the Jefferson County, AL Department Of
     Health (agency 0550).::
@@ -114,8 +114,8 @@ def qa_one_point_qc(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFramee of flow rate audit data for January 2018 where the
     PQAO is the Jefferson County, AL Department of Health (agency 0550)::
 
@@ -191,8 +191,8 @@ def qa_pep_audit(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of PEP audit data in June 2017 where the pqao is the
     Alabama Department of Environmental Management (agency 0013)::
 
@@ -267,8 +267,8 @@ def qa_blanks(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return DataFrame of PM2.5 blank data in January 2018 where the PQAO is
     the Alabama Department of Environmental Management (agency 0013)::
 
@@ -343,8 +343,8 @@ def qa_collocated_assessments(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Returns a DataFrame of collocated assessment
     data for FRM PM2.5 in January 2013 where the PQAO is the Alabama
     Department of Environmental Management (agency 0013)::
@@ -422,8 +422,8 @@ def qa_flowrateverification(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of collocated assessment
     data for FRM PM2.5 in January 2013 where the PQAO is the Alabama
     Department of Environmental Management (agency 0013)::
@@ -502,8 +502,8 @@ def qa_annualperformanceeval(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing annual performance evaluation data
     for ozone where the PQAO is the Alabama Department of
     Environmental Management (pqao_code 0013).::
@@ -584,8 +584,8 @@ def qa_annualperformanceevaltransaction(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing annual performance evaluation data for
     ozone in where the PQAO is the Alabama Department of
     Environmental Management (pqao_code 0013) for 2017 in RD format.::
diff --git a/pyaqsapi/bysite/bysite.py b/pyaqsapi/bysite/bysite.py
index f31dee0..2419136 100644
--- a/pyaqsapi/bysite/bysite.py
+++ b/pyaqsapi/bysite/bysite.py
@@ -23,8 +23,8 @@ def monitors(
          with the provided parameter, stateFIPS, county_code, and sitenum
          for bdate - edate time frame.
 
-    Note
-    ----
+    Notes
+    -----
     All monitors that operated between the bdate and edate will be returned
 
     Parameters
@@ -61,8 +61,8 @@ def monitors(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a table of all SO2 monitors at the Hawaii NP site (#0007) in
     Hawaii County, HI that were operating between May 1 2015-2019::
 
@@ -131,8 +131,8 @@ def qa_flowrateaudit(
     parameter code, stateFIPS, countycode and site number for
     bdate - edate time frame.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of flow rate audit data to
     be retrieved at a time. This function conveniently extracts date
     information from the bdate and edate parameters then makes repeated
@@ -179,8 +179,8 @@ def qa_flowrateaudit(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Returns a table of all SO2 monitors at the Hawaii NP site (#0007) in
     Hawaii County, HI that were operating on May 1, 2018::
 
@@ -243,8 +243,8 @@ def qa_one_point_qc(
     Return a table of one point QC raw data aggregated
     by parameter code, stateFIPS, countycode and site number.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of flow rate audit data to
     be retrieved at a time. This function conveniently extracts date
     information from the bdate and edate parameters then makes repeated
@@ -291,8 +291,8 @@ def qa_one_point_qc(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Returns a One Point QC data for ozone at the Truro National Seashore
     site (#0002) in Barnstable County, MA in January 2018::
 
@@ -354,8 +354,8 @@ def sampledata(
     """
     Returns sample data where the data is aggregated at the site level.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of sampledata to
     be retrieved at a time. This function conveniently extracts date
     information from the bdate and edate parameters then makes repeated
@@ -411,8 +411,8 @@ def sampledata(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of ozone monitoring data for the
     Millbrook School site (/#0014) in Wake County, NC for June 18, 2017::
 
@@ -479,8 +479,8 @@ def annualsummary(
     stateFIPS, county_code, and sitenum provided for bdate - edate time frame.
     Variables returned include mean value, maxima, percentiles, and etc.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of annualsummary data to
     be retrieved at a time. This function conveniently extracts date
     information from the bdate and edate parameters then makes repeated
@@ -527,8 +527,8 @@ def annualsummary(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a table of annual summary ozone data for the Millbrook School
     site (#0014) in Wake County, NC for 2017 (Note, for annual data, only
     the year portion of the bdate and edate are used and only whole
@@ -597,8 +597,8 @@ def qa_blanks(
     to assess if contamination is occurring during the transport
     or handling of the samples. Data is aggregated at the site level.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of qa_blank data to
     be retrieved at a time. This function conveniently extracts date
     information from the bdate and edate parameters then makes repeated
@@ -645,8 +645,8 @@ def qa_blanks(
     return_header : If FALSE (default) only returns data requested. If TRUE
     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a table of PM2.5 blank data for the Muscle Shoals site (#0014) in
     Colbert County, AL for January 2018::
 
@@ -712,8 +712,8 @@ def dailysummary(
     county_code, and sitenum provided for bdate - edate time frame. Variables
     returned include mean value, maxima, percentiles, and etc.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of dailysummary data to
     be retrieved at a time. This function conveniently extracts date
     information from the bdate and edate parameters then makes repeated
@@ -760,8 +760,8 @@ def dailysummary(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of daily summary ozone data for the Millbrook School
     site (#0014) in Wake County, NC for June 18, 2017::
 
@@ -825,8 +825,8 @@ def qa_collocated_assessments(
     input parameter, stateFIPS, county_code, and sitenum provided for
     bdate - edate time frame.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of collocated assessments
     data to be retrieved at a time. This function conveniently extracts
     date information from the bdate and edate parameters then makes
@@ -873,8 +873,8 @@ def qa_collocated_assessments(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of collocated assessment data for FRM PM2.5 at the
     Huntsville Old Airport site (#0014) in Madison County, AL
     for January 2013::
@@ -940,8 +940,8 @@ def qa_flowrateverification(
     matching input parameter, stateFIPS, county_code, and sitenum provided for
     bdate - edate time frame.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of flow rate verifications
     data to be retrieved at a time. This function conveniently extracts
     date information from the bdate and edate parameters then makes
@@ -988,8 +988,8 @@ def qa_flowrateverification(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of flow rate verification
     data for the Muscle Shoals site (#1002) in Colbert County, AL
     for January 2018::
@@ -1054,8 +1054,8 @@ def transactionsample(
     by matching input parameter, stateFIPS, county_code, and sitenum provided
     for bdate - edate time frame.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of transaction data
     data to be retrieved at a time. This function conveniently extracts
     date information from the bdate and edate parameters then makes
@@ -1102,8 +1102,8 @@ def transactionsample(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return all ozone transaction data for the Millbrook School site (#0014)
     in Wake County, NC for June 18, 2017::
 
@@ -1168,8 +1168,8 @@ def qa_annualpeferomanceeval(
     parameter, sitenum, countycode and stateFIPS provided for
     bdate - edate time frame.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of quality assurance
     Annual Performance Evaluation data to be retrieved at a time. This
     function conveniently extracts date information from the bdate and edate
@@ -1216,8 +1216,8 @@ def qa_annualpeferomanceeval(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return an DataFrame containing annual performance evaluation data for
     ozone at the Fairhope site in Baldwin County, AL for 2017::
 
@@ -1284,8 +1284,8 @@ def qa_annualperformanceevaltransaction(
     input parameter, sitenum, countycode and stateFIPS provided for
     bdate - edate time frame.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of quality assurance
     Annual Performance Evaluation transaction data to be retrieved at a time.
     This function conveniently extracts date information from the bdate and
@@ -1332,8 +1332,8 @@ def qa_annualperformanceevaltransaction(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing annual performance evaluation data (raw)
     for ozone at the Fairhope site in Baldwin County, AL for 2017
     in RD format::
@@ -1401,8 +1401,8 @@ def quarterlysummary(
     stateFIPS, county_code, and sitenum provided for bdate - edate time frame.
     Variables returned include mean value, maxima, percentiles, and etc.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of quarterly summary to be
     retrieved at a time. This function conveniently extracts date
     information from the bdate and edate parameters then makes repeated
@@ -1452,8 +1452,8 @@ def quarterlysummary(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return DataFrame containing quarterly summaries for FRM/FEM PM2.5 data
     for Millbrook School in Wake County, NC for each quarter of 2016.::
 
@@ -1516,8 +1516,8 @@ def qa_pep_audit(
     data aggregated by parameter code, stateFIPS, countycode and
     site number for the time frame between bdate and edate.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of pep audit data
     to be retrieved at a time. This function conveniently extracts date
     information from the bdate and edate parameters then makes repeated
@@ -1564,8 +1564,8 @@ def qa_pep_audit(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of pep Audit data for FRM PM2.5
     at the Huntsville Old Airport site (#0014) in Madison County, AL
     for 2017 - 2019::
diff --git a/pyaqsapi/bystate/bystate.py b/pyaqsapi/bystate/bystate.py
index 8f71a24..42feb00 100644
--- a/pyaqsapi/bystate/bystate.py
+++ b/pyaqsapi/bystate/bystate.py
@@ -47,18 +47,18 @@ def monitors(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of SO2 monitors in Hawaii that were operating on
     May 01, 2017.
 
-        import pyaqsapi as aqs
-        from datetime import date
-        ...
-        aqs.bystate.monitors(parameter="88101",
-                             bdate=date(year=2017, month=1, day=1),
-                             edate=date(year=2017, month=12, day=31),
-                             stateFIPS="01")
+    import pyaqsapi as aqs
+    from datetime import date
+
+    aqs.bystate.monitors(parameter="88101",
+                         bdate=date(year=2017, month=1, day=1),
+                         edate=date(year=2017, month=12, day=31),
+                         stateFIPS="01")
 
     Returns
     -------
@@ -129,8 +129,8 @@ def qa_flowrateaudit(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of flow rate audit
     data for Alabama in January 2018::
 
@@ -214,8 +214,8 @@ def qa_one_point_qc(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of one point QC check
     data for ozone in Massachusetts in January 2018::
 
@@ -295,8 +295,8 @@ def qa_pep_audit(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of PEP audit data for PM2.5 in Alabama 2017::
 
         import pyaqsapi as aqs
@@ -383,8 +383,8 @@ def sampledata(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame with all benzene samples from
     North Carolina collected from May 15th, 1995 - May 15, 1999::
 
@@ -467,8 +467,8 @@ def annualsummary(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame with all benzene samples from
     North Carolina collected from May 15th, 1995 - May 15, 1999::
 
@@ -550,8 +550,8 @@ def qa_blanks(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame which contains PM2.5 blank data
     for Alabama for January 2018::
 
@@ -634,8 +634,8 @@ def dailysummary(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of all benzene daily
     summaries from North Carolina collected on May 15th, 1995::
 
@@ -714,8 +714,8 @@ def qa_collocated_assessments(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of collocated
     assessment data for FRM2.5 for January 2013::
 
@@ -799,8 +799,8 @@ def qa_flowrateverification(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of flow rate verification data for the state of
     Alabama for 2017-2019::
 
@@ -885,8 +885,8 @@ def transactionsample(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing benzene transaction sample data for
     North Carolina on May 15, 1995::
 
@@ -971,8 +971,8 @@ def qa_annualperformanceeval(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing annual performance evaluation
     data for ozone in Alabama for 2017::
 
@@ -1060,8 +1060,8 @@ def qa_annualperformanceevaltransaction(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing annual performance evaluation data
     for ozone in Alabama for 2017 in RD format.::
 
@@ -1122,8 +1122,8 @@ def quarterlysummary(
     stateFIPS a provided for bdate - edate time frame. Variables returned
     include mean value, maxima, percentiles, and etc.
 
-    Note
-    ----
+    Notes
+    -----
     The AQS API only allows for a single year of quarterly summary to be
     retrieved at a time. This function conveniently extracts date
     information from the bdate and edate parameters then makes repeated
@@ -1166,8 +1166,8 @@ def quarterlysummary(
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return an aqs S3 object containing quarterly summaries for
     FRM/FEM PM2.5 data for North Carolina for each quarter of  2016-2017::
 
diff --git a/pyaqsapi/listfunctions.py b/pyaqsapi/listfunctions.py
index 2c3390d..7332051 100644
--- a/pyaqsapi/listfunctions.py
+++ b/pyaqsapi/listfunctions.py
@@ -11,8 +11,8 @@ def aqs_isavailable(return_header=False):
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Check if the AQS API is up, running and accepting requests.::
 
         aqs_isAvailable()
@@ -45,8 +45,8 @@ def aqs_knownissues(return_header=False):
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Retrieve a DataFrame of known issues directly from the AQS data mart API::
 
         aqs_knownissues()
@@ -79,8 +79,8 @@ def aqs_counties_by_state(stateFIPS, return_header=False):
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Returns a DataFrame of all the counties
     in North Carolina the county FIPS codes (county codes) for each.::
 
@@ -118,8 +118,8 @@ def aqs_sites_by_county(stateFIPS, countycode, return_header=False):
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of all the counties
     in North Carolina the county FIPS codes (county codes) for each.::
 
@@ -153,8 +153,8 @@ def aqs_classes(return_header=False):
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of parameter classes (groups of parameters, i.e.
     "criteria" or all")::
 
@@ -192,8 +192,8 @@ def aqs_parameters_by_class(parameterclass, return_header=False):
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of parameter classes (groups of parameters, i.e.
     "criteria" or all")::
 
@@ -222,8 +222,8 @@ def aqs_mas(return_header=False):
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Returns a DataFrame of monitoring agencies and their respective
     monitoring agency codes.::
 
@@ -252,8 +252,8 @@ def aqs_pqaos(return_header=False):
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of primary quality assurance organizations (pqaos)::
 
         aqs_pqaos()
@@ -282,8 +282,8 @@ def aqs_cbsas(return_header=False):
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of Core Based Statistical Areas (cbsas)
     and their respective cbsa codes::
 
@@ -313,8 +313,8 @@ def aqs_states(return_header=False):
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of states and their FIPS codes::
 
         aqs_states()}
@@ -343,8 +343,8 @@ def aqs_revisionhistory(return_header=False):
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of the EPA AQS Data Mart API revision history::
 
         aqs_revisionHistory()
@@ -377,8 +377,8 @@ def aqs_fields_by_service(service, return_header=False):
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame containing a list and definitions
     of fields in the Sample Data service.::
 
@@ -411,8 +411,8 @@ def aqs_sampledurations(return_header=False):
     return_header : If FALSE (default) only returns data requested. If TRUE
                     returns a AQSAPI_v2 object.
 
-    Example
-    -------
+    Examples
+    --------
     Return a DataFrame of::
 
         aqs_sampledurations()