From 36a0528ac53dac4c51fa86231ea8db45675dcc95 Mon Sep 17 00:00:00 2001 From: Clinton Mccrowey Date: Mon, 29 Jan 2024 13:56:02 -0500 Subject: [PATCH] refactor the pyaqsapi documentation --- docs/_/output.txt | 0 docs/_build/doctrees/environment.pickle | Bin 3266587 -> 733040 bytes docs/_build/doctrees/index.doctree | Bin 42037 -> 200722 bytes .../manual/pyaqsapiFunctions-Brief.doctree | Bin 14102 -> 13461 bytes .../manual/pyaqsapiFunctions-Long.doctree | Bin 0 -> 171246 bytes docs/_build/doctrees/pyaqsapi.bybox.doctree | Bin 85463 -> 0 bytes docs/_build/doctrees/pyaqsapi.bycbsa.doctree | Bin 84420 -> 0 bytes .../_build/doctrees/pyaqsapi.bycounty.doctree | Bin 245432 -> 0 bytes docs/_build/doctrees/pyaqsapi.byma.doctree | Bin 134072 -> 0 bytes docs/_build/doctrees/pyaqsapi.bypqao.doctree | Bin 121017 -> 0 bytes docs/_build/doctrees/pyaqsapi.bysite.doctree | Bin 257765 -> 0 bytes docs/_build/doctrees/pyaqsapi.bystate.doctree | Bin 213369 -> 0 bytes docs/_build/doctrees/pyaqsapi.doctree | Bin 1254091 -> 0 bytes docs/_build/html/.buildinfo | 2 +- docs/_build/html/_sources/index.rst.txt | 21 +- .../manual/pyaqsapiFunctions-Brief.rst.txt | 39 +- .../manual/pyaqsapiFunctions-Long.rst.txt | 841 ++++ .../html/_sources/pyaqsapi.bybox.rst.txt | 21 - .../html/_sources/pyaqsapi.bycbsa.rst.txt | 21 - .../html/_sources/pyaqsapi.bycounty.rst.txt | 21 - .../html/_sources/pyaqsapi.byma.rst.txt | 21 - .../html/_sources/pyaqsapi.bypqao.rst.txt | 21 - .../html/_sources/pyaqsapi.bysite.rst.txt | 21 - .../html/_sources/pyaqsapi.bystate.rst.txt | 21 - docs/_build/html/_sources/pyaqsapi.rst.txt | 94 - docs/_build/html/genindex.html | 441 +- docs/_build/html/index.html | 1105 ++++- .../html/manual/pyaqsapiFunctions-Brief.html | 31 +- .../html/manual/pyaqsapiFunctions-Long.html | 1131 +++++ docs/_build/html/objects.inv | Bin 1301 -> 1112 bytes docs/_build/html/py-modindex.html | 209 - docs/_build/html/pyaqsapi.bybox.html | 350 -- docs/_build/html/pyaqsapi.bycbsa.html | 373 -- docs/_build/html/pyaqsapi.bycounty.html | 861 ---- docs/_build/html/pyaqsapi.byma.html | 517 -- docs/_build/html/pyaqsapi.bypqao.html | 485 -- docs/_build/html/pyaqsapi.bysite.html | 881 ---- docs/_build/html/pyaqsapi.bystate.html | 773 --- docs/_build/html/pyaqsapi.html | 4213 ----------------- docs/_build/html/searchindex.js | 2 +- docs/conf.py | 9 +- docs/genindex.rst | 2 + docs/ignored_wordlist.txt | 9 +- docs/index.rst | 21 +- docs/manual/pyaqsapiFunctions-Brief.rst | 39 +- docs/manual/pyaqsapiFunctions-Long.rst | 841 ++++ docs/modules.rst | 4 +- docs/pyaqsapi.rst | 28 +- docs/pycodestlyecheck.txt | 0 49 files changed, 3986 insertions(+), 9483 deletions(-) delete mode 100644 docs/_/output.txt create mode 100644 docs/_build/doctrees/manual/pyaqsapiFunctions-Long.doctree delete mode 100644 docs/_build/doctrees/pyaqsapi.bybox.doctree delete mode 100644 docs/_build/doctrees/pyaqsapi.bycbsa.doctree delete mode 100644 docs/_build/doctrees/pyaqsapi.bycounty.doctree delete mode 100644 docs/_build/doctrees/pyaqsapi.byma.doctree delete mode 100644 docs/_build/doctrees/pyaqsapi.bypqao.doctree delete mode 100644 docs/_build/doctrees/pyaqsapi.bysite.doctree delete mode 100644 docs/_build/doctrees/pyaqsapi.bystate.doctree delete mode 100644 docs/_build/doctrees/pyaqsapi.doctree create mode 100644 docs/_build/html/_sources/manual/pyaqsapiFunctions-Long.rst.txt delete mode 100644 docs/_build/html/_sources/pyaqsapi.bybox.rst.txt delete mode 100644 docs/_build/html/_sources/pyaqsapi.bycbsa.rst.txt delete mode 100644 docs/_build/html/_sources/pyaqsapi.bycounty.rst.txt delete mode 100644 docs/_build/html/_sources/pyaqsapi.byma.rst.txt delete mode 100644 docs/_build/html/_sources/pyaqsapi.bypqao.rst.txt delete mode 100644 docs/_build/html/_sources/pyaqsapi.bysite.rst.txt delete mode 100644 docs/_build/html/_sources/pyaqsapi.bystate.rst.txt delete mode 100644 docs/_build/html/_sources/pyaqsapi.rst.txt create mode 100644 docs/_build/html/manual/pyaqsapiFunctions-Long.html delete mode 100644 docs/_build/html/py-modindex.html delete mode 100644 docs/_build/html/pyaqsapi.bybox.html delete mode 100644 docs/_build/html/pyaqsapi.bycbsa.html delete mode 100644 docs/_build/html/pyaqsapi.bycounty.html delete mode 100644 docs/_build/html/pyaqsapi.byma.html delete mode 100644 docs/_build/html/pyaqsapi.bypqao.html delete mode 100644 docs/_build/html/pyaqsapi.bysite.html delete mode 100644 docs/_build/html/pyaqsapi.bystate.html delete mode 100644 docs/_build/html/pyaqsapi.html create mode 100644 docs/genindex.rst create mode 100644 docs/manual/pyaqsapiFunctions-Long.rst delete mode 100644 docs/pycodestlyecheck.txt diff --git a/docs/_/output.txt b/docs/_/output.txt deleted file mode 100644 index e69de29..0000000 diff --git a/docs/_build/doctrees/environment.pickle b/docs/_build/doctrees/environment.pickle index d66a8ab05c033c4cffa27821a66cf6e52850e445..c3a8a063b35aca794f8ab42401531f2522441604 100644 GIT binary patch literal 733040 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�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�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 literal 3266587 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%0Ds_kZ8>6)u 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 z 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

BGFyW(aeLykcr$9%-=BW|3xya)`WZYLlQ? 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 qgF`m)0#c`S=;2$VTaX4r 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�ki6>O`PtJayXX;XqFj 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 W&IHP|i;%*;QG!PWNmS$2;Qt5PNzy|A diff --git a/docs/_build/html/.buildinfo b/docs/_build/html/.buildinfo index 7c58053..4368c13 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: 3cebc56d58d6ed3f3392a68420c06fa8 +config: 76a68937cbe1e6a63755071eed15d2c3 tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/docs/_build/html/_sources/index.rst.txt b/docs/_build/html/_sources/index.rst.txt index 08a44d9..8745d98 100644 --- a/docs/_build/html/_sources/index.rst.txt +++ b/docs/_build/html/_sources/index.rst.txt @@ -3,12 +3,16 @@ You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. +.. sectionauthor:: Clinton Mccrowey epa.gov> + +=========================== +pyaqsapi user documentation +=========================== -pyaqsapi's documentation -========================= .. toctree:: :maxdepth: 2 :numbered: + :hidden: .. include:: manual/EPA_Disclaimer.rst .. include:: manual/Introduction.rst @@ -19,12 +23,17 @@ pyaqsapi's documentation .. include:: manual/Using_pyaqsapi.rst .. This is temporary until the long version is finished -.. include:: manual/pyaqsapiFunctions-Brief.rst +.. +.. include:: manual/pyaqsapiFunctions-Long.rst + pyaqsapi API reference documentation -==================================== +------------------------------------ + * :ref:`modindex` -Index -===== + +pyaqsapi index +-------------- + * :ref:`genindex` diff --git a/docs/_build/html/_sources/manual/pyaqsapiFunctions-Brief.rst.txt b/docs/_build/html/_sources/manual/pyaqsapiFunctions-Brief.rst.txt index dd38309..0a972a6 100644 --- a/docs/_build/html/_sources/manual/pyaqsapiFunctions-Brief.rst.txt +++ b/docs/_build/html/_sources/manual/pyaqsapiFunctions-Brief.rst.txt @@ -1,4 +1,4 @@ -.. index:: pyaqsapi aggregate functions (brief) +:orphan: Data Mart aggregate functions ============================= @@ -34,25 +34,24 @@ Note that not all aggregations are available for each service. These thirteen services are: - - \ Monitors (\*monitors) - - \ Sample Data (\*sampledata) - - \ Daily Summary Data (\*dailydata) - - \ Annual Summary Data (annualdata) - - \ Quality Assurance - Blanks Data (\*qa_blanks) - - \ Quality Assurance - Collocated Assessments - (\*qa_collocated_assessments) - - \ Quality Assurance - Flow Rate Verifications (\*qa_flowrateverification) - - \ Quality Assurance - Flow Rate Audits (\*aqs_qa_flowrateaudit) - - \ Quality Assurance - One Point Quality Control Raw Data - (\*qa_one_point_qc) - - \ Quality Assurance - PEP Audits (\*qa_pep_audit) - - \ Transaction Sample - AQS Submission data in transaction Format (RD) - (\*transactionsample) - - \ Quality Assurance - Annual Performance Evaluations - (\*qa_annualpeferomanceeval) - - \ Quality Assurance - Annual Performance Evaluations in the AQS - \ Submission transaction format (RD) - \ (\*qa_annualpeferomanceevaltransaction) + * Monitors (monitors) + * Sample Data (sampledata) + * Daily Summary Data (dailydata) + * Annual Summary Data (annualdata) + * Quality Assurance - Blanks Data (qa_blanks) + * Quality Assurance - Collocated Assessments + (qa_collocated_assessments) + * Quality Assurance - Flow Rate Verifications (qa_flowrateverification) + * Quality Assurance - Flow Rate Audits (aqs_qa_flowrateaudit) + * Quality Assurance - One Point Quality Control Raw Data + (qa_one_point_qc) + * Quality Assurance - PEP Audits (qa_pep_audit) + * Transaction Sample - AQS Submission data in transaction Format (RD) + (transactionsample) + * Quality Assurance - Annual Performance Evaluations + (qa_annualperformanceeval) + * Quality Assurance - Annual Performance Evaluations in the AQS + Submission transaction format (RD) (qa_annualperformanceevaltransaction) Aggregate functions are named aqs..() where diff --git a/docs/_build/html/_sources/manual/pyaqsapiFunctions-Long.rst.txt b/docs/_build/html/_sources/manual/pyaqsapiFunctions-Long.rst.txt new file mode 100644 index 0000000..7da7e15 --- /dev/null +++ b/docs/_build/html/_sources/manual/pyaqsapiFunctions-Long.rst.txt @@ -0,0 +1,841 @@ +.. index:: Functions Exported by pyaqsapi + +Functions Exported by pyaqsapi +==================================================== +The pyaqsapi package includes the following submodules which are not +loaded by default: +:: + +* pyaqsapi.bysite +* pyaqsapi.bycounty +* pyaqsapi.bycounty +* pyaqsapi.bycbsa +* pyaqsapi.bybox +* pyaqsapi.byma +* pyaqsapi.ma + +With these submodules loaded to entire list of functions exported by the +pyaqsapi package includes: + +:: + +* pyaqsapi.aqs_cbsas, +* pyaqsapi.aqs_classes, +* pyaqsapi.aqs_counties_by_state, +* pyaqsapi.aqs_credentials, +* pyaqsapi.aqs_credentials, +* pyaqsapi.aqs_fields_by_service, +* pyaqsapi.aqs_fields_by_service, +* pyaqsapi.aqs_isavailable, +* pyaqsapi.aqs_isavailable, +* pyaqsapi.aqs_knownissues, +* pyaqsapi.aqs_knownissues, +* pyaqsapi.aqs_mas, +* pyaqsapi.aqs_parameters_by_class, +* pyaqsapi.aqs_pqaos, +* pyaqsapi.aqs_removeheader, +* pyaqsapi.aqs_revisionhistory, +* pyaqsapi.aqs_revisionhistory, +* pyaqsapi.aqs_sampledurations, +* pyaqsapi.aqs_sign_up, +* pyaqsapi.aqs_sign_up, +* pyaqsapi.aqs_sites_by_county, +* pyaqsapi.aqs_states, +* pyaqsapi.bybox.annualsummary, +* pyaqsapi.bybox.dailysummary, +* pyaqsapi.bybox.helperfunctions, +* pyaqsapi.bybox.monitors, +* pyaqsapi.bybox.quarterlysummary, +* pyaqsapi.bybox.sampledata, +* pyaqsapi.bycbsa.annualsummary, +* pyaqsapi.bycbsa.dailysummary, +* pyaqsapi.bycbsa.helperfunctions, +* pyaqsapi.bycbsa.monitors, +* pyaqsapi.bycbsa.quarterlysummary, +* pyaqsapi.bycbsa.sampledata, +* pyaqsapi.bycounty.annualsummary, +* pyaqsapi.bycounty.dailysummary, +* pyaqsapi.bycounty.helperfunctions, +* pyaqsapi.bycounty.monitors, +* pyaqsapi.bycounty.qa_annualperformanceeval, +* pyaqsapi.bycounty.qa_annualperformanceevaltransaction, +* pyaqsapi.bycounty.qa_blanks, +* pyaqsapi.bycounty.qa_collocated_assessments, +* pyaqsapi.bycounty.qa_flowrateaudit, +* pyaqsapi.bycounty.qa_flowrateverification, +* pyaqsapi.bycounty.qa_one_point_qc, +* pyaqsapi.bycounty.qa_pep_audit, +* pyaqsapi.bycounty.quarterlysummary, +* pyaqsapi.bycounty.sampledata, +* pyaqsapi.bycounty.transactionsample, +* pyaqsapi.byma.qa_annualpeferomanceeval, +* pyaqsapi.byma.qa_annualperformanceevaltransaction, +* pyaqsapi.byma.qa_blanks, +* pyaqsapi.byma.qa_collocated_assessments, +* pyaqsapi.byma.qa_flowrateaudit, +* pyaqsapi.byma.qa_flowrateverification, +* pyaqsapi.byma.qa_one_point_qc, +* pyaqsapi.byma.qa_pep_audit, +* pyaqsapi.byma.transactionsample, +* pyaqsapi.bypqao.qa_annualperformanceeval, +* pyaqsapi.bypqao.qa_annualperformanceevaltransaction, +* pyaqsapi.bypqao.qa_blanks, +* pyaqsapi.bypqao.qa_collocated_assessments, +* pyaqsapi.bypqao.qa_flowrateaudit, +* pyaqsapi.bypqao.qa_flowrateverification, +* pyaqsapi.bypqao.qa_one_point_qc, +* pyaqsapi.bypqao.qa_pep_audit, +* pyaqsapi.bysite.annualsummary, +* pyaqsapi.bysite.dailysummary, +* pyaqsapi.bysite.helperfunctions, +* pyaqsapi.bysite.monitors, +* pyaqsapi.bysite.qa_annualpeferomanceeval, +* pyaqsapi.bysite.qa_annualperformanceevaltransaction, +* pyaqsapi.bysite.qa_blanks, +* pyaqsapi.bysite.qa_collocated_assessments, +* pyaqsapi.bysite.qa_flowrateaudit, +* pyaqsapi.bysite.qa_flowrateverification, +* pyaqsapi.bysite.qa_one_point_qc, +* pyaqsapi.bysite.qa_pep_audit, +* pyaqsapi.bysite.quarterlysummary, +* pyaqsapi.bysite.sampledata, +* pyaqsapi.bysite.transactionsample, +* pyaqsapi.bystate.annualsummary, +* pyaqsapi.bystate.dailysummary, +* pyaqsapi.bystate.helperfunctions, +* pyaqsapi.bystate.monitors, +* pyaqsapi.bystate.qa_annualperformanceeval, +* pyaqsapi.bystate.qa_annualperformanceevaltransaction, +* pyaqsapi.bystate.qa_blanks, +* pyaqsapi.bystate.qa_collocated_assessments, +* pyaqsapi.bystate.qa_flowrateaudit, +* pyaqsapi.bystate.qa_flowrateverification, +* pyaqsapi.bystate.qa_one_point_qc, +* pyaqsapi.bystate.qa_pep_audit, +* pyaqsapi.bystate.quarterlysummary, +* pyaqsapi.bystate.sampledata, +* pyaqsapi.bystate.transactionsample + + +pyaqsapi functions are named according to the service and filter variables that +are available by the AQS Data Mart API. Refer to `Air Quality System (AQS) API +`_ for full details of the +AQS DataMart API. + + +Variable descriptions and usage +=============================== +These are all the available variables that can be used with various functions +exported from the pyaqsapi library listed alphabetically. Not all of these +variables are used with every function, and not all of these parameters are +required. See the :ref: `pyaqsapi functional families` section to +see which parameters are used with each function. + +* AQSobject: + an object of type AQSAPI_V2 that is returned from pyaqsapi + aggregate functions wheen return_header is True. + +* bdate: + a date object which represents the begin date of the data selection. + Only data on or after this date will be returned. + +* 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. + +* 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. + +* countycode: + a character object which represents the 3 digit state FIPS code for the + county being requested (with leading zero(s)). Refer to + :ref: `listfunctions` for a table of available county codes for each state. + +* duration (optional): + a character string that represents the parameter duration code that limits + returned data to a specific sample duration. The default value of None + will result in no filtering based on duration code. Valid durations + include actual sample durations and not calculated durations such as 8 hour + CO or O\ :sub:`3`\ rolling averages, 3/6 day PM averages or Pb 3 month + rolling averages. Refer to :ref: `aqs_sampledurations()` for a table of all + available duration codes. + +* edate: + a date object which represents the end date of the data selection. Only + data on or before this date will be returned. + +* 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 + email will be sent to the account specified. + +* key: + a character object which represents the key used in conjunction with the + username given to connect to AQS Data Mart. + +* MA_code: + a character object which represents the 4 digit AQS Monitoring Agency code + (with leading zeroes). + +* maxlat: + a character object which represents the maximum latitude of a geographic + box. Decimal latitude with north begin positive. Only data south of this + latitude will be returned. + +* maxlon: + a character object which represents the maximum longitude of a + geographic box. Decimal longitude with east being positive. Only + data west of this longitude will be returned. Note that -80 is less + than -70. + +* minlat: + a character object which represents the minimum latitude of a + geographic box. Decimal latitude with north being positive. + Only data north of this latitude will be returned. + +* minlon: + a character object which represents the minimum longitude of a + geographic box. Decimal longitude with east begin positive. Only + data east of this longitude will be returned. + +* parameter: + a character list or single character object which represents the parameter + code of the air pollutant related to the data being requested. + +* return_Header: + If False (default) only returns data requested as a pandas DataFrame. If + True returns a AQSAPI_V2 object. + +* service: + a string which represents the services provided by the AQS API. For a list + of available services refer to + `_` + for the complete listing of services available through the EPA + AQS Datamart API + +* sitenum: + a character object which represents the 4 digit site number (with + leading zeros) within the county and state being requested. + +* stateFIPS: + a character object which represents the 2 digit state FIPS code + (with leading zero) for the state being requested. + +* pqao_code: + a character object which represents the 4 digit AQS Primary Quality + Assurance Organization code (with leading zeroes). + +* username: + a character object which represents the email account that will be used to + connect to the AQS API. + +pyaqsapi functional families +============================ + +Sign up and credentials +----------------------- +The functions included in this family of functions are: + +:: + +* aqs_credentials +* aqs_sign_up + +These functions are used to sign up with Data Mart and to store credential + information to use with pyaqsapi. The aqs_sign_up function takes + one parameter: + +* email: + +The aqs_credentials function takes two parameters: + +* username: +* key: + +Data Mart API metadata functions +-------------------------------- +The functions included in this family of functions are: + +:: + +* aqs_isavailable +* aqs_knownissues +* aqs_fields_by_service +* aqs_revisionhistory + +These functions return Data Mart meta data + +The aqs_isavailable function takes no parameters and returns a + table which details the status of the AQS API. + +The aqs_fields_by_service function takes one parameter, service, + which is a character object which represents the services provided by + the AQS API. For a list of available services see + `Air Quality System (AQS) API - Services Overview + `_ + +The aqs_knownissues function takes no parameters and Returns a + table of any known issues with system functionality or the data. These are + usually issues that have been identified internally and will require some + time to correct in Data Mart or the API. This function implements a direct + API call to Data Mart and returns data directly from the API. Issues + returned via this function do not include any issues from the pyaqsapi + package. + +The aqs_revisionhistory function is used to query Data Mart for the + change history to the API. + +Data Mart API list functions +---------------------------- +The functions included in this family of functions are: +:: + +* aqs_cbsas, +* aqs_classes, +* aqs_counties_by_state, +* aqs_fields_by_service, +* aqs_isavailable, +* aqs_knownissues, +* aqs_mas, +* aqs_parameters_by_class, +* aqs_pqaos, +* aqs_revisionhistory, +* aqs_sampledurations, +* aqs_sites_by_county, +* aqs_states + + +List functions return the API status, API options or groupings that can be used + in conjunction with other API calls. By default each function in this + category returns results as a DataTable. If return_header parameter is set + to True a AQSAPI_v2 object is returned instead. + +aqs_cbsas returns a table of all available Core Based Statistical + Areas (cbsas) and their respective cbsa codes. + +aqs_states takes no arguments and returns a table of the available + states and their respective state FIPS codes. + +aqs_sampledurations takes no arguments and returns a table of the + available sample duration code used to construct other requests. + +aqs_classes takes no arguments and returns a table of parameter + classes (groups of parameters, i.e. "criteria" or "all"). + +aqs_counties_by_state takes one parameter, stateFIPS, which is a two + digit state FIPS code for the state being requested represented as a + character object and returns a table of counties and their + respective FIPS code for the state requested. Use aqs_states to + receive a table of valid state FIPS codes. + +aqs_sites_by_county takes two parameters, stateFIPS, which is a + two digit state FIPS code for the state being requested and county_code + which is a three digit county FIPS code for the county being requested, + both stateFIPS and county_code should be encoded as a character object. + This function returns a table of all air monitoring sites with the + requested state and county FIPS code combination. + +aqs_pqaos takes no parameters and returns an AQSAPI_V2 + object containing a table of primary quality assurance + organizations (pqaos). + +aqs_mas takes no parameters and returns an AQSAPI_V2 + object containing a table of monitoring agencies (MA). + +Data Mart aggregate functions +----------------------------- + +..note:: + AQS Data Mart API restricts the maximum amount of monitoring data to one + full year of data per API call. These functions are able to return multiple + years of data by making repeated calls to the API. Each call to the Data + Mart API will take time to complete. The more years of data being requested + the longer pyaqsapi will take to return the results. + +These functions retrieve aggregated data from the Data Mart API and are + grouped by how each function aggregates the data. There are 5 different + families of related aggregate functions. These families are arranged by how + the Data Mart API groups the returned data, bysite, bycounty, bystate, + by (bybox) and + by (bycbsa). Within each family + of aggregated data functions there are functions that call on the 10 + different services that the Data Mart API provides. All Aggregate + functions return a pandas DataFrame by default. If the return_Header + parameter is set to True an AQSAPI_V2 object is returned instead. + +These fourteen services are: + +1. **Monitors**: Returns operational information about the samplers (monitors) + used to collect the data. Includes identifying information, + operational dates, operating organizations, etc. Functions + using this service contain monitors in the function + name. + +2. **Sample Data**: Returns sample data - the most fine grain data reported to + EPA. Usually hourly, sometimes 5-minute, 12-hour, etc. + This service is available in several geographic selections + based on geography: site, county, state, cbsa (core based + statistical area, a grouping of counties), or + by latitude/longitude bounding box. Functions using this + service contain sampledata in the function name. + All Sample Data functions accept two additional, optional + parameters; cbdate and cedate. + + + 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. + + + 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 optional variable which defaults to None. + + + duration: an optional character string that represents the parameter + duration code that limits returned data to + a specific sample duration. The default value of + None results in no filtering based on + duration code. Valid durations include actual sample + durations and not calculated durations such as 8 hour + CO or $O_3$ rolling averages, 3/6 day PM averages or + Pb 3 month rolling averages. Refer to + [aqs_sampledurations()] for a list of all available + duration codes. + +3. **Daily Summary Data**: Returns data summarized at the daily level. All daily + summaries are calculated on midnight to midnight + basis in local time. Variables returned include + date, mean value, maximum value, etc. Functions + using this service contain Dailysummary in + the function name. All Daily Summary Data functions + accept two additional parameters; cbdate and cedate + + + 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. + + + 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 optional variable which defaults to None. + +4. **Annual Summary Data**: Returns data summarized at the yearly level. + Variables include mean value, maxima, + percentiles, etc. Functions using this service + contain annualdata in the function name. All + Annual Summary Data functions accept two + additional parameters; cbdate and cedate. + + + 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. + + + 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 + optional variable which defaults to None. + +5. **Quarterly Summary Data**: Returns data summarized at the quarterly level. + Variables include mean value, maxima, + percentiles, etc. Functions using this service + contain quarterlydata in the function name. All + Annual Summary Data functions accept two + additional parameters; cbdate and cedate. + + + 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. + + + 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 + optional variable which defaults to None. + +6. **Quality Assurance - Blanks Data**: + Quality assurance data - blanks samples. + Blanks are unexposed sample collection devices + (e.g., filters) that are transported with the + exposed sample devices to assess if contamination + is occurring during the transport or handling of + the samples. Functions using this service contain + qa_blanks in the function name. + +7. **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 this service + contain qa_collocated_assessments in the + function name. + +8. **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 taking + a measurement of the flow rate. Functions using this + service contain qa_flowrateverification in + the function name. + +9. **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 different + method than is used for flow rate verifications. + Functions using this service contain + qa_flowrateaudit in the function name. + +10. **Quality Assurance - One Point Quality Control Raw Data**: + Quality assurance data - one point quality control check + raw data. At least every two weeks, certain gaseous + monitors must be challenged with a known concentration to + determine monitor performance. Functions using this + service contain qa_one_point_qc in the function + name. + +11. **Quality Assurance - pep Audits**: + Quality assurance data - performance evaluation program + (pep) audits. pep audits are independent assessments used + to estimate total measurement system bias with a primary + quality assurance organization. Functions using this + service contain qa_pep_audit in the function + name. + +12. **Transaction Sample - AQS Submission data in transaction format (RD)**: + Transaction sample data - The raw transaction sample data + uploaded to AQS by the agency responsible for data + submissions in RD format. Functions using this + service contain transactionsample in the + function name. Transaction sample data is only available + aggregated by site, county, state or monitoring agency. + +13. **Quality Assurance - Annual Performance Evaluations**: + Quality assurance data - Annual performance evaluations. + A performance evaluation must be conducted on each primary + monitor once per year. The percent differences between + known and measured concentrations at several levels are + used to assess the quality of the monitoring data. + Functions using this service contain + aqs_qa_annualperformanceeval in the function + name. Annual performance in transaction format are + only available aggregated by site, county, state, + monitoring agency, and primary quality assurance + organization. Annual performance evaluations are only + available aggregated by site, county, state, + monitoring agency, and primary quality assurance + organization. + +14. **Quality Assurance - Annual performance Evaluations in transaction** \ + **format (RD)**: + Quality assurance data - The raw transaction annual + performance evaluations data in RD format. Functions using + this service contain + aqs_qa_annualperformanceevaltransaction in the + function name. Annual performance evaluations in transaction + format are only available aggregated by site, county, state, + monitoring agency, and primary quality assurance + organization. + + +Data Mart aggregate functions bysite +-------------------------------------- +The pyaqsapi.bysite module exports the following functions: +:: + +* bysite.annualsummary, +* bysite.dailysummary, +* bysite.helperfunctions, +* bysite.monitors, +* bysite.qa_annualpeferomanceeval, +* bysite.qa_annualperformanceevaltransaction, +* bysite.qa_blanks, +* bysite.qa_collocated_assessments, +* bysite.qa_flowrateaudit, +* bysite.qa_flowrateverification, +* bysite.qa_one_point_qc, +* bysite.qa_pep_audit, +* bysite.quarterlysummary, +* bysite.sampledata, +* bysite.transactionsample + +Functions in this family of functions aggregate data at the site level. All + bysite functions accept the following variables: + +* parameter: +* bdate: +* edate: +* stateFIPS: +* countycode: +* sitenum: +* cbdate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata functions and + quarterlysummary functions). +* cedate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata functions and + quarterlysummary functions). +* return_header (optional): set to False by default. +* duration (optional): (This parameter is only used in conjunction with + sampledata functions). + +Data Mart aggregate functions bycounty +---------------------------------------- +The pyaqsapi.bycounty module exports the following functions: +:: + +* bycounty.annualsummary, +* bycounty.dailysummary, +* bycounty.helperfunctions, +* bycounty.monitors, +* bycounty.qa_annualperformanceeval, +* bycounty.qa_annualperformanceevaltransaction, +* bycounty.qa_blanks, +* bycounty.qa_collocated_assessments, +* bycounty.qa_flowrateaudit, +* bycounty.qa_flowrateverification, +* bycounty.qa_one_point_qc, +* bycounty.qa_pep_audit, +* bycounty.quarterlysummary, +* bycounty.sampledata, +* bycounty.transactionsample + +Functions in this family of functions aggregate data at the county level. + All functions accept the following variables: + +* parameter: +* bdate: +* edate: +* stateFIPS: +* countycode: +* cbdate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* cedate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* return_header (optional): set to False by default. +* duration (optional): (This parameter is only used in conjunction with + sampledata functions). + +Data Mart aggregate functions bystate +--------------------------------------- +The pyaqsapi.bystate module exports the following functions: +:: + +* bystate.annualsummary, +* bystate.dailysummary, +* bystate.helperfunctions, +* bystate.monitors, +* bystate.qa_annualperformanceeval, +* bystate.qa_annualperformanceevaltransaction, +* bystate.qa_blanks, +* bystate.qa_collocated_assessments, +* bystate.qa_flowrateaudit, +* bystate.qa_flowrateverification, +* bystate.qa_one_point_qc, +* bystate.qa_pep_audit, +* bystate.quarterlysummary, +* bystate.sampledata, +* bystate.transactionsample + +Functions in this family of functions aggregate data at the state level. + All functions accept the following variables: + +* parameter: +* bdate: +* edate: +* stateFIPS: +* countycode: +* cbdate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* cedate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* return_header (optional): set to False by default. +* duration (optional): (This parameter is only used in conjunction with + sampledata functions). + +Data Mart aggregate functions by Monitoring agency (MA) +------------------------------------------------------- +The pyaqsapi.byma module exports the following functions: +:: + +* byma.qa_annualpeferomanceeval, +* byma.qa_annualperformanceevaltransaction, +* byma.qa_blanks, +* byma.qa_collocated_assessments, +* byma.qa_flowrateaudit, +* byma.qa_flowrateverification, +* byma.qa_one_point_qc, +* byma.qa_pep_audit, +* byma.transactionsample + +Functions in this family of functions aggregate data at the state level. + All functions accept the following variables: + +* parameter: +* bdate: +* edate: +* stateFIPS: +* cbdate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata functions and + quarterlysummary functions). +* cedate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* return_header (optional): set to False by default. +* duration (optional): (This parameter is only used in conjunction with + sampledata functions). + + +functions in this family of functions aggregate data at the Monitoring Agency + (MA) level. All functions accept the following variables: + +* parameter: +* bdate: +* edate: +* MA_code: +* cbdate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* cedate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* return_header (optional): set to False by default. +* duration (optional): (This parameter is only used in conjunction with + sampledata functions). + +Data Mart aggregate functions by Core Based Statistical Area (cbsa) +------------------------------------------------------------------- +The pyaqsapi.bycbsa module exports the following functions: +:: + +* bycbsa.annualsummary, +* bycbsa.dailysummary, +* bycbsa.helperfunctions, +* bycbsa.monitors, +* bycbsa.quarterlysummary, +* bycbsa.sampledata + +Functions in this family of functions aggregate data at the Core Based + Statistical Area (cbsa, as defined by the US Census Bureau) level. + All functions accept the following variables: + +* parameter: +* bdate: +* edate: +* cbsa_code: +* cbdate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* cedate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* return_header (optional): set to False by default. +* duration (optional): (This parameter is only used in conjunction with + sampledata functions). + + +Data Mart aggregate functions by Primary Quality Assurance Organization (pqao) +------------------------------------------------------------------------------ +The pyaqsapi.bypqao module exports the following functions: +:: + +* bypqao.qa_annualperformanceeval, +* bypqao.qa_annualperformanceevaltransaction, +* bypqao.qa_blanks, +* bypqao.qa_collocated_assessments, +* bypqao.qa_flowrateaudit, +* bypqao.qa_flowrateverification, +* bypqao.qa_one_point_qc, +* bypqao.qa_pep_audit + +Functions in this family of functions aggregate data at the Primary Quality + Assurance Organization (pqao) level. All functions accept the following + variables: + +* parameter: +* bdate: +* edate: +* pqao_code: +* return_header (optional): set to False by default. + +Data Mart aggregate functions by latitude/longitude bounding box (bybox) +-------------------------------------------------------------------------- +The pyaqsapi.bybox module exports the following functions: +:: + +* bybox.annualsummary, +* bybox.dailysummary, +* bybox.helperfunctions, +* bybox.monitors, +* bybox.quarterlysummary, +* bybox.sampledata + +Functions in this family of functions aggregate data by a + latitude/longitude bounding box (bybox) level. All functions accept the + following variables: + +* parameter: +* bdate: +* edate: +* minlat: +* minlon: +* maxlon: +* maxlat: +* cbdate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* cedate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* return_header (optional): set to False by default. +* duration (optional): (This parameter is only used in conjunction with + sampledata functions). + +pyaqsapi Miscellaneous functions +-------------------------------- + +These are miscellaneous functions exported by pyaqsapi. + +aqs_removeheader is the function that the pyaqsapi library +uses internally to coerce an AQSAPI_V2 object into a pandas DataFrame. +This is useful if the user saves the output from another pyaqsapi function +with return_header = True set but later decides that they want just a +simple pandas DataFrame object. This function takes only one variable: + +* AQSobject: + + diff --git a/docs/_build/html/_sources/pyaqsapi.bybox.rst.txt b/docs/_build/html/_sources/pyaqsapi.bybox.rst.txt deleted file mode 100644 index 627280f..0000000 --- a/docs/_build/html/_sources/pyaqsapi.bybox.rst.txt +++ /dev/null @@ -1,21 +0,0 @@ -pyaqsapi.bybox package -====================== - -Submodules ----------- - -pyaqsapi.bybox.bybox module ---------------------------- - -.. automodule:: pyaqsapi.bybox.bybox - :members: - :undoc-members: - :show-inheritance: - -Module contents ---------------- - -.. automodule:: pyaqsapi.bybox - :members: - :undoc-members: - :show-inheritance: diff --git a/docs/_build/html/_sources/pyaqsapi.bycbsa.rst.txt b/docs/_build/html/_sources/pyaqsapi.bycbsa.rst.txt deleted file mode 100644 index 3348546..0000000 --- a/docs/_build/html/_sources/pyaqsapi.bycbsa.rst.txt +++ /dev/null @@ -1,21 +0,0 @@ -pyaqsapi.bycbsa package -======================= - -Submodules ----------- - -pyaqsapi.bycbsa.bycbsa module ------------------------------ - -.. automodule:: pyaqsapi.bycbsa.bycbsa - :members: - :undoc-members: - :show-inheritance: - -Module contents ---------------- - -.. automodule:: pyaqsapi.bycbsa - :members: - :undoc-members: - :show-inheritance: diff --git a/docs/_build/html/_sources/pyaqsapi.bycounty.rst.txt b/docs/_build/html/_sources/pyaqsapi.bycounty.rst.txt deleted file mode 100644 index fbc9312..0000000 --- a/docs/_build/html/_sources/pyaqsapi.bycounty.rst.txt +++ /dev/null @@ -1,21 +0,0 @@ -pyaqsapi.bycounty package -========================= - -Submodules ----------- - -pyaqsapi.bycounty.bycounty module ---------------------------------- - -.. automodule:: pyaqsapi.bycounty.bycounty - :members: - :undoc-members: - :show-inheritance: - -Module contents ---------------- - -.. automodule:: pyaqsapi.bycounty - :members: - :undoc-members: - :show-inheritance: diff --git a/docs/_build/html/_sources/pyaqsapi.byma.rst.txt b/docs/_build/html/_sources/pyaqsapi.byma.rst.txt deleted file mode 100644 index 16bdc23..0000000 --- a/docs/_build/html/_sources/pyaqsapi.byma.rst.txt +++ /dev/null @@ -1,21 +0,0 @@ -pyaqsapi.byma package -===================== - -Submodules ----------- - -pyaqsapi.byma.byma module -------------------------- - -.. automodule:: pyaqsapi.byma.byma - :members: - :undoc-members: - :show-inheritance: - -Module contents ---------------- - -.. automodule:: pyaqsapi.byma - :members: - :undoc-members: - :show-inheritance: diff --git a/docs/_build/html/_sources/pyaqsapi.bypqao.rst.txt b/docs/_build/html/_sources/pyaqsapi.bypqao.rst.txt deleted file mode 100644 index 08432e0..0000000 --- a/docs/_build/html/_sources/pyaqsapi.bypqao.rst.txt +++ /dev/null @@ -1,21 +0,0 @@ -pyaqsapi.bypqao package -======================= - -Submodules ----------- - -pyaqsapi.bypqao.bypqao module ------------------------------ - -.. automodule:: pyaqsapi.bypqao.bypqao - :members: - :undoc-members: - :show-inheritance: - -Module contents ---------------- - -.. automodule:: pyaqsapi.bypqao - :members: - :undoc-members: - :show-inheritance: diff --git a/docs/_build/html/_sources/pyaqsapi.bysite.rst.txt b/docs/_build/html/_sources/pyaqsapi.bysite.rst.txt deleted file mode 100644 index 12df214..0000000 --- a/docs/_build/html/_sources/pyaqsapi.bysite.rst.txt +++ /dev/null @@ -1,21 +0,0 @@ -pyaqsapi.bysite package -======================= - -Submodules ----------- - -pyaqsapi.bysite.bysite module ------------------------------ - -.. automodule:: pyaqsapi.bysite.bysite - :members: - :undoc-members: - :show-inheritance: - -Module contents ---------------- - -.. automodule:: pyaqsapi.bysite - :members: - :undoc-members: - :show-inheritance: diff --git a/docs/_build/html/_sources/pyaqsapi.bystate.rst.txt b/docs/_build/html/_sources/pyaqsapi.bystate.rst.txt deleted file mode 100644 index 2ad7e14..0000000 --- a/docs/_build/html/_sources/pyaqsapi.bystate.rst.txt +++ /dev/null @@ -1,21 +0,0 @@ -pyaqsapi.bystate package -======================== - -Submodules ----------- - -pyaqsapi.bystate.bystate module -------------------------------- - -.. automodule:: pyaqsapi.bystate.bystate - :members: - :undoc-members: - :show-inheritance: - -Module contents ---------------- - -.. automodule:: pyaqsapi.bystate - :members: - :undoc-members: - :show-inheritance: diff --git a/docs/_build/html/_sources/pyaqsapi.rst.txt b/docs/_build/html/_sources/pyaqsapi.rst.txt deleted file mode 100644 index 05090ed..0000000 --- a/docs/_build/html/_sources/pyaqsapi.rst.txt +++ /dev/null @@ -1,94 +0,0 @@ -pyaqsapi package -================ - -Submodules ----------- - -pyaqsapi.bybox.bybox module -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. automodule:: pyaqsapi.bybox.bybox - :members: - :undoc-members: - :show-inheritance: - -pyaqsapi.bycbsa.bycbsa module -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. automodule:: pyaqsapi.bycbsa.bycbsa - :members: - :undoc-members: - :show-inheritance: - -pyaqsapi.bycounty.bycounty module -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. automodule:: pyaqsapi.bycounty.bycounty - :members: - :undoc-members: - :show-inheritance: - -pyaqsapi.byma.byma module -~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. automodule:: pyaqsapi.byma.byma - :members: - :undoc-members: - :show-inheritance: - -pyaqsapi.bypqao.bypqao module -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. automodule:: pyaqsapi.bypqao.bypqao - :members: - :undoc-members: - :show-inheritance: - -pyaqsapi.bysite.bysite module -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. automodule:: pyaqsapi.bysite.bysite - :members: - :undoc-members: - :show-inheritance: - -pyaqsapi.bystate.bystate module -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. automodule:: pyaqsapi.bystate.bystate - :members: - :undoc-members: - :show-inheritance: - -pyaqsapi.helperfunctions module -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. automodule:: pyaqsapi.helperfunctions - :members: - :undoc-members: - :show-inheritance: - -pyaqsapi.listfunctions module -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. automodule:: pyaqsapi.listfunctions - :members: - :undoc-members: - :show-inheritance: - -pyaqsapi.metadatafunctions module -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. automodule:: pyaqsapi.metadatafunctions - :members: - :undoc-members: - :show-inheritance: - -pyaqsapi.setupfunctions module -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. automodule:: pyaqsapi.setupfunctions - :members: - :undoc-members: - :show-inheritance: - diff --git a/docs/_build/html/genindex.html b/docs/_build/html/genindex.html index d9e31fa..0ecaa5a 100644 --- a/docs/_build/html/genindex.html +++ b/docs/_build/html/genindex.html @@ -71,14 +71,10 @@

Index

A - | D | E - | G + | F | I | L - | M - | P - | Q | R | S | T @@ -88,87 +84,11 @@

Index

A

-
-

D

- - -
-

E

    @@ -177,20 +97,10 @@

    E

-

G

+

F

-
@@ -211,321 +121,6 @@

L

-

M

- - - -
- -

P

- - - -
    -
  • - pyaqsapi.bypqao.bypqao - -
  • -
  • - pyaqsapi.bysite - -
  • -
  • - pyaqsapi.bysite.bysite - -
  • -
  • - pyaqsapi.bystate - -
  • -
  • - pyaqsapi.bystate.bystate - -
  • -
  • - pyaqsapi.helperfunctions - -
  • -
  • - pyaqsapi.listfunctions - -
  • -
  • - pyaqsapi.metadatafunctions - -
  • -
  • - pyaqsapi.setupfunctions - -
  • -
- -

Q

- - - -
-

R

    @@ -537,26 +132,10 @@

    R

    S

    @@ -567,16 +146,6 @@

    T

    diff --git a/docs/_build/html/index.html b/docs/_build/html/index.html index 8726e8b..557505f 100644 --- a/docs/_build/html/index.html +++ b/docs/_build/html/index.html @@ -4,7 +4,7 @@ - pyaqsapi's documentation — pyaqsapi documentation + pyaqsapi user documentation — pyaqsapi documentation @@ -44,7 +44,7 @@ @@ -73,7 +91,7 @@
    • - +
    • View page source
    • @@ -83,13 +101,12 @@
      -
      -

      pyaqsapi's documentation

      +
      +

      pyaqsapi user documentation

      -
      -

      EPA Disclaimer

      +

      EPA Disclaimer

      Note

      This software/application was developed by the U.S. Environmental @@ -107,7 +124,7 @@

      pyaqsapi's documentation -

      AQS DataMart Disclaimer

      +

      AQS DataMart Disclaimer

      Warning

      US EPA’s AQS Data Mart API V2 is currently in beta phase of development, @@ -123,7 +140,7 @@

      AQS DataMart Disclaimer

      -

      Introduction

      +

      Introduction

      The pyaqsapi module 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 @@ -145,7 +162,7 @@

      Introduction -

      About the timeliness of AQS Data

      +

      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 @@ -153,7 +170,7 @@

      Introduction -

      About RAQSAPI

      +

      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 @@ -163,7 +180,7 @@

      Introduction -

      Install pyaqsapi

      +

      Install pyaqsapi

      To install pyaqsapi first clone the pyaqsapi repository.

      git clone https://github.com/USEPA/pyaqsapi.git
       
      @@ -182,7 +199,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.

      @@ -191,7 +208,7 @@

      Introduction -

      Using pyaqsapi

      +

      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.

      @@ -203,7 +220,7 @@

      Introduction -

      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 @@ -239,74 +256,1030 @@

      Introduction +

      Functions Exported by pyaqsapi

      +

      The pyaqsapi package includes the following submodules which are not +loaded by default:

      +
      * pyaqsapi.bysite
      +* pyaqsapi.bycounty
      +* pyaqsapi.bycounty
      +* pyaqsapi.bycbsa
      +* pyaqsapi.bybox
      +* pyaqsapi.byma
      +* pyaqsapi.ma
      +
      +
      +

      With these submodules loaded to entire list of functions exported by the +pyaqsapi package includes:

      +
      * pyaqsapi.aqs_cbsas,
      +* pyaqsapi.aqs_classes,
      +* pyaqsapi.aqs_counties_by_state,
      +* pyaqsapi.aqs_credentials,
      +* pyaqsapi.aqs_credentials,
      +* pyaqsapi.aqs_fields_by_service,
      +* pyaqsapi.aqs_fields_by_service,
      +* pyaqsapi.aqs_isavailable,
      +* pyaqsapi.aqs_isavailable,
      +* pyaqsapi.aqs_knownissues,
      +* pyaqsapi.aqs_knownissues,
      +* pyaqsapi.aqs_mas,
      +* pyaqsapi.aqs_parameters_by_class,
      +* pyaqsapi.aqs_pqaos,
      +* pyaqsapi.aqs_removeheader,
      +* pyaqsapi.aqs_revisionhistory,
      +* pyaqsapi.aqs_revisionhistory,
      +* pyaqsapi.aqs_sampledurations,
      +* pyaqsapi.aqs_sign_up,
      +* pyaqsapi.aqs_sign_up,
      +* pyaqsapi.aqs_sites_by_county,
      +* pyaqsapi.aqs_states,
      +* pyaqsapi.bybox.annualsummary,
      +* pyaqsapi.bybox.dailysummary,
      +* pyaqsapi.bybox.helperfunctions,
      +* pyaqsapi.bybox.monitors,
      +* pyaqsapi.bybox.quarterlysummary,
      +* pyaqsapi.bybox.sampledata,
      +* pyaqsapi.bycbsa.annualsummary,
      +* pyaqsapi.bycbsa.dailysummary,
      +* pyaqsapi.bycbsa.helperfunctions,
      +* pyaqsapi.bycbsa.monitors,
      +* pyaqsapi.bycbsa.quarterlysummary,
      +* pyaqsapi.bycbsa.sampledata,
      +* pyaqsapi.bycounty.annualsummary,
      +* pyaqsapi.bycounty.dailysummary,
      +* pyaqsapi.bycounty.helperfunctions,
      +* pyaqsapi.bycounty.monitors,
      +* pyaqsapi.bycounty.qa_annualperformanceeval,
      +* pyaqsapi.bycounty.qa_annualperformanceevaltransaction,
      +* pyaqsapi.bycounty.qa_blanks,
      +* pyaqsapi.bycounty.qa_collocated_assessments,
      +* pyaqsapi.bycounty.qa_flowrateaudit,
      +* pyaqsapi.bycounty.qa_flowrateverification,
      +* pyaqsapi.bycounty.qa_one_point_qc,
      +* pyaqsapi.bycounty.qa_pep_audit,
      +* pyaqsapi.bycounty.quarterlysummary,
      +* pyaqsapi.bycounty.sampledata,
      +* pyaqsapi.bycounty.transactionsample,
      +* pyaqsapi.byma.qa_annualpeferomanceeval,
      +* pyaqsapi.byma.qa_annualperformanceevaltransaction,
      +* pyaqsapi.byma.qa_blanks,
      +* pyaqsapi.byma.qa_collocated_assessments,
      +* pyaqsapi.byma.qa_flowrateaudit,
      +* pyaqsapi.byma.qa_flowrateverification,
      +* pyaqsapi.byma.qa_one_point_qc,
      +* pyaqsapi.byma.qa_pep_audit,
      +* pyaqsapi.byma.transactionsample,
      +* pyaqsapi.bypqao.qa_annualperformanceeval,
      +* pyaqsapi.bypqao.qa_annualperformanceevaltransaction,
      +* pyaqsapi.bypqao.qa_blanks,
      +* pyaqsapi.bypqao.qa_collocated_assessments,
      +* pyaqsapi.bypqao.qa_flowrateaudit,
      +* pyaqsapi.bypqao.qa_flowrateverification,
      +* pyaqsapi.bypqao.qa_one_point_qc,
      +* pyaqsapi.bypqao.qa_pep_audit,
      +* pyaqsapi.bysite.annualsummary,
      +* pyaqsapi.bysite.dailysummary,
      +* pyaqsapi.bysite.helperfunctions,
      +* pyaqsapi.bysite.monitors,
      +* pyaqsapi.bysite.qa_annualpeferomanceeval,
      +* pyaqsapi.bysite.qa_annualperformanceevaltransaction,
      +* pyaqsapi.bysite.qa_blanks,
      +* pyaqsapi.bysite.qa_collocated_assessments,
      +* pyaqsapi.bysite.qa_flowrateaudit,
      +* pyaqsapi.bysite.qa_flowrateverification,
      +* pyaqsapi.bysite.qa_one_point_qc,
      +* pyaqsapi.bysite.qa_pep_audit,
      +* pyaqsapi.bysite.quarterlysummary,
      +* pyaqsapi.bysite.sampledata,
      +* pyaqsapi.bysite.transactionsample,
      +* pyaqsapi.bystate.annualsummary,
      +* pyaqsapi.bystate.dailysummary,
      +* pyaqsapi.bystate.helperfunctions,
      +* pyaqsapi.bystate.monitors,
      +* pyaqsapi.bystate.qa_annualperformanceeval,
      +* pyaqsapi.bystate.qa_annualperformanceevaltransaction,
      +* pyaqsapi.bystate.qa_blanks,
      +* pyaqsapi.bystate.qa_collocated_assessments,
      +* pyaqsapi.bystate.qa_flowrateaudit,
      +* pyaqsapi.bystate.qa_flowrateverification,
      +* pyaqsapi.bystate.qa_one_point_qc,
      +* pyaqsapi.bystate.qa_pep_audit,
      +* pyaqsapi.bystate.quarterlysummary,
      +* pyaqsapi.bystate.sampledata,
      +* pyaqsapi.bystate.transactionsample
      +
      +
      +

      pyaqsapi functions are named according to the service and filter variables that +are available by the AQS Data Mart API. Refer to Air Quality System (AQS) API for full details of the +AQS DataMart API.

      +

      +
      +

      Variable descriptions and usage

      +

      These are all the available variables that can be used with various functions +exported from the pyaqsapi library listed alphabetically. Not all of these +variables are used with every function, and not all of these parameters are +required. See the :ref: pyaqsapi functional families section to +see which parameters are used with each function.

      +
        +
      • +
        AQSobject:

        an object of type AQSAPI_V2 that is returned from pyaqsapi +aggregate functions wheen return_header is True.

        +
        +
        +
      • +
      • +
        bdate:

        a date object which represents the begin date of the data selection. +Only data on or after this date will be returned.

        +
        +
        +
      • +
      • +
        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.

        +
        +
        +
      • +
      • +
        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.

        +
        +
        +
      • +
      • +
        countycode:

        a character object which represents the 3 digit state FIPS code for the +county being requested (with leading zero(s)). Refer to +:ref: listfunctions for a table of available county codes for each state.

        +
        +
        +
      • +
      • +
        duration (optional):

        a character string that represents the parameter duration code that limits +returned data to a specific sample duration. The default value of None +will result in no filtering based on duration code. Valid durations +include actual sample durations and not calculated durations such as 8 hour +CO or O3rolling averages, 3/6 day PM averages or Pb 3 month +rolling averages. Refer to :ref: aqs_sampledurations() for a table of all +available duration codes.

        +
        +
        +
      • +
      • +
        edate:

        a date object which represents the end date of the data selection. Only +data on or before this date will be returned.

        +
        +
        +
      • +
      • +
        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 +email will be sent to the account specified.

        +
        +
        +
      • +
      • +
        key:

        a character object which represents the key used in conjunction with the +username given to connect to AQS Data Mart.

        +
        +
        +
      • +
      • +
        MA_code:

        a character object which represents the 4 digit AQS Monitoring Agency code +(with leading zeroes).

        +
        +
        +
      • +
      • +
        maxlat:

        a character object which represents the maximum latitude of a geographic +box. Decimal latitude with north begin positive. Only data south of this +latitude will be returned.

        +
        +
        +
      • +
      • +
        maxlon:

        a character object which represents the maximum longitude of a +geographic box. Decimal longitude with east being positive. Only +data west of this longitude will be returned. Note that -80 is less +than -70.

        +
        +
        +
      • +
      • +
        minlat:

        a character object which represents the minimum latitude of a +geographic box. Decimal latitude with north being positive. +Only data north of this latitude will be returned.

        +
        +
        +
      • +
      • +
        minlon:

        a character object which represents the minimum longitude of a +geographic box. Decimal longitude with east begin positive. Only +data east of this longitude will be returned.

        +
        +
        +
      • +
      • +
        parameter:

        a character list or single character object which represents the parameter +code of the air pollutant related to the data being requested.

        +
        +
        +
      • +
      • +
        return_Header:

        If False (default) only returns data requested as a pandas DataFrame. If +True returns a AQSAPI_V2 object.

        +
        +
        +
      • +
      • +
        service:

        a string which represents the services provided by the AQS API. For a list +of available services refer to +<https://aqs.epa.gov/aqsweb/documents/data_api.html#services>_ +for the complete listing of services available through the EPA +AQS Datamart API

        +
        +
        +
      • +
      • +
        sitenum:

        a character object which represents the 4 digit site number (with +leading zeros) within the county and state being requested.

        +
        +
        +
      • +
      • +
        stateFIPS:

        a character object which represents the 2 digit state FIPS code +(with leading zero) for the state being requested.

        +
        +
        +
      • +
      • +
        pqao_code:

        a character object which represents the 4 digit AQS Primary Quality +Assurance Organization code (with leading zeroes).

        +
        +
        +
      • +
      • +
        username:

        a character object which represents the email account that will be used to +connect to the AQS API.

        +
        +
        +
      • +
      +
      +
      +

      pyaqsapi functional families

      +
      +

      Sign up and credentials

      +

      The functions included in this family of functions are:

      +
      * aqs_credentials
      +* aqs_sign_up
      +
      +
      +
      +
      These functions are used to sign up with Data Mart and to store credential

      information to use with pyaqsapi. The aqs_sign_up function takes +one parameter:

      +
      +
      +
        +
      • email:

      • +
      +

      The aqs_credentials function takes two parameters:

      +
        +
      • username:

      • +
      • key:

      • +
      +
      +
      +

      Data Mart API metadata functions

      +

      The functions included in this family of functions are:

      +
      * aqs_isavailable
      +* aqs_knownissues
      +* aqs_fields_by_service
      +* aqs_revisionhistory
      +
      +
      +

      These functions return Data Mart meta data

      +
      +
      The aqs_isavailable function takes no parameters and returns a

      table which details the status of the AQS API.

      +
      +
      The aqs_fields_by_service function takes one parameter, service,

      which is a character object which represents the services provided by +the AQS API. For a list of available services see +Air Quality System (AQS) API - Services Overview

      +
      +
      The aqs_knownissues function takes no parameters and Returns a

      table of any known issues with system functionality or the data. These are +usually issues that have been identified internally and will require some +time to correct in Data Mart or the API. This function implements a direct +API call to Data Mart and returns data directly from the API. Issues +returned via this function do not include any issues from the pyaqsapi +package.

      +
      +
      The aqs_revisionhistory function is used to query Data Mart for the

      change history to the API.

      +
      +
      +
      +
      +

      Data Mart API list functions

      +

      The functions included in this family of functions are:

      +
      * aqs_cbsas,
      +* aqs_classes,
      +* aqs_counties_by_state,
      +* aqs_fields_by_service,
      +* aqs_isavailable,
      +* aqs_knownissues,
      +* aqs_mas,
      +* aqs_parameters_by_class,
      +* aqs_pqaos,
      +* aqs_revisionhistory,
      +* aqs_sampledurations,
      +* aqs_sites_by_county,
      +* aqs_states
      +
      +
      +
      +
      List functions return the API status, API options or groupings that can be used

      in conjunction with other API calls. By default each function in this +category returns results as a DataTable. If return_header parameter is set +to True a AQSAPI_v2 object is returned instead.

      +
      +
      aqs_cbsas returns a table of all available Core Based Statistical

      Areas (cbsas) and their respective cbsa codes.

      +
      +
      aqs_states takes no arguments and returns a table of the available

      states and their respective state FIPS codes.

      +
      +
      aqs_sampledurations takes no arguments and returns a table of the

      available sample duration code used to construct other requests.

      +
      +
      aqs_classes takes no arguments and returns a table of parameter

      classes (groups of parameters, i.e. "criteria" or "all").

      +
      +
      aqs_counties_by_state takes one parameter, stateFIPS, which is a two

      digit state FIPS code for the state being requested represented as a +character object and returns a table of counties and their +respective FIPS code for the state requested. Use aqs_states to +receive a table of valid state FIPS codes.

      +
      +
      aqs_sites_by_county takes two parameters, stateFIPS, which is a

      two digit state FIPS code for the state being requested and county_code +which is a three digit county FIPS code for the county being requested, +both stateFIPS and county_code should be encoded as a character object. +This function returns a table of all air monitoring sites with the +requested state and county FIPS code combination.

      +
      +
      aqs_pqaos takes no parameters and returns an AQSAPI_V2

      object containing a table of primary quality assurance +organizations (pqaos).

      +
      +
      aqs_mas takes no parameters and returns an AQSAPI_V2

      object containing a table of monitoring agencies (MA).

      +
      +
      +
      -

      Data Mart aggregate functions

      -
      -

      Note

      -

      AQS Data Mart API restricts the maximum amount of monitoring data to one +

      Data Mart aggregate functions

      +
      +
      ..note::

      AQS Data Mart API restricts the maximum amount of monitoring data to one full year of data per API call. These functions are able to return multiple years of data by making repeated calls to the API. Each call to the Data Mart API will take time to complete. The more years of data being requested the longer pyaqsapi will take to return the results.

      -
      -

      These functions retrieve aggregated data from the Data Mart API and are grouped -by how each function aggregates the data. There are 7 different families of -related aggregate functions in which the AQS Data Mart API groups data.

      -

      These seven families are:

      -
      -
        -
      • by site (aqs.bysite)

      • -
      • by county (aqs.bycounty)

      • -
      • by state (aqs.bystate)

      • -
      • by latitude/longitude bounding box (aqs.bybox)

      • -
      • by monitoring agency (aqs.byma)

      • -
      • by Primary Quality Assurance Organization (aqs.bypqao)

      • -
      • by core based statistical area (as defined by the US census Bureau) -(aqs.bycbsa).

      • + +
        These functions retrieve aggregated data from the Data Mart API and are

        grouped by how each function aggregates the data. There are 5 different +families of related aggregate functions. These families are arranged by how +the Data Mart API groups the returned data, bysite, bycounty, bystate, +by<latitude/longitude bounding box> (bybox) and +by<core based statistical area> (bycbsa). Within each family +of aggregated data functions there are functions that call on the 10 +different services that the Data Mart API provides. All Aggregate +functions return a pandas DataFrame by default. If the return_Header +parameter is set to True an AQSAPI_V2 object is returned instead.

        +
        + +

        These fourteen services are:

        +
          +
        1. +
          Monitors: Returns operational information about the samplers (monitors)

          used to collect the data. Includes identifying information, +operational dates, operating organizations, etc. Functions +using this service contain monitors in the function +name.

          +
          +
          +
        2. +
        3. +
          Sample Data: Returns sample data - the most fine grain data reported to
          +

          EPA. Usually hourly, sometimes 5-minute, 12-hour, etc. +This service is available in several geographic selections +based on geography: site, county, state, cbsa (core based +statistical area, a grouping of counties), or +by latitude/longitude bounding box. Functions using this +service contain sampledata in the function name. +All Sample Data functions accept two additional, optional +parameters; cbdate and cedate.

          +
          +
            +
          • +
            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.

            +
            +
            +
          • +
          • +
            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 optional variable which defaults to None.

            +
            +
            +
          • +
          • +
            duration: an optional character string that represents the parameter

            duration code that limits returned data to +a specific sample duration. The default value of +None results in no filtering based on +duration code. Valid durations include actual sample +durations and not calculated durations such as 8 hour +CO or $O_3$ rolling averages, 3/6 day PM averages or +Pb 3 month rolling averages. Refer to +[aqs_sampledurations()] for a list of all available +duration codes.

            +
            +
            +
          +
          +
          +
        4. +
        5. +
          Daily Summary Data: Returns data summarized at the daily level. All daily
          +

          summaries are calculated on midnight to midnight +basis in local time. Variables returned include +date, mean value, maximum value, etc. Functions +using this service contain Dailysummary in +the function name. All Daily Summary Data functions +accept two additional parameters; cbdate and cedate

          -

          Within these families of aggregated data functions there are functions that -call on the 13 different aggregate services that the Data Mart API provides. -Note that not all aggregations are available for each service.

          -

          These thirteen services are:

          -
          -
            -
          • Monitors (*monitors)

          • -
          • Sample Data (*sampledata)

          • -
          • Daily Summary Data (*dailydata)

          • -
          • Annual Summary Data (annualdata)

          • -
          • Quality Assurance - Blanks Data (*qa_blanks)

          • -
          • Quality Assurance - Collocated Assessments -(*qa_collocated_assessments)

          • -
          • Quality Assurance - Flow Rate Verifications (*qa_flowrateverification)

          • -
          • Quality Assurance - Flow Rate Audits (*aqs_qa_flowrateaudit)

          • -
          • Quality Assurance - One Point Quality Control Raw Data -(*qa_one_point_qc)

          • -
          • Quality Assurance - PEP Audits (*qa_pep_audit)

          • -
          • Transaction Sample - AQS Submission data in transaction Format (RD) -(*transactionsample)

          • -
          • Quality Assurance - Annual Performance Evaluations -(*qa_annualpeferomanceeval)

          • -
          • Quality Assurance - Annual Performance Evaluations in the AQS -Submission transaction format (RD) -(*qa_annualpeferomanceevaltransaction)

          • +
              +
            • +
              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.

              +
              +
              +
            • +
            • +
              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 optional variable which defaults to None.

              +
              +
              +
            +
          +
          +
        6. +
        7. +
          Annual Summary Data: Returns data summarized at the yearly level.
          +

          Variables include mean value, maxima, +percentiles, etc. Functions using this service +contain annualdata in the function name. All +Annual Summary Data functions accept two +additional parameters; cbdate and cedate.

          -

          Aggregate functions are named aqs.<aggregation>.<service>() where <service> -is one of the 13 services listed above and <aggregation> is either -"bysite“, ”bycounty“, ”bystate“, ”bybox“, ”bycbsa", "byma" or "bypqao".

          +
            +
          • +
            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.

            +
            +
            +
          • +
          • +
            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 +optional variable which defaults to None.

            +
            +
            +
          • +
          +
          +
          +
        8. +
        9. +
          Quarterly Summary Data: Returns data summarized at the quarterly level.
          +

          Variables include mean value, maxima, +percentiles, etc. Functions using this service +contain quarterlydata in the function name. All +Annual Summary Data functions accept two +additional parameters; cbdate and cedate.

          +
          +
            +
          • +
            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.

            +
            +
            +
          • +
          • +
            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 +optional variable which defaults to None.

            +
            +
            +
          • +
          +
          +
          +
        10. +
        11. +
          Quality Assurance - Blanks Data:
          +
          Quality assurance data - blanks samples.

          Blanks are unexposed sample collection devices +(e.g., filters) that are transported with the +exposed sample devices to assess if contamination +is occurring during the transport or handling of +the samples. Functions using this service contain +qa_blanks in the function name.

          +
          +
          +
          +
          +
        12. +
        13. +
          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 this service +contain qa_collocated_assessments in the +function name.

          +
          +
          +
          +
          +
        14. +
        15. +
          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 taking +a measurement of the flow rate. Functions using this +service contain qa_flowrateverification in +the function name.

          +
          +
          +
          +
          +
        16. +
        17. +
          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 different +method than is used for flow rate verifications. +Functions using this service contain +qa_flowrateaudit in the function name.

          +
          +
          +
          +
          +
        18. +
        19. +
          Quality Assurance - One Point Quality Control Raw Data:

          Quality assurance data - one point quality control check +raw data. At least every two weeks, certain gaseous +monitors must be challenged with a known concentration to +determine monitor performance. Functions using this +service contain qa_one_point_qc in the function +name.

          +
          +
          +
        20. +
        21. +
          Quality Assurance - pep Audits:

          Quality assurance data - performance evaluation program +(pep) audits. pep audits are independent assessments used +to estimate total measurement system bias with a primary +quality assurance organization. Functions using this +service contain qa_pep_audit in the function +name.

          +
          +
          +
        22. +
        23. +
          Transaction Sample - AQS Submission data in transaction format (RD):

          Transaction sample data - The raw transaction sample data +uploaded to AQS by the agency responsible for data +submissions in RD format. Functions using this +service contain transactionsample in the +function name. Transaction sample data is only available +aggregated by site, county, state or monitoring agency.

          +
          +
          +
        24. +
        25. +
          Quality Assurance - Annual Performance Evaluations:

          Quality assurance data - Annual performance evaluations. +A performance evaluation must be conducted on each primary +monitor once per year. The percent differences between +known and measured concentrations at several levels are +used to assess the quality of the monitoring data. +Functions using this service contain +aqs_qa_annualperformanceeval in the function +name. Annual performance in transaction format are +only available aggregated by site, county, state, +monitoring agency, and primary quality assurance +organization. Annual performance evaluations are only +available aggregated by site, county, state, +monitoring agency, and primary quality assurance +organization.

          +
          +
          +
        26. +
        27. +
          Quality Assurance - Annual performance Evaluations in transaction
          +
          format (RD):

          Quality assurance data - The raw transaction annual +performance evaluations data in RD format. Functions using +this service contain +aqs_qa_annualperformanceevaltransaction in the +function name. Annual performance evaluations in transaction +format are only available aggregated by site, county, state, +monitoring agency, and primary quality assurance +organization.

          +
          +
          +
          +
          +
        28. +
        +
      +
      +

      Data Mart aggregate functions bysite

      +

      The pyaqsapi.bysite module exports the following functions:

      +
      * bysite.annualsummary,
      +* bysite.dailysummary,
      +* bysite.helperfunctions,
      +* bysite.monitors,
      +* bysite.qa_annualpeferomanceeval,
      +* bysite.qa_annualperformanceevaltransaction,
      +* bysite.qa_blanks,
      +* bysite.qa_collocated_assessments,
      +* bysite.qa_flowrateaudit,
      +* bysite.qa_flowrateverification,
      +* bysite.qa_one_point_qc,
      +* bysite.qa_pep_audit,
      +* bysite.quarterlysummary,
      +* bysite.sampledata,
      +* bysite.transactionsample
      +
      +
      +
      +
      Functions in this family of functions aggregate data at the site level. All

      bysite functions accept the following variables:

      +
      +
      +
        +
      • parameter:

      • +
      • bdate:

      • +
      • edate:

      • +
      • stateFIPS:

      • +
      • countycode:

      • +
      • sitenum:

      • +
      • +
        cbdate (optional): (This parameter is only used in conjunction with

        sampledata, dailysummary, +annualdata functions and +quarterlysummary functions).

        +
        +
        +
      • +
      • +
        cedate (optional): (This parameter is only used in conjunction with

        sampledata, dailysummary, +annualdata functions and +quarterlysummary functions).

        +
        +
        +
      • +
      • return_header (optional): set to False by default.

      • +
      • +
        duration (optional): (This parameter is only used in conjunction with

        sampledata functions).

        +
        +
        +
      • +
      +
      +
      +

      Data Mart aggregate functions bycounty

      +

      The pyaqsapi.bycounty module exports the following functions:

      +
      * bycounty.annualsummary,
      +* bycounty.dailysummary,
      +* bycounty.helperfunctions,
      +* bycounty.monitors,
      +* bycounty.qa_annualperformanceeval,
      +* bycounty.qa_annualperformanceevaltransaction,
      +* bycounty.qa_blanks,
      +* bycounty.qa_collocated_assessments,
      +* bycounty.qa_flowrateaudit,
      +* bycounty.qa_flowrateverification,
      +* bycounty.qa_one_point_qc,
      +* bycounty.qa_pep_audit,
      +* bycounty.quarterlysummary,
      +* bycounty.sampledata,
      +* bycounty.transactionsample
      +
      +
      +
      +
      Functions in this family of functions aggregate data at the county level.

      All functions accept the following variables:

      +
      +
      +
        +
      • parameter:

      • +
      • bdate:

      • +
      • edate:

      • +
      • stateFIPS:

      • +
      • countycode:

      • +
      • +
        cbdate (optional): (This parameter is only used in conjunction with

        sampledata, dailysummary, +annualdata and +quarterlysummary functions).

        +
        +
        +
      • +
      • +
        cedate (optional): (This parameter is only used in conjunction with

        sampledata, dailysummary, +annualdata and +quarterlysummary functions).

        +
        +
        +
      • +
      • return_header (optional): set to False by default.

      • +
      • +
        duration (optional): (This parameter is only used in conjunction with

        sampledata functions).

        +
        +
        +
      • +
      +
      +
      +

      Data Mart aggregate functions bystate

      +

      The pyaqsapi.bystate module exports the following functions:

      +
      * bystate.annualsummary,
      +* bystate.dailysummary,
      +* bystate.helperfunctions,
      +* bystate.monitors,
      +* bystate.qa_annualperformanceeval,
      +* bystate.qa_annualperformanceevaltransaction,
      +* bystate.qa_blanks,
      +* bystate.qa_collocated_assessments,
      +* bystate.qa_flowrateaudit,
      +* bystate.qa_flowrateverification,
      +* bystate.qa_one_point_qc,
      +* bystate.qa_pep_audit,
      +* bystate.quarterlysummary,
      +* bystate.sampledata,
      +* bystate.transactionsample
      +
      +
      +
      +
      Functions in this family of functions aggregate data at the state level.

      All functions accept the following variables:

      +
      +
      +
        +
      • parameter:

      • +
      • bdate:

      • +
      • edate:

      • +
      • stateFIPS:

      • +
      • countycode:

      • +
      • +
        cbdate (optional): (This parameter is only used in conjunction with

        sampledata, dailysummary, +annualdata and +quarterlysummary functions).

        +
        +
        +
      • +
      • +
        cedate (optional): (This parameter is only used in conjunction with

        sampledata, dailysummary, +annualdata and +quarterlysummary functions).

        +
        +
        +
      • +
      • return_header (optional): set to False by default.

      • +
      • +
        duration (optional): (This parameter is only used in conjunction with

        sampledata functions).

        +
        +
        +
      • +
      +
      +
      +

      Data Mart aggregate functions by Monitoring agency (MA)

      +

      The pyaqsapi.byma module exports the following functions:

      +
      * byma.qa_annualpeferomanceeval,
      +* byma.qa_annualperformanceevaltransaction,
      +* byma.qa_blanks,
      +* byma.qa_collocated_assessments,
      +* byma.qa_flowrateaudit,
      +* byma.qa_flowrateverification,
      +* byma.qa_one_point_qc,
      +* byma.qa_pep_audit,
      +* byma.transactionsample
      +
      +
      +
      +
      Functions in this family of functions aggregate data at the state level.

      All functions accept the following variables:

      +
      +
      +
        +
      • parameter:

      • +
      • bdate:

      • +
      • edate:

      • +
      • stateFIPS:

      • +
      • +
        cbdate (optional): (This parameter is only used in conjunction with

        sampledata, dailysummary, +annualdata functions and +quarterlysummary functions).

        +
        +
        +
      • +
      • +
        cedate (optional): (This parameter is only used in conjunction with

        sampledata, dailysummary, +annualdata and +quarterlysummary functions).

        +
        +
        +
      • +
      • return_header (optional): set to False by default.

      • +
      • +
        duration (optional): (This parameter is only used in conjunction with

        sampledata functions).

        +
        +
        +
      • +
      +
      +
      functions in this family of functions aggregate data at the Monitoring Agency

      (MA) level. All functions accept the following variables:

      +
      +
      +
        +
      • parameter:

      • +
      • bdate:

      • +
      • edate:

      • +
      • MA_code:

      • +
      • +
        cbdate (optional): (This parameter is only used in conjunction with

        sampledata, dailysummary, +annualdata and +quarterlysummary functions).

        +
        +
        +
      • +
      • +
        cedate (optional): (This parameter is only used in conjunction with

        sampledata, dailysummary, +annualdata and +quarterlysummary functions).

        +
        +
        +
      • +
      • return_header (optional): set to False by default.

      • +
      • +
        duration (optional): (This parameter is only used in conjunction with

        sampledata functions).

        +
        +
        +
      • +
      +
      +
      +

      Data Mart aggregate functions by Core Based Statistical Area (cbsa)

      +

      The pyaqsapi.bycbsa module exports the following functions:

      +
      * bycbsa.annualsummary,
      +* bycbsa.dailysummary,
      +* bycbsa.helperfunctions,
      +* bycbsa.monitors,
      +* bycbsa.quarterlysummary,
      +* bycbsa.sampledata
      +
      +
      +
      +
      Functions in this family of functions aggregate data at the Core Based

      Statistical Area (cbsa, as defined by the US Census Bureau) level. +All functions accept the following variables:

      +
      +
      +
        +
      • parameter:

      • +
      • bdate:

      • +
      • edate:

      • +
      • cbsa_code:

      • +
      • +
        cbdate (optional): (This parameter is only used in conjunction with

        sampledata, dailysummary, +annualdata and +quarterlysummary functions).

        +
        +
        +
      • +
      • +
        cedate (optional): (This parameter is only used in conjunction with

        sampledata, dailysummary, +annualdata and +quarterlysummary functions).

        +
        +
        +
      • +
      • return_header (optional): set to False by default.

      • +
      • +
        duration (optional): (This parameter is only used in conjunction with

        sampledata functions).

        +
        +
        +
      • +
      +
      +
      +

      Data Mart aggregate functions by Primary Quality Assurance Organization (pqao)

      +

      The pyaqsapi.bypqao module exports the following functions:

      +
      * bypqao.qa_annualperformanceeval,
      +* bypqao.qa_annualperformanceevaltransaction,
      +* bypqao.qa_blanks,
      +* bypqao.qa_collocated_assessments,
      +* bypqao.qa_flowrateaudit,
      +* bypqao.qa_flowrateverification,
      +* bypqao.qa_one_point_qc,
      +* bypqao.qa_pep_audit
      +
      +
      +
      +
      Functions in this family of functions aggregate data at the Primary Quality

      Assurance Organization (pqao) level. All functions accept the following +variables:

      +
      +
      +
        +
      • parameter:

      • +
      • bdate:

      • +
      • edate:

      • +
      • pqao_code:

      • +
      • return_header (optional): set to False by default.

      • +
      +
      +
      +

      Data Mart aggregate functions by latitude/longitude bounding box (bybox)

      +

      The pyaqsapi.bybox module exports the following functions:

      +
      * bybox.annualsummary,
      +* bybox.dailysummary,
      +* bybox.helperfunctions,
      +* bybox.monitors,
      +* bybox.quarterlysummary,
      +* bybox.sampledata
      +
      +
      +
      +
      Functions in this family of functions aggregate data by a

      latitude/longitude bounding box (bybox) level. All functions accept the +following variables:

      +
      +
      +
        +
      • parameter:

      • +
      • bdate:

      • +
      • edate:

      • +
      • minlat:

      • +
      • minlon:

      • +
      • maxlon:

      • +
      • maxlat:

      • +
      • +
        cbdate (optional): (This parameter is only used in conjunction with

        sampledata, dailysummary, +annualdata and +quarterlysummary functions).

        +
        +
        +
      • +
      • +
        cedate (optional): (This parameter is only used in conjunction with

        sampledata, dailysummary, +annualdata and +quarterlysummary functions).

        +
        +
        +
      • +
      • return_header (optional): set to False by default.

      • +
      • +
        duration (optional): (This parameter is only used in conjunction with

        sampledata functions).

        +
        +
        +
      • +
      +
      +
      +

      pyaqsapi Miscellaneous functions

      +

      These are miscellaneous functions exported by pyaqsapi.

      +

      aqs_removeheader is the function that the pyaqsapi library +uses internally to coerce an AQSAPI_V2 object into a pandas DataFrame. +This is useful if the user saves the output from another pyaqsapi function +with return_header = True set but later decides that they want just a +simple pandas DataFrame object. This function takes only one variable:

      +
        +
      • AQSobject:

      • +
      -

      pyaqsapi API reference documentation

      +

      pyaqsapi API reference documentation

      -
      -

      Index

      +
      +

      pyaqsapi index

      +
      +
      diff --git a/docs/_build/html/manual/pyaqsapiFunctions-Brief.html b/docs/_build/html/manual/pyaqsapiFunctions-Brief.html index 9485ea0..ff192e2 100644 --- a/docs/_build/html/manual/pyaqsapiFunctions-Brief.html +++ b/docs/_build/html/manual/pyaqsapiFunctions-Brief.html @@ -72,7 +72,7 @@
      -

      Data Mart aggregate functions

      +

      Data Mart aggregate functions

      Note

      AQS Data Mart API restricts the maximum amount of monitoring data to one @@ -84,7 +84,7 @@

      These functions retrieve aggregated data from the Data Mart API and are grouped by how each function aggregates the data. There are 7 different families of related aggregate functions in which the AQS Data Mart API groups data.

      -

      These seven families are:

      +

      These seven families are:

      • by site (aqs.bysite)

      • @@ -100,28 +100,27 @@

        Within these families of aggregated data functions there are functions that call on the 13 different aggregate services that the Data Mart API provides. Note that not all aggregations are available for each service.

        -

        These thirteen services are:

        +

        These thirteen services are:

          -
        • Monitors (*monitors)

        • -
        • Sample Data (*sampledata)

        • -
        • Daily Summary Data (*dailydata)

        • +
        • Monitors (monitors)

        • +
        • Sample Data (sampledata)

        • +
        • Daily Summary Data (dailydata)

        • Annual Summary Data (annualdata)

        • -
        • Quality Assurance - Blanks Data (*qa_blanks)

        • +
        • Quality Assurance - Blanks Data (qa_blanks)

        • Quality Assurance - Collocated Assessments -(*qa_collocated_assessments)

        • -
        • Quality Assurance - Flow Rate Verifications (*qa_flowrateverification)

        • -
        • Quality Assurance - Flow Rate Audits (*aqs_qa_flowrateaudit)

        • +(qa_collocated_assessments)

          +
        • Quality Assurance - Flow Rate Verifications (qa_flowrateverification)

        • +
        • Quality Assurance - Flow Rate Audits (aqs_qa_flowrateaudit)

        • Quality Assurance - One Point Quality Control Raw Data -(*qa_one_point_qc)

        • -
        • Quality Assurance - PEP Audits (*qa_pep_audit)

        • +(qa_one_point_qc)

          +
        • Quality Assurance - PEP Audits (qa_pep_audit)

        • Transaction Sample - AQS Submission data in transaction Format (RD) -(*transactionsample)

        • +(transactionsample)

        • Quality Assurance - Annual Performance Evaluations -(*qa_annualpeferomanceeval)

        • +(qa_annualperformanceeval)

        • Quality Assurance - Annual Performance Evaluations in the AQS -Submission transaction format (RD) -(*qa_annualpeferomanceevaltransaction)

        • +Submission transaction format (RD) (qa_annualperformanceevaltransaction)

        Aggregate functions are named aqs.<aggregation>.<service>() where <service> diff --git a/docs/_build/html/manual/pyaqsapiFunctions-Long.html b/docs/_build/html/manual/pyaqsapiFunctions-Long.html new file mode 100644 index 0000000..c46d142 --- /dev/null +++ b/docs/_build/html/manual/pyaqsapiFunctions-Long.html @@ -0,0 +1,1131 @@ + + + + + + + Functions Exported by pyaqsapi — pyaqsapi documentation + + + + + + + + + + + + + + + + + +

        + + +
        + +
        +
        +
        + +
        +
        +
        +
        + +
        +

        Functions Exported by pyaqsapi

        +

        The pyaqsapi package includes the following submodules which are not +loaded by default:

        +
        * pyaqsapi.bysite
        +* pyaqsapi.bycounty
        +* pyaqsapi.bycounty
        +* pyaqsapi.bycbsa
        +* pyaqsapi.bybox
        +* pyaqsapi.byma
        +* pyaqsapi.ma
        +
        +
        +

        With these submodules loaded to entire list of functions exported by the +pyaqsapi package includes:

        +
        * pyaqsapi.aqs_cbsas,
        +* pyaqsapi.aqs_classes,
        +* pyaqsapi.aqs_counties_by_state,
        +* pyaqsapi.aqs_credentials,
        +* pyaqsapi.aqs_credentials,
        +* pyaqsapi.aqs_fields_by_service,
        +* pyaqsapi.aqs_fields_by_service,
        +* pyaqsapi.aqs_isavailable,
        +* pyaqsapi.aqs_isavailable,
        +* pyaqsapi.aqs_knownissues,
        +* pyaqsapi.aqs_knownissues,
        +* pyaqsapi.aqs_mas,
        +* pyaqsapi.aqs_parameters_by_class,
        +* pyaqsapi.aqs_pqaos,
        +* pyaqsapi.aqs_removeheader,
        +* pyaqsapi.aqs_revisionhistory,
        +* pyaqsapi.aqs_revisionhistory,
        +* pyaqsapi.aqs_sampledurations,
        +* pyaqsapi.aqs_sign_up,
        +* pyaqsapi.aqs_sign_up,
        +* pyaqsapi.aqs_sites_by_county,
        +* pyaqsapi.aqs_states,
        +* pyaqsapi.bybox.annualsummary,
        +* pyaqsapi.bybox.dailysummary,
        +* pyaqsapi.bybox.helperfunctions,
        +* pyaqsapi.bybox.monitors,
        +* pyaqsapi.bybox.quarterlysummary,
        +* pyaqsapi.bybox.sampledata,
        +* pyaqsapi.bycbsa.annualsummary,
        +* pyaqsapi.bycbsa.dailysummary,
        +* pyaqsapi.bycbsa.helperfunctions,
        +* pyaqsapi.bycbsa.monitors,
        +* pyaqsapi.bycbsa.quarterlysummary,
        +* pyaqsapi.bycbsa.sampledata,
        +* pyaqsapi.bycounty.annualsummary,
        +* pyaqsapi.bycounty.dailysummary,
        +* pyaqsapi.bycounty.helperfunctions,
        +* pyaqsapi.bycounty.monitors,
        +* pyaqsapi.bycounty.qa_annualperformanceeval,
        +* pyaqsapi.bycounty.qa_annualperformanceevaltransaction,
        +* pyaqsapi.bycounty.qa_blanks,
        +* pyaqsapi.bycounty.qa_collocated_assessments,
        +* pyaqsapi.bycounty.qa_flowrateaudit,
        +* pyaqsapi.bycounty.qa_flowrateverification,
        +* pyaqsapi.bycounty.qa_one_point_qc,
        +* pyaqsapi.bycounty.qa_pep_audit,
        +* pyaqsapi.bycounty.quarterlysummary,
        +* pyaqsapi.bycounty.sampledata,
        +* pyaqsapi.bycounty.transactionsample,
        +* pyaqsapi.byma.qa_annualpeferomanceeval,
        +* pyaqsapi.byma.qa_annualperformanceevaltransaction,
        +* pyaqsapi.byma.qa_blanks,
        +* pyaqsapi.byma.qa_collocated_assessments,
        +* pyaqsapi.byma.qa_flowrateaudit,
        +* pyaqsapi.byma.qa_flowrateverification,
        +* pyaqsapi.byma.qa_one_point_qc,
        +* pyaqsapi.byma.qa_pep_audit,
        +* pyaqsapi.byma.transactionsample,
        +* pyaqsapi.bypqao.qa_annualperformanceeval,
        +* pyaqsapi.bypqao.qa_annualperformanceevaltransaction,
        +* pyaqsapi.bypqao.qa_blanks,
        +* pyaqsapi.bypqao.qa_collocated_assessments,
        +* pyaqsapi.bypqao.qa_flowrateaudit,
        +* pyaqsapi.bypqao.qa_flowrateverification,
        +* pyaqsapi.bypqao.qa_one_point_qc,
        +* pyaqsapi.bypqao.qa_pep_audit,
        +* pyaqsapi.bysite.annualsummary,
        +* pyaqsapi.bysite.dailysummary,
        +* pyaqsapi.bysite.helperfunctions,
        +* pyaqsapi.bysite.monitors,
        +* pyaqsapi.bysite.qa_annualpeferomanceeval,
        +* pyaqsapi.bysite.qa_annualperformanceevaltransaction,
        +* pyaqsapi.bysite.qa_blanks,
        +* pyaqsapi.bysite.qa_collocated_assessments,
        +* pyaqsapi.bysite.qa_flowrateaudit,
        +* pyaqsapi.bysite.qa_flowrateverification,
        +* pyaqsapi.bysite.qa_one_point_qc,
        +* pyaqsapi.bysite.qa_pep_audit,
        +* pyaqsapi.bysite.quarterlysummary,
        +* pyaqsapi.bysite.sampledata,
        +* pyaqsapi.bysite.transactionsample,
        +* pyaqsapi.bystate.annualsummary,
        +* pyaqsapi.bystate.dailysummary,
        +* pyaqsapi.bystate.helperfunctions,
        +* pyaqsapi.bystate.monitors,
        +* pyaqsapi.bystate.qa_annualperformanceeval,
        +* pyaqsapi.bystate.qa_annualperformanceevaltransaction,
        +* pyaqsapi.bystate.qa_blanks,
        +* pyaqsapi.bystate.qa_collocated_assessments,
        +* pyaqsapi.bystate.qa_flowrateaudit,
        +* pyaqsapi.bystate.qa_flowrateverification,
        +* pyaqsapi.bystate.qa_one_point_qc,
        +* pyaqsapi.bystate.qa_pep_audit,
        +* pyaqsapi.bystate.quarterlysummary,
        +* pyaqsapi.bystate.sampledata,
        +* pyaqsapi.bystate.transactionsample
        +
        +
        +

        pyaqsapi functions are named according to the service and filter variables that +are available by the AQS Data Mart API. Refer to Air Quality System (AQS) API for full details of the +AQS DataMart API.

        +
        +
        +

        Variable descriptions and usage

        +

        These are all the available variables that can be used with various functions +exported from the pyaqsapi library listed alphabetically. Not all of these +variables are used with every function, and not all of these parameters are +required. See the :ref: pyaqsapi functional families section to +see which parameters are used with each function.

        +
          +
        • +
          AQSobject:

          an object of type AQSAPI_V2 that is returned from pyaqsapi +aggregate functions wheen return_header is True.

          +
          +
          +
        • +
        • +
          bdate:

          a date object which represents the begin date of the data selection. +Only data on or after this date will be returned.

          +
          +
          +
        • +
        • +
          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.

          +
          +
          +
        • +
        • +
          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.

          +
          +
          +
        • +
        • +
          countycode:

          a character object which represents the 3 digit state FIPS code for the +county being requested (with leading zero(s)). Refer to +:ref: listfunctions for a table of available county codes for each state.

          +
          +
          +
        • +
        • +
          duration (optional):

          a character string that represents the parameter duration code that limits +returned data to a specific sample duration. The default value of None +will result in no filtering based on duration code. Valid durations +include actual sample durations and not calculated durations such as 8 hour +CO or O3rolling averages, 3/6 day PM averages or Pb 3 month +rolling averages. Refer to :ref: aqs_sampledurations() for a table of all +available duration codes.

          +
          +
          +
        • +
        • +
          edate:

          a date object which represents the end date of the data selection. Only +data on or before this date will be returned.

          +
          +
          +
        • +
        • +
          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 +email will be sent to the account specified.

          +
          +
          +
        • +
        • +
          key:

          a character object which represents the key used in conjunction with the +username given to connect to AQS Data Mart.

          +
          +
          +
        • +
        • +
          MA_code:

          a character object which represents the 4 digit AQS Monitoring Agency code +(with leading zeroes).

          +
          +
          +
        • +
        • +
          maxlat:

          a character object which represents the maximum latitude of a geographic +box. Decimal latitude with north begin positive. Only data south of this +latitude will be returned.

          +
          +
          +
        • +
        • +
          maxlon:

          a character object which represents the maximum longitude of a +geographic box. Decimal longitude with east being positive. Only +data west of this longitude will be returned. Note that -80 is less +than -70.

          +
          +
          +
        • +
        • +
          minlat:

          a character object which represents the minimum latitude of a +geographic box. Decimal latitude with north being positive. +Only data north of this latitude will be returned.

          +
          +
          +
        • +
        • +
          minlon:

          a character object which represents the minimum longitude of a +geographic box. Decimal longitude with east begin positive. Only +data east of this longitude will be returned.

          +
          +
          +
        • +
        • +
          parameter:

          a character list or single character object which represents the parameter +code of the air pollutant related to the data being requested.

          +
          +
          +
        • +
        • +
          return_Header:

          If False (default) only returns data requested as a pandas DataFrame. If +True returns a AQSAPI_V2 object.

          +
          +
          +
        • +
        • +
          service:

          a string which represents the services provided by the AQS API. For a list +of available services refer to +<https://aqs.epa.gov/aqsweb/documents/data_api.html#services>_ +for the complete listing of services available through the EPA +AQS Datamart API

          +
          +
          +
        • +
        • +
          sitenum:

          a character object which represents the 4 digit site number (with +leading zeros) within the county and state being requested.

          +
          +
          +
        • +
        • +
          stateFIPS:

          a character object which represents the 2 digit state FIPS code +(with leading zero) for the state being requested.

          +
          +
          +
        • +
        • +
          pqao_code:

          a character object which represents the 4 digit AQS Primary Quality +Assurance Organization code (with leading zeroes).

          +
          +
          +
        • +
        • +
          username:

          a character object which represents the email account that will be used to +connect to the AQS API.

          +
          +
          +
        • +
        +
        +
        +

        pyaqsapi functional families

        +
        +

        Sign up and credentials

        +

        The functions included in this family of functions are:

        +
        * aqs_credentials
        +* aqs_sign_up
        +
        +
        +
        +
        These functions are used to sign up with Data Mart and to store credential

        information to use with pyaqsapi. The aqs_sign_up function takes +one parameter:

        +
        +
        +
          +
        • email:

        • +
        +

        The aqs_credentials function takes two parameters:

        +
          +
        • username:

        • +
        • key:

        • +
        +
        +
        +

        Data Mart API metadata functions

        +

        The functions included in this family of functions are:

        +
        * aqs_isavailable
        +* aqs_knownissues
        +* aqs_fields_by_service
        +* aqs_revisionhistory
        +
        +
        +

        These functions return Data Mart meta data

        +
        +
        The aqs_isavailable function takes no parameters and returns a

        table which details the status of the AQS API.

        +
        +
        The aqs_fields_by_service function takes one parameter, service,

        which is a character object which represents the services provided by +the AQS API. For a list of available services see +Air Quality System (AQS) API - Services Overview

        +
        +
        The aqs_knownissues function takes no parameters and Returns a

        table of any known issues with system functionality or the data. These are +usually issues that have been identified internally and will require some +time to correct in Data Mart or the API. This function implements a direct +API call to Data Mart and returns data directly from the API. Issues +returned via this function do not include any issues from the pyaqsapi +package.

        +
        +
        The aqs_revisionhistory function is used to query Data Mart for the

        change history to the API.

        +
        +
        +
        +
        +

        Data Mart API list functions

        +

        The functions included in this family of functions are:

        +
        * aqs_cbsas,
        +* aqs_classes,
        +* aqs_counties_by_state,
        +* aqs_fields_by_service,
        +* aqs_isavailable,
        +* aqs_knownissues,
        +* aqs_mas,
        +* aqs_parameters_by_class,
        +* aqs_pqaos,
        +* aqs_revisionhistory,
        +* aqs_sampledurations,
        +* aqs_sites_by_county,
        +* aqs_states
        +
        +
        +
        +
        List functions return the API status, API options or groupings that can be used

        in conjunction with other API calls. By default each function in this +category returns results as a DataTable. If return_header parameter is set +to True a AQSAPI_v2 object is returned instead.

        +
        +
        aqs_cbsas returns a table of all available Core Based Statistical

        Areas (cbsas) and their respective cbsa codes.

        +
        +
        aqs_states takes no arguments and returns a table of the available

        states and their respective state FIPS codes.

        +
        +
        aqs_sampledurations takes no arguments and returns a table of the

        available sample duration code used to construct other requests.

        +
        +
        aqs_classes takes no arguments and returns a table of parameter

        classes (groups of parameters, i.e. "criteria" or "all").

        +
        +
        aqs_counties_by_state takes one parameter, stateFIPS, which is a two

        digit state FIPS code for the state being requested represented as a +character object and returns a table of counties and their +respective FIPS code for the state requested. Use aqs_states to +receive a table of valid state FIPS codes.

        +
        +
        aqs_sites_by_county takes two parameters, stateFIPS, which is a

        two digit state FIPS code for the state being requested and county_code +which is a three digit county FIPS code for the county being requested, +both stateFIPS and county_code should be encoded as a character object. +This function returns a table of all air monitoring sites with the +requested state and county FIPS code combination.

        +
        +
        aqs_pqaos takes no parameters and returns an AQSAPI_V2

        object containing a table of primary quality assurance +organizations (pqaos).

        +
        +
        aqs_mas takes no parameters and returns an AQSAPI_V2

        object containing a table of monitoring agencies (MA).

        +
        +
        +
        +
        +

        Data Mart aggregate functions

        +
        +
        ..note::

        AQS Data Mart API restricts the maximum amount of monitoring data to one +full year of data per API call. These functions are able to return multiple +years of data by making repeated calls to the API. Each call to the Data +Mart API will take time to complete. The more years of data being requested +the longer pyaqsapi will take to return the results.

        +
        +
        These functions retrieve aggregated data from the Data Mart API and are

        grouped by how each function aggregates the data. There are 5 different +families of related aggregate functions. These families are arranged by how +the Data Mart API groups the returned data, bysite, bycounty, bystate, +by<latitude/longitude bounding box> (bybox) and +by<core based statistical area> (bycbsa). Within each family +of aggregated data functions there are functions that call on the 10 +different services that the Data Mart API provides. All Aggregate +functions return a pandas DataFrame by default. If the return_Header +parameter is set to True an AQSAPI_V2 object is returned instead.

        +
        +
        +

        These fourteen services are:

        +
          +
        1. +
          Monitors: Returns operational information about the samplers (monitors)

          used to collect the data. Includes identifying information, +operational dates, operating organizations, etc. Functions +using this service contain monitors in the function +name.

          +
          +
          +
        2. +
        3. +
          Sample Data: Returns sample data - the most fine grain data reported to
          +

          EPA. Usually hourly, sometimes 5-minute, 12-hour, etc. +This service is available in several geographic selections +based on geography: site, county, state, cbsa (core based +statistical area, a grouping of counties), or +by latitude/longitude bounding box. Functions using this +service contain sampledata in the function name. +All Sample Data functions accept two additional, optional +parameters; cbdate and cedate.

          +
          +
            +
          • +
            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.

            +
            +
            +
          • +
          • +
            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 optional variable which defaults to None.

            +
            +
            +
          • +
          • +
            duration: an optional character string that represents the parameter

            duration code that limits returned data to +a specific sample duration. The default value of +None results in no filtering based on +duration code. Valid durations include actual sample +durations and not calculated durations such as 8 hour +CO or $O_3$ rolling averages, 3/6 day PM averages or +Pb 3 month rolling averages. Refer to +[aqs_sampledurations()] for a list of all available +duration codes.

            +
            +
            +
          • +
          +
          +
          +
        4. +
        5. +
          Daily Summary Data: Returns data summarized at the daily level. All daily
          +

          summaries are calculated on midnight to midnight +basis in local time. Variables returned include +date, mean value, maximum value, etc. Functions +using this service contain Dailysummary in +the function name. All Daily Summary Data functions +accept two additional parameters; cbdate and cedate

          +
          +
            +
          • +
            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.

            +
            +
            +
          • +
          • +
            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 optional variable which defaults to None.

            +
            +
            +
          • +
          +
          +
          +
        6. +
        7. +
          Annual Summary Data: Returns data summarized at the yearly level.
          +

          Variables include mean value, maxima, +percentiles, etc. Functions using this service +contain annualdata in the function name. All +Annual Summary Data functions accept two +additional parameters; cbdate and cedate.

          +
          +
            +
          • +
            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.

            +
            +
            +
          • +
          • +
            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 +optional variable which defaults to None.

            +
            +
            +
          • +
          +
          +
          +
        8. +
        9. +
          Quarterly Summary Data: Returns data summarized at the quarterly level.
          +

          Variables include mean value, maxima, +percentiles, etc. Functions using this service +contain quarterlydata in the function name. All +Annual Summary Data functions accept two +additional parameters; cbdate and cedate.

          +
          +
            +
          • +
            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.

            +
            +
            +
          • +
          • +
            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 +optional variable which defaults to None.

            +
            +
            +
          • +
          +
          +
          +
        10. +
        11. +
          Quality Assurance - Blanks Data:
          +
          Quality assurance data - blanks samples.

          Blanks are unexposed sample collection devices +(e.g., filters) that are transported with the +exposed sample devices to assess if contamination +is occurring during the transport or handling of +the samples. Functions using this service contain +qa_blanks in the function name.

          +
          +
          +
          +
          +
        12. +
        13. +
          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 this service +contain qa_collocated_assessments in the +function name.

          +
          +
          +
          +
          +
        14. +
        15. +
          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 taking +a measurement of the flow rate. Functions using this +service contain qa_flowrateverification in +the function name.

          +
          +
          +
          +
          +
        16. +
        17. +
          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 different +method than is used for flow rate verifications. +Functions using this service contain +qa_flowrateaudit in the function name.

          +
          +
          +
          +
          +
        18. +
        19. +
          Quality Assurance - One Point Quality Control Raw Data:

          Quality assurance data - one point quality control check +raw data. At least every two weeks, certain gaseous +monitors must be challenged with a known concentration to +determine monitor performance. Functions using this +service contain qa_one_point_qc in the function +name.

          +
          +
          +
        20. +
        21. +
          Quality Assurance - pep Audits:

          Quality assurance data - performance evaluation program +(pep) audits. pep audits are independent assessments used +to estimate total measurement system bias with a primary +quality assurance organization. Functions using this +service contain qa_pep_audit in the function +name.

          +
          +
          +
        22. +
        23. +
          Transaction Sample - AQS Submission data in transaction format (RD):

          Transaction sample data - The raw transaction sample data +uploaded to AQS by the agency responsible for data +submissions in RD format. Functions using this +service contain transactionsample in the +function name. Transaction sample data is only available +aggregated by site, county, state or monitoring agency.

          +
          +
          +
        24. +
        25. +
          Quality Assurance - Annual Performance Evaluations:

          Quality assurance data - Annual performance evaluations. +A performance evaluation must be conducted on each primary +monitor once per year. The percent differences between +known and measured concentrations at several levels are +used to assess the quality of the monitoring data. +Functions using this service contain +aqs_qa_annualperformanceeval in the function +name. Annual performance in transaction format are +only available aggregated by site, county, state, +monitoring agency, and primary quality assurance +organization. Annual performance evaluations are only +available aggregated by site, county, state, +monitoring agency, and primary quality assurance +organization.

          +
          +
          +
        26. +
        27. +
          Quality Assurance - Annual performance Evaluations in transaction
          +
          format (RD):

          Quality assurance data - The raw transaction annual +performance evaluations data in RD format. Functions using +this service contain +aqs_qa_annualperformanceevaltransaction in the +function name. Annual performance evaluations in transaction +format are only available aggregated by site, county, state, +monitoring agency, and primary quality assurance +organization.

          +
          +
          +
          +
          +
        28. +
        +
        +
        +

        Data Mart aggregate functions bysite

        +

        The pyaqsapi.bysite module exports the following functions:

        +
        * bysite.annualsummary,
        +* bysite.dailysummary,
        +* bysite.helperfunctions,
        +* bysite.monitors,
        +* bysite.qa_annualpeferomanceeval,
        +* bysite.qa_annualperformanceevaltransaction,
        +* bysite.qa_blanks,
        +* bysite.qa_collocated_assessments,
        +* bysite.qa_flowrateaudit,
        +* bysite.qa_flowrateverification,
        +* bysite.qa_one_point_qc,
        +* bysite.qa_pep_audit,
        +* bysite.quarterlysummary,
        +* bysite.sampledata,
        +* bysite.transactionsample
        +
        +
        +
        +
        Functions in this family of functions aggregate data at the site level. All

        bysite functions accept the following variables:

        +
        +
        +
          +
        • parameter:

        • +
        • bdate:

        • +
        • edate:

        • +
        • stateFIPS:

        • +
        • countycode:

        • +
        • sitenum:

        • +
        • +
          cbdate (optional): (This parameter is only used in conjunction with

          sampledata, dailysummary, +annualdata functions and +quarterlysummary functions).

          +
          +
          +
        • +
        • +
          cedate (optional): (This parameter is only used in conjunction with

          sampledata, dailysummary, +annualdata functions and +quarterlysummary functions).

          +
          +
          +
        • +
        • return_header (optional): set to False by default.

        • +
        • +
          duration (optional): (This parameter is only used in conjunction with

          sampledata functions).

          +
          +
          +
        • +
        +
        +
        +

        Data Mart aggregate functions bycounty

        +

        The pyaqsapi.bycounty module exports the following functions:

        +
        * bycounty.annualsummary,
        +* bycounty.dailysummary,
        +* bycounty.helperfunctions,
        +* bycounty.monitors,
        +* bycounty.qa_annualperformanceeval,
        +* bycounty.qa_annualperformanceevaltransaction,
        +* bycounty.qa_blanks,
        +* bycounty.qa_collocated_assessments,
        +* bycounty.qa_flowrateaudit,
        +* bycounty.qa_flowrateverification,
        +* bycounty.qa_one_point_qc,
        +* bycounty.qa_pep_audit,
        +* bycounty.quarterlysummary,
        +* bycounty.sampledata,
        +* bycounty.transactionsample
        +
        +
        +
        +
        Functions in this family of functions aggregate data at the county level.

        All functions accept the following variables:

        +
        +
        +
          +
        • parameter:

        • +
        • bdate:

        • +
        • edate:

        • +
        • stateFIPS:

        • +
        • countycode:

        • +
        • +
          cbdate (optional): (This parameter is only used in conjunction with

          sampledata, dailysummary, +annualdata and +quarterlysummary functions).

          +
          +
          +
        • +
        • +
          cedate (optional): (This parameter is only used in conjunction with

          sampledata, dailysummary, +annualdata and +quarterlysummary functions).

          +
          +
          +
        • +
        • return_header (optional): set to False by default.

        • +
        • +
          duration (optional): (This parameter is only used in conjunction with

          sampledata functions).

          +
          +
          +
        • +
        +
        +
        +

        Data Mart aggregate functions bystate

        +

        The pyaqsapi.bystate module exports the following functions:

        +
        * bystate.annualsummary,
        +* bystate.dailysummary,
        +* bystate.helperfunctions,
        +* bystate.monitors,
        +* bystate.qa_annualperformanceeval,
        +* bystate.qa_annualperformanceevaltransaction,
        +* bystate.qa_blanks,
        +* bystate.qa_collocated_assessments,
        +* bystate.qa_flowrateaudit,
        +* bystate.qa_flowrateverification,
        +* bystate.qa_one_point_qc,
        +* bystate.qa_pep_audit,
        +* bystate.quarterlysummary,
        +* bystate.sampledata,
        +* bystate.transactionsample
        +
        +
        +
        +
        Functions in this family of functions aggregate data at the state level.

        All functions accept the following variables:

        +
        +
        +
          +
        • parameter:

        • +
        • bdate:

        • +
        • edate:

        • +
        • stateFIPS:

        • +
        • countycode:

        • +
        • +
          cbdate (optional): (This parameter is only used in conjunction with

          sampledata, dailysummary, +annualdata and +quarterlysummary functions).

          +
          +
          +
        • +
        • +
          cedate (optional): (This parameter is only used in conjunction with

          sampledata, dailysummary, +annualdata and +quarterlysummary functions).

          +
          +
          +
        • +
        • return_header (optional): set to False by default.

        • +
        • +
          duration (optional): (This parameter is only used in conjunction with

          sampledata functions).

          +
          +
          +
        • +
        +
        +
        +

        Data Mart aggregate functions by Monitoring agency (MA)

        +

        The pyaqsapi.byma module exports the following functions:

        +
        * byma.qa_annualpeferomanceeval,
        +* byma.qa_annualperformanceevaltransaction,
        +* byma.qa_blanks,
        +* byma.qa_collocated_assessments,
        +* byma.qa_flowrateaudit,
        +* byma.qa_flowrateverification,
        +* byma.qa_one_point_qc,
        +* byma.qa_pep_audit,
        +* byma.transactionsample
        +
        +
        +
        +
        Functions in this family of functions aggregate data at the state level.

        All functions accept the following variables:

        +
        +
        +
          +
        • parameter:

        • +
        • bdate:

        • +
        • edate:

        • +
        • stateFIPS:

        • +
        • +
          cbdate (optional): (This parameter is only used in conjunction with

          sampledata, dailysummary, +annualdata functions and +quarterlysummary functions).

          +
          +
          +
        • +
        • +
          cedate (optional): (This parameter is only used in conjunction with

          sampledata, dailysummary, +annualdata and +quarterlysummary functions).

          +
          +
          +
        • +
        • return_header (optional): set to False by default.

        • +
        • +
          duration (optional): (This parameter is only used in conjunction with

          sampledata functions).

          +
          +
          +
        • +
        +
        +
        functions in this family of functions aggregate data at the Monitoring Agency

        (MA) level. All functions accept the following variables:

        +
        +
        +
          +
        • parameter:

        • +
        • bdate:

        • +
        • edate:

        • +
        • MA_code:

        • +
        • +
          cbdate (optional): (This parameter is only used in conjunction with

          sampledata, dailysummary, +annualdata and +quarterlysummary functions).

          +
          +
          +
        • +
        • +
          cedate (optional): (This parameter is only used in conjunction with

          sampledata, dailysummary, +annualdata and +quarterlysummary functions).

          +
          +
          +
        • +
        • return_header (optional): set to False by default.

        • +
        • +
          duration (optional): (This parameter is only used in conjunction with

          sampledata functions).

          +
          +
          +
        • +
        +
        +
        +

        Data Mart aggregate functions by Core Based Statistical Area (cbsa)

        +

        The pyaqsapi.bycbsa module exports the following functions:

        +
        * bycbsa.annualsummary,
        +* bycbsa.dailysummary,
        +* bycbsa.helperfunctions,
        +* bycbsa.monitors,
        +* bycbsa.quarterlysummary,
        +* bycbsa.sampledata
        +
        +
        +
        +
        Functions in this family of functions aggregate data at the Core Based

        Statistical Area (cbsa, as defined by the US Census Bureau) level. +All functions accept the following variables:

        +
        +
        +
          +
        • parameter:

        • +
        • bdate:

        • +
        • edate:

        • +
        • cbsa_code:

        • +
        • +
          cbdate (optional): (This parameter is only used in conjunction with

          sampledata, dailysummary, +annualdata and +quarterlysummary functions).

          +
          +
          +
        • +
        • +
          cedate (optional): (This parameter is only used in conjunction with

          sampledata, dailysummary, +annualdata and +quarterlysummary functions).

          +
          +
          +
        • +
        • return_header (optional): set to False by default.

        • +
        • +
          duration (optional): (This parameter is only used in conjunction with

          sampledata functions).

          +
          +
          +
        • +
        +
        +
        +

        Data Mart aggregate functions by Primary Quality Assurance Organization (pqao)

        +

        The pyaqsapi.bypqao module exports the following functions:

        +
        * bypqao.qa_annualperformanceeval,
        +* bypqao.qa_annualperformanceevaltransaction,
        +* bypqao.qa_blanks,
        +* bypqao.qa_collocated_assessments,
        +* bypqao.qa_flowrateaudit,
        +* bypqao.qa_flowrateverification,
        +* bypqao.qa_one_point_qc,
        +* bypqao.qa_pep_audit
        +
        +
        +
        +
        Functions in this family of functions aggregate data at the Primary Quality

        Assurance Organization (pqao) level. All functions accept the following +variables:

        +
        +
        +
          +
        • parameter:

        • +
        • bdate:

        • +
        • edate:

        • +
        • pqao_code:

        • +
        • return_header (optional): set to False by default.

        • +
        +
        +
        +

        Data Mart aggregate functions by latitude/longitude bounding box (bybox)

        +

        The pyaqsapi.bybox module exports the following functions:

        +
        * bybox.annualsummary,
        +* bybox.dailysummary,
        +* bybox.helperfunctions,
        +* bybox.monitors,
        +* bybox.quarterlysummary,
        +* bybox.sampledata
        +
        +
        +
        +
        Functions in this family of functions aggregate data by a

        latitude/longitude bounding box (bybox) level. All functions accept the +following variables:

        +
        +
        +
          +
        • parameter:

        • +
        • bdate:

        • +
        • edate:

        • +
        • minlat:

        • +
        • minlon:

        • +
        • maxlon:

        • +
        • maxlat:

        • +
        • +
          cbdate (optional): (This parameter is only used in conjunction with

          sampledata, dailysummary, +annualdata and +quarterlysummary functions).

          +
          +
          +
        • +
        • +
          cedate (optional): (This parameter is only used in conjunction with

          sampledata, dailysummary, +annualdata and +quarterlysummary functions).

          +
          +
          +
        • +
        • return_header (optional): set to False by default.

        • +
        • +
          duration (optional): (This parameter is only used in conjunction with

          sampledata functions).

          +
          +
          +
        • +
        +
        +
        +

        pyaqsapi Miscellaneous functions

        +

        These are miscellaneous functions exported by pyaqsapi.

        +

        aqs_removeheader is the function that the pyaqsapi library +uses internally to coerce an AQSAPI_V2 object into a pandas DataFrame. +This is useful if the user saves the output from another pyaqsapi function +with return_header = True set but later decides that they want just a +simple pandas DataFrame object. This function takes only one variable:

        +
          +
        • AQSobject:

        • +
        +
        +
        + + +
        +
        +
        + +
        + +
        +

        © 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 ef58cef07761df16ab49bfdb7c33f0d3e84d7041..1022a9386b3ec333d102b7b2194e1c45a6fc55b7 100644 GIT binary patch delta 1007 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 - - - - - Python Module Index — pyaqsapi documentation - - - - - - - - - - - - - - - - - - - - -
        - - -
        - -
        -
        -
        -
          -
        • - -
        • -
        • -
        -
        -
        -
        -
        - - -

        Python Module Index

        - -
        - p -
        - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
         
        - p
        - pyaqsapi -
            - pyaqsapi.bybox -
            - pyaqsapi.bybox.bybox -
            - pyaqsapi.bycbsa -
            - pyaqsapi.bycbsa.bycbsa -
            - pyaqsapi.bycounty -
            - pyaqsapi.bycounty.bycounty -
            - pyaqsapi.byma -
            - pyaqsapi.byma.byma -
            - pyaqsapi.bypqao -
            - pyaqsapi.bypqao.bypqao -
            - pyaqsapi.bysite -
            - pyaqsapi.bysite.bysite -
            - pyaqsapi.bystate -
            - pyaqsapi.bystate.bystate -
            - pyaqsapi.helperfunctions -
            - pyaqsapi.listfunctions -
            - pyaqsapi.metadatafunctions -
            - pyaqsapi.setupfunctions -
        - - -
        -
        -
        - -
        - -
        -

        © 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/pyaqsapi.bybox.html b/docs/_build/html/pyaqsapi.bybox.html deleted file mode 100644 index 129efd8..0000000 --- a/docs/_build/html/pyaqsapi.bybox.html +++ /dev/null @@ -1,350 +0,0 @@ - - - - - - - pyaqsapi.bybox package — pyaqsapi documentation - - - - - - - - - - - - - - - - - -
        - - -
        - -
        -
        -
        - -
        -
        -
        -
        - -
        -

        pyaqsapi.bybox package

        -
        -

        Submodules

        -
        -
        -

        pyaqsapi.bybox.bybox module

        -

        Functions that aggregate data by box. -(by latitude/longitude bounding box).

        -
        -
        -pyaqsapi.bybox.bybox.annualsummary(parameter, bdate, edate, minlat, maxlat, minlon, maxlon, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of annual data aggregated by latitude/longitude -bounding box (_by_box).

        -

        Annual summary contains a DataFrame matching the input parameter for the -rectangular area area bounded by minlat, maxlat, minlon, maxlon provided -for bdate - edate time frame. Variables returned include mean value, maxima, -percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character string which represents the parameter code of the

        air pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        minlata python character object which represents the minimum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data north of this latitude will be returned.

        -
        -
        maxlata python character object which represents the maximum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data south of this latitude will be returned.

        -
        -
        minlona python character object which represents the minimum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data east of this longitude will be returned.

        -
        -
        maxlona python character object which represents the maximum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data west of this longitude will be returned. Note that -80 -is less than -70.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object) sample data for all monitors
        -
        within the input latitude/longitude bounding box for a single parameter.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bybox.bybox.dailysummary(parameter, bdate, edate, minlat, maxlat, minlon, maxlon, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of daily summary data aggregated by latitude/longitude -bounding box (_by_box).

        -

        Daily summary contains a DataFrame matching the input parameter and -stateFIPS provided for bdate - edate time frame. Variables -returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character string which represents the parameter code of the

        air pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        minlata python character object which represents the minimum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data north of this latitude will be returned.

        -
        -
        maxlata python character object which represents the maximum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data south of this latitude will be returned.

        -
        -
        minlona python character object which represents the minimum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data east of this longitude will be returned.

        -
        -
        maxlona python character object which represents the maximum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data west of this longitude will be returned. Note that -80 -is less than -70.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): daily summary data for all
        -
        monitors within the input latitude/longitude bounding box for a single
        -
        parameter.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bybox.bybox.monitors(parameter, bdate, edate, minlat, maxlat, minlon, maxlon, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of monitors.

        -

        Return a table of monitors and related metadata sites with the provided -parameter, aggregated by latitude/longitude bounding box (_by_box) for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character string which represents the parameter code of the

        air pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        minlata python character object which represents the minimum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data north of this latitude will be returned.

        -
        -
        maxlata python character object which represents the maximum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data south of this latitude will be returned.

        -
        -
        minlona python character object which represents the minimum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data east of this longitude will be returned.

        -
        -
        maxlona python character object which represents the maximum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data west of this longitude will be returned. Note that -80 -is less than -70.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        pandas DataFrame or an AQSAPI_V2 object

        Returns a table of monitors from a latitude/longitude bounding -box (_by_box).

        -
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bybox.bybox.quarterlysummary(parameter, bdate, edate, minlat, maxlat, minlon, maxlon, cbdate=None, cedate=None, duration=None, return_header=False)
        -

        Return a DataFrame of quarterly data aggregate by latitude/longitude -bounding box (_by_box).

        -

        Quarterly summary contains a DataFrame matching the input parameter, -stateFIPS and county_code provided for bdate - edate time frame. -Variables returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character string which represents the parameter code of the

        air pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        minlata python character object which represents the minimum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data north of this latitude will be returned.

        -
        -
        maxlata python character object which represents the maximum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data south of this latitude will be returned.

        -
        -
        minlona python character object which represents the minimum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data east of this longitude will be returned.

        -
        -
        maxlona python character object which represents the maximum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data west of this longitude will be returned. Note that -80 -is less than -70.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): daily summary data for all
        -
        monitors within the input latitude/longitude bounding box for a single
        -
        parameter.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bybox.bybox.sampledata(parameter, bdate, edate, minlat, maxlat, minlon, maxlon, cbdate=None, cedate=None, duration=None, return_header=False)
        -

        Return sample data where the data is aggregated by latitude/longitude -bounding box (_by_box).

        -

        If return_header is FALSE (default) this function -returns a single DataFrame with the requested data. If return_header is -TRUE returns a list of AQSAPI_v2 objects

        -
        -
        Parameters:
        -
        -
        parametera character string which represents the parameter code of the

        air pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        minlata python character object which represents the minimum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data north of this latitude will be returned.

        -
        -
        maxlata python character object which represents the maximum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data south of this latitude will be returned.

        -
        -
        minlona python character object which represents the minimum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data east of this longitude will be returned.

        -
        -
        maxlona python character object which represents the maximum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data west of this longitude will be returned. Note that -80 -is less than -70.

        -
        -
        durationan optional python character string that represents the

        parameter duration code that limits returned data to a -specific sample duration. The default value of None results -in no filtering based on duration code.Valid durations -include actual sample durations and not calculated durations -such as 8 hour carbon monoxide or ozone rolling averages, -3/6 day PM averages or lead 3 month rolling averages. Use -aqs_sampledurations() for a list of all available -duration codes.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        -
        - -
        -
        -

        Module contents

        -
        -
        - - -
        -
        -
        - -
        - -
        -

        © 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/pyaqsapi.bycbsa.html b/docs/_build/html/pyaqsapi.bycbsa.html deleted file mode 100644 index 9967c7a..0000000 --- a/docs/_build/html/pyaqsapi.bycbsa.html +++ /dev/null @@ -1,373 +0,0 @@ - - - - - - - pyaqsapi.bycbsa package — pyaqsapi documentation - - - - - - - - - - - - - - - - - -
        - - -
        - -
        -
        -
        - -
        -
        -
        -
        - -
        -

        pyaqsapi.bycbsa package

        -
        -

        Submodules

        -
        -
        -

        pyaqsapi.bycbsa.bycbsa module

        -

        Functions that aggregate data by cbsa -(by Core Based Statistic Area, as defined by the Census Bureau).

        -
        -
        -pyaqsapi.bycbsa.bycbsa.annualsummary(parameter, bdate, edate, cbsa_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of annual data aggregated at the Core Based -Statistical Area (cbsa) level.

        -

        Annual summary contains a DataFrame matching the input parameter and -cbsa_code provided for bdate - edate time frame. Variables returned include -mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        cbsa_code: a python character object which represents the 5 digit AQS Core

        Based Statistical Area code (the same as the census code, with -leading zeros)

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): a DataFrame or an
        -
        AQS_Data Mart_APIv2 object that containing annual summary data for the
        -
        cbsa_code requested.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycbsa.bycbsa.dailysummary(parameter, bdate, edate, cbsa_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of data aggregated by Core Based Statistical Area -(cbsa).

        -

        Daily summary contains a DataFrame matching the input parameter and -cbsa_code provided for bdate - edate time frame. Variables -returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        cbsa_code: a python character object which represents the 5 digit AQS Core

        Based Statistical Area code (the same as the census code, with -leading zeros)

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): a DataFrame or an
        -
        AQS_Data Mart_APIv2 object that containing daily summary data for
        -
        the cbsa_code requested.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycbsa.bycbsa.monitors(parameter, bdate, edate, cbsa_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of monitors.

        -

        Return a table of monitors at all sites with the provided parameter, -aggregated by Core Based Statistical Area (CBSA) for bdate - edate -time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        cbsa_code: a python character object which represents the 5 digit AQS Core

        Based Statistical Area code (the same as the census code, with -leading zeros)

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance flow rate
        -
        verification data for monitors at a site.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycbsa.bycbsa.quarterlysummary(parameter, bdate, edate, cbsa_code, cbdate=None, cedate=None, return_header=False)
        -

        Return quarterly summary data aggregated by Core Based Statistical Area -(cbsa_code).

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        cbsa_code: a python character object which represents the 5 digit AQS Core

        Based Statistical Area code (the same as the census code, with -leading zeros).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        Example
        -
        -------
        -
        Return a DataFrame of NO2 quarterly summary
        -
        data the for Charlotte-Concord-Gastonia, NC cbsa for
        -
        each quarter in 2017.::

        import pyaqsapi as aqs -from datetime import date -... -aqs.bycbsa.quarterlysummary(parameter="42602",

        -
        -

        bdate=date(year=2017, month=1, day=1), -edate=date(year=2017, month=1, day=1), -cbsa_code="16740")

        -
        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quarterly summary statistics for
        -
        the given parameter for a all monitors with matching parameter and
        -
        cbsa_code combination within the bdate - edate timeframe.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycbsa.bycbsa.sampledata(parameter, bdate, edate, cbsa_code, duration=None, cbdate=None, cedate=None, return_header=False)
        -

        Return sample data where the data is aggregated at the Core Based -Statistical Area (cbsa) level.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        cbsa_code: a python character object which represents the 5 digit AQS Core

        Based Statistical Area code (the same as the census code, with -leading zeros)

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        durationan optional python character string that represents the

        parameter duration code that limits returned data to a specific -sample duration. The default value of None results in -no filtering based on duration code.Valid durations include -actual sample durations and not calculated durations such as 8 -hour carbon monoxide or ozone rolling averages, 3/6 day PM -averages or lead 3 month rolling averages. Use -aqs_sampledurations() for a list of all available -duration codes.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): sample data for all monitors
        -
        matching cbsa_code for the given parameter.
        -
        -
        -
        -
        - -
        -
        -

        Module contents

        -
        -
        - - -
        -
        -
        - -
        - -
        -

        © 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/pyaqsapi.bycounty.html b/docs/_build/html/pyaqsapi.bycounty.html deleted file mode 100644 index be4ee53..0000000 --- a/docs/_build/html/pyaqsapi.bycounty.html +++ /dev/null @@ -1,861 +0,0 @@ - - - - - - - pyaqsapi.bycounty package — pyaqsapi documentation - - - - - - - - - - - - - - - - - -
        - - -
        - -
        -
        -
        - -
        -
        -
        -
        - -
        -

        pyaqsapi.bycounty package

        -
        -

        Submodules

        -
        -
        -

        pyaqsapi.bycounty.bycounty module

        -

        Functions that aggregate data by county.

        -
        -
        -pyaqsapi.bycounty.bycounty.annualsummary(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of annual data aggregated at the county level.

        -

        Annual summary contains a DataFrame matching the input parameter, -stateFIPS and county_code provided for bdate - edate time frame. -Variables returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        Example
        -
        -------
        -
        Returns all FRM/FEM PM2.5 data for Wake County, NC between
        -
        January 1, 2015 - February 28, 2016::

        import pyaqsapi as aqs -from datetime import date -... -aqs.bycounty.annualsummary(parameter="88101",

        -
        -
        -
        bdate=date(year=2016,

        month=1, -day=1),

        -
        -
        edate=date(year=2016,

        month=2, -day=28),

        -
        -
        -

        stateFIPS="37", -countycode="183", -return_header=True)

        -
        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): annual summary data for the
        -
        requested stateFIPS and county combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.dailysummary(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of data aggregated at the county level.

        -

        Daily summary contains a DataFrame matching the input parameter, stateFIPS -and county_code provided for bdate - edate time frame. Variables -returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): blank quality assurance data for
        -
        the requested stateFIPS and county combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.monitors(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of monitors.

        -

        Return a table of monitors and related metadata at sites with the provided -parameter, stateFIPS and county_code for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): monitors from
        -
        the selected stateFIPS and county combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_annualperformanceeval(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return quality assurance performance evaluation data - aggregated by -site for a parameter code aggregated by matching input -parameter, stateFIPS and countycode provided for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data for all monitoring sites for the
        -
        matching countycode and stateFIPS requested for the time frame
        -
        between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_annualperformanceevaltransaction(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Returns AQS submissions transaction format (RD) of the annual -performance evaluation data (raw). Includes data pairs for -QA - aggregated by county for a parameter code aggregated by matching -input parameter, countycode and stateFIPS provided for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data. for all monitoring sites with matching
        -
        countycode and stateFIPS requested for the time frame
        -
        between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_blanks(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of blank quality assurance data. -Blanks are unexposed sample collection devices (e.g., -filters) that are transported with the exposed sample devices -to assess if contamination is occurring during the transport -or handling of the samples. Data is aggregated at the county level.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): blank quality assurance data for
        -
        the requested stateFIPS and county combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_collocated_assessments(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of collocated assessment data aggregated by matching input -parameter, stateFIPS and county_code provided for bdate - edate time -frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        collocated assessment data for monitors within a county.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_flowrateaudit(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return Quality assurance flowrate audit data.

        -

        Return a table containing flow rate audit data aggregated by parameter -code, stateFIPS and countycode for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): flow rate audit data for the
        -
        requested stateFIPS and county combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_flowrateverification(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a table containing flow rate Verification data for a parameter code -aggregated matching input parameter, stateFIPS, and county_code, provided -for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance flow rate
        -
        verification data for monitors within a county.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_one_point_qc(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a table containing flow rate audit data aggregated by parameter -code, stateFIPS and countycode for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): flow rate audit data for the
        -
        requested stateFIPS and county combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_pep_audit(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a table containing quality assurance Performance Evaluation Program -(PEP) audit data aggregated by parameter code, stateFIPS and countycode for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance Performance
        -
        Evaluation Program (PEP) audit data for the requested stateFIPS and county
        -
        combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.quarterlysummary(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of quarterly data aggregated at the county level.

        -

        Quarterly summary contains a DataFrame matching the input parameter, -stateFIPS and county_code provided for bdate - edate time frame. -Variables returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quarterly summary statistics for
        -
        the given parameter for a single countycode and stateFIPS combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.sampledata(parameter, bdate, edate, stateFIPS, countycode, duration=None, cbdate=None, cedate=None, return_header=False)
        -

        Returns sample data where the data is aggregated at the county level.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        durationan optional python character string that represents the

        parameter duration code that limits returned data to a specific -sample duration. The default value of None results in -no filtering based on duration code.Valid durations include -actual sample durations and not calculated durations such as 8 -hour carbon monoxide or ozone rolling averages, 3/6 day PM -averages or lead 3 month rolling averages. Use -aqs_sampledurations() for a list of all available -duration codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        durationan optional python character string that represents the

        parameter duration code that limits returned data to a -specific sample duration. The default value of None results -in no filtering based on duration code.Valid durations -include actual sample durations and not calculated durations -such as 8 hour carbon monoxide or ozone rolling averages, -3/6 day PM averages or lead 3 month rolling averages. Use -aqs_sampledurations() for a list of all available -duration codes.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance Performance
        -
        Evaluation Program (PEP) audit data for the requested stateFIPS and county
        -
        combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.transactionsample(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return transactionsample data - aggregated by county in the AQS Submission -Transaction Format (RD) sample (raw) data for a parameter code aggregated -by matching input parameter, stateFIPS and countycode provided for -bdate - edate time frame. Includes data both in submitted and -standard units.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): transaction sample (raw) data
        -
        in the AQS submission transaction format (RD) corresponding to the inputs
        -
        provided.
        -
        -
        -
        -
        - -
        -
        -

        Module contents

        -
        -
        - - -
        -
        -
        - -
        - -
        -

        © 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/pyaqsapi.byma.html b/docs/_build/html/pyaqsapi.byma.html deleted file mode 100644 index 8436d30..0000000 --- a/docs/_build/html/pyaqsapi.byma.html +++ /dev/null @@ -1,517 +0,0 @@ - - - - - - - pyaqsapi.byma package — pyaqsapi documentation - - - - - - - - - - - - - - - - - -
        - - -
        - -
        -
        -
        - -
        -
        -
        -
        - -
        -

        pyaqsapi.byma package

        -
        -

        Submodules

        -
        -
        -

        pyaqsapi.byma.byma module

        -

        Functions that aggregate data by ma (By Monitoring Agency).

        -
        -
        -pyaqsapi.byma.byma.qa_annualpeferomanceeval(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Returns quality assurance performance evaluation data - aggregated by -by Monitoring agency (MA) for a parameter code aggregated by matching input -parameter and MA_code for the time frame between bdate and edate.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance performance
        -
        evaluation data. for all monitoring sites for with the MA_code requested
        -
        for the time frame between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.qa_annualperformanceevaltransaction(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Returns AQS submissions transaction format (RD) of the annual performance -evaluation data (raw). Includes data pairs for QA - aggregated by -Monitoring agency (MA) for a parameter code aggregated by matching input -parameter and MA_code provided for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance performance
        -
        evaluation data in the AQS submissions transaction format (RD)for all sites
        -
        matching the MA_code requested for the time frame between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.qa_blanks(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of blank quality assurance data. Blanks are unexposed -sample collection devices (e.g., filters) that are transported with the -exposed sample devices to assess if contamination is occurring during the -transport or handling of the samples. Data is aggregated by monitoring -agency code (MA_code).

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance blank sample
        -
        data for all monitors within the input MA_code.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.qa_collocated_assessments(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of collocated assessment data aggregated by matching input -parameter, and monitoring agency (MA) code provided for bdate - edate -time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance collocated
        -
        assessment data for monitors within a monitoring agency.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.qa_flowrateaudit(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Return Quality assurance flowrate audit data.

        -

        Return a table containing flow rate audit data aggregated by parameter -code and monitoring agency code (_by_MA) for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): flow rate audit data for the
        -
        requested MA_code.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.qa_flowrateverification(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table containing flow rate Verification data for a parameter code -aggregated by matching input parameter, and monitoring agency (MA) code -provided for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): flow rate audit data for the
        -
        requested MA_code.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.qa_one_point_qc(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table one point QC check data aggregated by monitoring agency -code (_by_MA).

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): flow rate audit data for the
        -
        requested MA_code.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.qa_pep_audit(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of Performance Evaluation Program (PEP) audit data -aggregated by monitoring agency code (_by_MA) for the time frame between -bdate and edate.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance PEP audit data
        -
        for a monitoring agency.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.transactionsample(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Return transactionsample data - aggregated by Monitoring agency (MA) in -the AQS Submission Transaction Format (RD) sample (raw) data for a -parameter code aggregated by matching input parameter, and monitoring -agency (MA) code provided for bdate - edate time frame. Includes data both -in submitted and standard units.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): transaction sample (raw) data in
        -
        the AQS submission transaction format (RD) corresponding to the inputs
        -
        provided.
        -
        -
        -
        -
        - -
        -
        -

        Module contents

        -
        -
        - - -
        -
        -
        - -
        - -
        -

        © 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/pyaqsapi.bypqao.html b/docs/_build/html/pyaqsapi.bypqao.html deleted file mode 100644 index 6684486..0000000 --- a/docs/_build/html/pyaqsapi.bypqao.html +++ /dev/null @@ -1,485 +0,0 @@ - - - - - - - pyaqsapi.bypqao package — pyaqsapi documentation - - - - - - - - - - - - - - - - - -
        - - -
        - -
        -
        -
        - -
        -
        -
        -
        - -
        -

        pyaqsapi.bypqao package

        -
        -

        Submodules

        -
        -
        -

        pyaqsapi.bypqao.bypqao module

        -

        Functions that aggregate data by pqao -(By Primary Quality Assurance Organization).

        -
        -
        -pyaqsapi.bypqao.bypqao.qa_annualperformanceeval(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Return quality assurance performance evaluation data - aggregated by -Primary Quality Assurance Organization (PQAO) for a parameter -code aggregated by matching input parameter and pqao_code for the -time frame between bdate and edate.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data. for single monitoring site for the
        -
        pqao_code requested for the time frame between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bypqao.bypqao.qa_annualperformanceevaltransaction(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Returns AQS submissions transaction format (RD) of the annual -performance evaluation data (raw). Includes data pairs for -QA - aggregated by Primary Quality Assurance Organization (PQAO) -for a parameter code aggregated by matching input parameter and -pqao_code provided for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data. for single monitoring site for the
        -
        sitenum, countycode and stateFIPS requested for the time frame
        -
        between bdate and edate
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bypqao.bypqao.qa_blanks(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of blank quality assurance data. Blanks are unexposed -sample collection devices (e.g., filters) that are transported with the -exposed sample devices to assess if contamination is occurring during the -transport or handling of the samples. Data is aggregated by Primary Quality -Assurance Organization (PQAO).

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance blank data
        -
        for monitors within a pqao.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bypqao.bypqao.qa_collocated_assessments(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of blank quality assurance data. Blanks are unexposed -sample collection devices (e.g., filters) that are transported with the -exposed sample devices to assess if contamination is occurring during the -transport or handling of the samples. Data is aggregated by Primary Quality -Assurance Organization (PQAO).

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance blank data
        -
        for monitors within a pqao.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bypqao.bypqao.qa_flowrateaudit(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Return Quality assurance flowrate audit data.

        -

        Return quality assurance flow rate audit data aggregated by parameter code -and Primary Quality Assurance Organization (PQAO) code for bdate - edate -time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): flow rate audit data for the
        -
        requested pqao_code.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bypqao.bypqao.qa_flowrateverification(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table containing flow rate Verification data for a parameter code -aggregated by matching input parameter, and Primary Quality Assurance -Organization (PQAO) code provided for bdate - edate time.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance flow rate
        -
        verification data for monitors within a pqao.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bypqao.bypqao.qa_one_point_qc(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Return Quality assurance data - collocated assessment raw data aggregated -by Primary Quality Assurance Organization (PQAO) code.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): one point qc data within a pqao
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bypqao.bypqao.qa_pep_audit(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of Performance Evaluation Program (PEP) audit data -aggregated by Primary Quality Assurance Organization (PQAO) code for the -time frame between bdate and edate.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance PEP audit data
        -
        for a Primary Quality Assurance Organization.
        -
        -
        -
        -
        - -
        -
        -

        Module contents

        -
        -
        - - -
        -
        -
        - -
        - -
        -

        © 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/pyaqsapi.bysite.html b/docs/_build/html/pyaqsapi.bysite.html deleted file mode 100644 index 127ba0e..0000000 --- a/docs/_build/html/pyaqsapi.bysite.html +++ /dev/null @@ -1,881 +0,0 @@ - - - - - - - pyaqsapi.bysite package — pyaqsapi documentation - - - - - - - - - - - - - - - - - -
        - - -
        - -
        -
        -
        - -
        -
        -
        -
        - -
        -

        pyaqsapi.bysite package

        -
        -

        Submodules

        -
        -
        -

        pyaqsapi.bysite.bysite module

        -

        pyaqsapi Functions that aggregate data by site.

        -
        -
        -pyaqsapi.bysite.bysite.annualsummary(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of annual data aggregated at the site level.

        -

        Annual summary contains a DataFrame matching the input parameter, -stateFIPS, county_code, and sitenum provided for bdate - edate time frame. -Variables returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): annual summary data for the
        -
        sitenum, countycode and stateFIPS requested for the time frame between
        -
        bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.dailysummary(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of data aggregated at the site level.

        -

        Daily summary contains a DataFrame matching the input parameter, stateFIPS, -county_code, and sitenum provided for bdate - edate time frame. Variables -returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): daily summary data for the
        -
        sitenum, countycode and stateFIPS requested for the time frame between
        -
        bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.monitors(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of monitors.

        -
        -
        Return a table of monitors and related metadata at sites

        with the provided parameter, stateFIPS, county_code, and sitenum -for bdate - edate time frame.

        -
        -
        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): monitors from
        -
        the selected site.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_annualpeferomanceeval(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return quality assurance performance evaluation data - aggregated by -site for a parameter code aggregated by matching input -parameter, sitenum, countycode and stateFIPS provided for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data. for single monitoring site for the
        -
        sitenum, countycode and stateFIPS requested for the time frame
        -
        between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_annualperformanceevaltransaction(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Returns AQS submissions transaction format (RD) of the annual -performance evaluation data (raw). Includes data pairs for -QA - aggregated by site for a parameter code aggregated by matching -input parameter, sitenum, countycode and stateFIPS provided for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data. for single monitoring site for the
        -
        sitenum, countycode and stateFIPS requested for the time frame
        -
        between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_blanks(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of blank quality assurance data. -Blanks are unexposed sample collection devices (e.g., -filters) that are transported with the exposed sample devices -to assess if contamination is occurring during the transport -or handling of the samples. Data is aggregated at the site level.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE
        -
        returns a AQSAPI_v2 object.
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance blank
        -
        sample data for single monitoring site for the sitenum, countycode and
        -
        stateFIPS requested for the time frame between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_collocated_assessments(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of collocated assessment data aggregated by matching -input parameter, stateFIPS, county_code, and sitenum provided for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance collocated
        -
        assessment data for monitors within a site.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_flowrateaudit(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return Quality assurance flowrate audit data.

        -

        Return a table containing flow rate audit data aggregated by -parameter code, stateFIPS, countycode and site number for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): flow rate audit data
        -
        for the requested sitenum, countycode and stateFIPS for the time
        -
        period between bdate - edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_flowrateverification(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of containing flow rate verification data aggregated by -matching input parameter, stateFIPS, county_code, and sitenum provided for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance flow rate
        -
        verification data for monitors at a site.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_one_point_qc(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of one point QC raw data aggregated -by parameter code, stateFIPS, countycode and site number.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): for the requested sitenum,
        -
        countycode and stateFIPS for the time period between bdate - edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_pep_audit(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of Performance Evaluation Program (PEP) audit -data aggregated by parameter code, stateFIPS, countycode and -site number for the time frame between bdate and edate.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        PEP audit data within a stateFIPS, countycode and sitenum
        -
        for the time frame between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.quarterlysummary(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of quarterly data aggregated at the site level.

        -

        Quarterly summary contains a DataFrame matching the input parameter, -stateFIPS, county_code, and sitenum provided for bdate - edate time frame. -Variables returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quarterly summary statistics for
        -
        the given parameter for a single countycode and stateFIPS combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.sampledata(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, duration=None, return_header=False)
        -

        Returns sample data where the data is aggregated at the site level.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        durationan optional python character string that represents the

        parameter duration code that limits returned data to a -specific sample duration. The default value of None results -in no filtering based on duration code.Valid durations -include actual sample durations and not calculated durations -such as 8 hour carbon monoxide or ozone rolling averages, -3/6 day PM averages or lead 3 month rolling averages. Use -aqs_sampledurations() for a list of all available -duration codes.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): sample data aggregated at the
        -
        site level matching the input stateFIPS, countycode and sitenum
        -
        for the time frame between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.transactionsample(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of Returns transactionsample data aggregated by site -in the AQS Submission Transaction Format (RD) sample (raw) data aggregated -by matching input parameter, stateFIPS, county_code, and sitenum provided -for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): transaction sample
        -
        (raw) data in the AQS submission transaction format (RD)
        -
        corresponding to the inputs provided.
        -
        -
        -
        -
        - -
        -
        -

        Module contents

        -
        -
        - - -
        -
        -
        - -
        - -
        -

        © 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/pyaqsapi.bystate.html b/docs/_build/html/pyaqsapi.bystate.html deleted file mode 100644 index 6201fb7..0000000 --- a/docs/_build/html/pyaqsapi.bystate.html +++ /dev/null @@ -1,773 +0,0 @@ - - - - - - - pyaqsapi.bystate package — pyaqsapi documentation - - - - - - - - - - - - - - - - - -
        - - -
        - -
        -
        -
        - -
        -
        -
        -
        - -
        -

        pyaqsapi.bystate package

        -
        -

        Submodules

        -
        -
        -

        pyaqsapi.bystate.bystate module

        -

        Functions that aggregated data by state.

        -
        -
        -pyaqsapi.bystate.bystate.annualsummary(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of annual data aggregated at the state level.

        -

        Annual summary contains a DataFrame matching the input parameter and -stateFIPS provided for bdate - edate time frame. Variables returned include -mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): annual summary data for the
        -
        stateFIPS requested.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.dailysummary(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of data aggregated at the state level.

        -

        Daily summary contains a DataFrame matching the input parameter and -stateFIPS provided for bdate - edate time frame. Variables -returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): daily summary statistics for the
        -
        given parameter for a single stateFIPS.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.monitors(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of monitors.

        -

        Return a table of monitors and related metadata at all sites -with the provided parameter and stateFIPS for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): monitors from the

        selected state.

        -
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_annualperformanceeval(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return quality assurance performance evaluation data - aggregated by -site for a parameter code aggregated by matching input -parameter, and stateFIPS provided for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data for all monitoring sites for the
        -
        matching parameter and stateFIPS requested for the time frame
        -
        between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_annualperformanceevaltransaction(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return AQS submissions transaction format (RD) of the annual -performance evaluation data (raw). Includes data pairs for -QA - aggregated by county for a parameter code aggregated by matching -input parameter and stateFIPS provided for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data. for all monitoring sites with matching
        -
        parameter and stateFIPS requested for the time frame
        -
        between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_blanks(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of blank quality assurance data. Blanks are unexposed -sample collection devices (e.g., filters) that are transported with the -exposed sample devices to assess if contamination is occurring during -the transport or handling of the samples. Data is aggregated at the state -level.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance blank sample
        -
        data for all monitors within the input stateFIPS.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_collocated_assessments(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of collocated assessment data aggregated by matching input -parameter and stateFIPS provided for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance collocated
        -
        assessment data for monitors within a state.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_flowrateaudit(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return Quality assurance flowrate audit data.

        -

        Return a table of monitors and related metadata at all sites -with the provided parameter and stateFIPS for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): monitors from the

        selected state.

        -
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_flowrateverification(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a table containing flow rate Verification data for a parameter code -aggregated matching input parameter, and stateFIPS, provided for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance flow rate
        -
        verification data for monitors within a state.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_one_point_qc(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame or an AQS_Data Mart_APIv2 S3 object containing Quality -assurance data - flow rate audit raw data aggregated by state FIPS for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): one point qc data within the
        -
        input stateFIPS for bdate - edate time frame..
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_pep_audit(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of Performance Evaluation Program (PEP) audit data -aggregated by parameter code, and stateFIPS for the time frame between -bdate and edate.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance PEP audit data
        -
        within a state.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.quarterlysummary(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of quarterly data aggregated at the state level.

        -

        Quarterly summary contains a DataFrame matching the input parameter, -stateFIPS a provided for bdate - edate time frame. Variables returned -include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quarterly summary statistics for
        -
        the given parameter for a all monitors with matching parameter and
        -
        stateFIPS combination within the bdate - edate timeframe.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.sampledata(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, duration=None, return_header=False)
        -

        Return sample data where the data is aggregated at the state level.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        durationan optional python character string that represents the

        parameter duration code that limits returned data to a -specific sample duration. The default value of None results -in no filtering based on duration code.Valid durations -include actual sample durations and not calculated durations -such as 8 hour carbon monoxide or ozone rolling averages, -3/6 day PM averages or lead 3 month rolling averages. Use -aqs_sampledurations() for a list of all available -duration codes.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): containing sample data
        -
        for all monitors matching stateFIPS for the given parameter.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.transactionsample(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return transactionsample data - aggregated by state in the AQS Submission -Transaction Format (RD) sample (raw) data for a parameter code aggregated -by matching input parameter, and stateFIPS provided for bdate - edate time -frame. Includes data both in submitted and standard units.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): transaction sample (raw) data
        -
        in the AQS submission transaction format (RD) corresponding to the inputs
        -
        provided.
        -
        -
        -
        -
        - -
        -
        -

        Module contents

        -
        -
        - - -
        -
        -
        - -
        - -
        -

        © 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/pyaqsapi.html b/docs/_build/html/pyaqsapi.html deleted file mode 100644 index 779233c..0000000 --- a/docs/_build/html/pyaqsapi.html +++ /dev/null @@ -1,4213 +0,0 @@ - - - - - - - pyaqsapi package — pyaqsapi documentation - - - - - - - - - - - - - - - - - -
        - - -
        - -
        -
        -
        - -
        -
        -
        -
        - -
        -

        pyaqsapi package

        -
        -

        Submodules

        -
        -

        pyaqsapi.bybox.bybox module

        -

        Functions that aggregate data by box. -(by latitude/longitude bounding box).

        -
        -
        -pyaqsapi.bybox.bybox.annualsummary(parameter, bdate, edate, minlat, maxlat, minlon, maxlon, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of annual data aggregated by latitude/longitude -bounding box (_by_box).

        -

        Annual summary contains a DataFrame matching the input parameter for the -rectangular area area bounded by minlat, maxlat, minlon, maxlon provided -for bdate - edate time frame. Variables returned include mean value, maxima, -percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character string which represents the parameter code of the

        air pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        minlata python character object which represents the minimum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data north of this latitude will be returned.

        -
        -
        maxlata python character object which represents the maximum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data south of this latitude will be returned.

        -
        -
        minlona python character object which represents the minimum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data east of this longitude will be returned.

        -
        -
        maxlona python character object which represents the maximum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data west of this longitude will be returned. Note that -80 -is less than -70.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object) sample data for all monitors
        -
        within the input latitude/longitude bounding box for a single parameter.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bybox.bybox.dailysummary(parameter, bdate, edate, minlat, maxlat, minlon, maxlon, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of daily summary data aggregated by latitude/longitude -bounding box (_by_box).

        -

        Daily summary contains a DataFrame matching the input parameter and -stateFIPS provided for bdate - edate time frame. Variables -returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character string which represents the parameter code of the

        air pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        minlata python character object which represents the minimum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data north of this latitude will be returned.

        -
        -
        maxlata python character object which represents the maximum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data south of this latitude will be returned.

        -
        -
        minlona python character object which represents the minimum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data east of this longitude will be returned.

        -
        -
        maxlona python character object which represents the maximum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data west of this longitude will be returned. Note that -80 -is less than -70.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): daily summary data for all
        -
        monitors within the input latitude/longitude bounding box for a single
        -
        parameter.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bybox.bybox.monitors(parameter, bdate, edate, minlat, maxlat, minlon, maxlon, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of monitors.

        -

        Return a table of monitors and related metadata sites with the provided -parameter, aggregated by latitude/longitude bounding box (_by_box) for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character string which represents the parameter code of the

        air pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        minlata python character object which represents the minimum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data north of this latitude will be returned.

        -
        -
        maxlata python character object which represents the maximum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data south of this latitude will be returned.

        -
        -
        minlona python character object which represents the minimum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data east of this longitude will be returned.

        -
        -
        maxlona python character object which represents the maximum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data west of this longitude will be returned. Note that -80 -is less than -70.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        pandas DataFrame or an AQSAPI_V2 object

        Returns a table of monitors from a latitude/longitude bounding -box (_by_box).

        -
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bybox.bybox.quarterlysummary(parameter, bdate, edate, minlat, maxlat, minlon, maxlon, cbdate=None, cedate=None, duration=None, return_header=False)
        -

        Return a DataFrame of quarterly data aggregate by latitude/longitude -bounding box (_by_box).

        -

        Quarterly summary contains a DataFrame matching the input parameter, -stateFIPS and county_code provided for bdate - edate time frame. -Variables returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character string which represents the parameter code of the

        air pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        minlata python character object which represents the minimum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data north of this latitude will be returned.

        -
        -
        maxlata python character object which represents the maximum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data south of this latitude will be returned.

        -
        -
        minlona python character object which represents the minimum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data east of this longitude will be returned.

        -
        -
        maxlona python character object which represents the maximum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data west of this longitude will be returned. Note that -80 -is less than -70.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): daily summary data for all
        -
        monitors within the input latitude/longitude bounding box for a single
        -
        parameter.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bybox.bybox.sampledata(parameter, bdate, edate, minlat, maxlat, minlon, maxlon, cbdate=None, cedate=None, duration=None, return_header=False)
        -

        Return sample data where the data is aggregated by latitude/longitude -bounding box (_by_box).

        -

        If return_header is FALSE (default) this function -returns a single DataFrame with the requested data. If return_header is -TRUE returns a list of AQSAPI_v2 objects

        -
        -
        Parameters:
        -
        -
        parametera character string which represents the parameter code of the

        air pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        minlata python character object which represents the minimum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data north of this latitude will be returned.

        -
        -
        maxlata python character object which represents the maximum latitude

        of a geographic box. Decimal latitude with north begin positive. -Only data south of this latitude will be returned.

        -
        -
        minlona python character object which represents the minimum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data east of this longitude will be returned.

        -
        -
        maxlona python character object which represents the maximum longitude

        of a geographic box. Decimal longitude with east begin positive. -Only data west of this longitude will be returned. Note that -80 -is less than -70.

        -
        -
        durationan optional python character string that represents the

        parameter duration code that limits returned data to a -specific sample duration. The default value of None results -in no filtering based on duration code.Valid durations -include actual sample durations and not calculated durations -such as 8 hour carbon monoxide or ozone rolling averages, -3/6 day PM averages or lead 3 month rolling averages. Use -aqs_sampledurations() for a list of all available -duration codes.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        -
        - -
        -
        -

        pyaqsapi.bycbsa.bycbsa module

        -

        Functions that aggregate data by cbsa -(by Core Based Statistic Area, as defined by the Census Bureau).

        -
        -
        -pyaqsapi.bycbsa.bycbsa.annualsummary(parameter, bdate, edate, cbsa_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of annual data aggregated at the Core Based -Statistical Area (cbsa) level.

        -

        Annual summary contains a DataFrame matching the input parameter and -cbsa_code provided for bdate - edate time frame. Variables returned include -mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        cbsa_code: a python character object which represents the 5 digit AQS Core

        Based Statistical Area code (the same as the census code, with -leading zeros)

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): a DataFrame or an
        -
        AQS_Data Mart_APIv2 object that containing annual summary data for the
        -
        cbsa_code requested.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycbsa.bycbsa.dailysummary(parameter, bdate, edate, cbsa_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of data aggregated by Core Based Statistical Area -(cbsa).

        -

        Daily summary contains a DataFrame matching the input parameter and -cbsa_code provided for bdate - edate time frame. Variables -returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        cbsa_code: a python character object which represents the 5 digit AQS Core

        Based Statistical Area code (the same as the census code, with -leading zeros)

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): a DataFrame or an
        -
        AQS_Data Mart_APIv2 object that containing daily summary data for
        -
        the cbsa_code requested.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycbsa.bycbsa.monitors(parameter, bdate, edate, cbsa_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of monitors.

        -

        Return a table of monitors at all sites with the provided parameter, -aggregated by Core Based Statistical Area (CBSA) for bdate - edate -time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        cbsa_code: a python character object which represents the 5 digit AQS Core

        Based Statistical Area code (the same as the census code, with -leading zeros)

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance flow rate
        -
        verification data for monitors at a site.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycbsa.bycbsa.quarterlysummary(parameter, bdate, edate, cbsa_code, cbdate=None, cedate=None, return_header=False)
        -

        Return quarterly summary data aggregated by Core Based Statistical Area -(cbsa_code).

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        cbsa_code: a python character object which represents the 5 digit AQS Core

        Based Statistical Area code (the same as the census code, with -leading zeros).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        Example
        -
        -------
        -
        Return a DataFrame of NO2 quarterly summary
        -
        data the for Charlotte-Concord-Gastonia, NC cbsa for
        -
        each quarter in 2017.::

        import pyaqsapi as aqs -from datetime import date -... -aqs.bycbsa.quarterlysummary(parameter="42602",

        -
        -

        bdate=date(year=2017, month=1, day=1), -edate=date(year=2017, month=1, day=1), -cbsa_code="16740")

        -
        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quarterly summary statistics for
        -
        the given parameter for a all monitors with matching parameter and
        -
        cbsa_code combination within the bdate - edate timeframe.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycbsa.bycbsa.sampledata(parameter, bdate, edate, cbsa_code, duration=None, cbdate=None, cedate=None, return_header=False)
        -

        Return sample data where the data is aggregated at the Core Based -Statistical Area (cbsa) level.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        cbsa_code: a python character object which represents the 5 digit AQS Core

        Based Statistical Area code (the same as the census code, with -leading zeros)

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        durationan optional python character string that represents the

        parameter duration code that limits returned data to a specific -sample duration. The default value of None results in -no filtering based on duration code.Valid durations include -actual sample durations and not calculated durations such as 8 -hour carbon monoxide or ozone rolling averages, 3/6 day PM -averages or lead 3 month rolling averages. Use -aqs_sampledurations() for a list of all available -duration codes.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): sample data for all monitors
        -
        matching cbsa_code for the given parameter.
        -
        -
        -
        -
        - -
        -
        -

        pyaqsapi.bycounty.bycounty module

        -

        Functions that aggregate data by county.

        -
        -
        -pyaqsapi.bycounty.bycounty.annualsummary(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of annual data aggregated at the county level.

        -

        Annual summary contains a DataFrame matching the input parameter, -stateFIPS and county_code provided for bdate - edate time frame. -Variables returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        Example
        -
        -------
        -
        Returns all FRM/FEM PM2.5 data for Wake County, NC between
        -
        January 1, 2015 - February 28, 2016::

        import pyaqsapi as aqs -from datetime import date -... -aqs.bycounty.annualsummary(parameter="88101",

        -
        -
        -
        bdate=date(year=2016,

        month=1, -day=1),

        -
        -
        edate=date(year=2016,

        month=2, -day=28),

        -
        -
        -

        stateFIPS="37", -countycode="183", -return_header=True)

        -
        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): annual summary data for the
        -
        requested stateFIPS and county combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.dailysummary(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of data aggregated at the county level.

        -

        Daily summary contains a DataFrame matching the input parameter, stateFIPS -and county_code provided for bdate - edate time frame. Variables -returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): blank quality assurance data for
        -
        the requested stateFIPS and county combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.monitors(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of monitors.

        -

        Return a table of monitors and related metadata at sites with the provided -parameter, stateFIPS and county_code for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): monitors from
        -
        the selected stateFIPS and county combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_annualperformanceeval(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return quality assurance performance evaluation data - aggregated by -site for a parameter code aggregated by matching input -parameter, stateFIPS and countycode provided for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data for all monitoring sites for the
        -
        matching countycode and stateFIPS requested for the time frame
        -
        between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_annualperformanceevaltransaction(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Returns AQS submissions transaction format (RD) of the annual -performance evaluation data (raw). Includes data pairs for -QA - aggregated by county for a parameter code aggregated by matching -input parameter, countycode and stateFIPS provided for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data. for all monitoring sites with matching
        -
        countycode and stateFIPS requested for the time frame
        -
        between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_blanks(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of blank quality assurance data. -Blanks are unexposed sample collection devices (e.g., -filters) that are transported with the exposed sample devices -to assess if contamination is occurring during the transport -or handling of the samples. Data is aggregated at the county level.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): blank quality assurance data for
        -
        the requested stateFIPS and county combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_collocated_assessments(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of collocated assessment data aggregated by matching input -parameter, stateFIPS and county_code provided for bdate - edate time -frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        collocated assessment data for monitors within a county.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_flowrateaudit(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return Quality assurance flowrate audit data.

        -

        Return a table containing flow rate audit data aggregated by parameter -code, stateFIPS and countycode for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): flow rate audit data for the
        -
        requested stateFIPS and county combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_flowrateverification(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a table containing flow rate Verification data for a parameter code -aggregated matching input parameter, stateFIPS, and county_code, provided -for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance flow rate
        -
        verification data for monitors within a county.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_one_point_qc(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a table containing flow rate audit data aggregated by parameter -code, stateFIPS and countycode for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): flow rate audit data for the
        -
        requested stateFIPS and county combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.qa_pep_audit(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a table containing quality assurance Performance Evaluation Program -(PEP) audit data aggregated by parameter code, stateFIPS and countycode for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance Performance
        -
        Evaluation Program (PEP) audit data for the requested stateFIPS and county
        -
        combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.quarterlysummary(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of quarterly data aggregated at the county level.

        -

        Quarterly summary contains a DataFrame matching the input parameter, -stateFIPS and county_code provided for bdate - edate time frame. -Variables returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quarterly summary statistics for
        -
        the given parameter for a single countycode and stateFIPS combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.sampledata(parameter, bdate, edate, stateFIPS, countycode, duration=None, cbdate=None, cedate=None, return_header=False)
        -

        Returns sample data where the data is aggregated at the county level.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        durationan optional python character string that represents the

        parameter duration code that limits returned data to a specific -sample duration. The default value of None results in -no filtering based on duration code.Valid durations include -actual sample durations and not calculated durations such as 8 -hour carbon monoxide or ozone rolling averages, 3/6 day PM -averages or lead 3 month rolling averages. Use -aqs_sampledurations() for a list of all available -duration codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        durationan optional python character string that represents the

        parameter duration code that limits returned data to a -specific sample duration. The default value of None results -in no filtering based on duration code.Valid durations -include actual sample durations and not calculated durations -such as 8 hour carbon monoxide or ozone rolling averages, -3/6 day PM averages or lead 3 month rolling averages. Use -aqs_sampledurations() for a list of all available -duration codes.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance Performance
        -
        Evaluation Program (PEP) audit data for the requested stateFIPS and county
        -
        combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bycounty.bycounty.transactionsample(parameter, bdate, edate, stateFIPS, countycode, cbdate=None, cedate=None, return_header=False)
        -

        Return transactionsample data - aggregated by county in the AQS Submission -Transaction Format (RD) sample (raw) data for a parameter code aggregated -by matching input parameter, stateFIPS and countycode provided for -bdate - edate time frame. Includes data both in submitted and -standard units.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): transaction sample (raw) data
        -
        in the AQS submission transaction format (RD) corresponding to the inputs
        -
        provided.
        -
        -
        -
        -
        - -
        -
        -

        pyaqsapi.byma.byma module

        -

        Functions that aggregate data by ma (By Monitoring Agency).

        -
        -
        -pyaqsapi.byma.byma.qa_annualpeferomanceeval(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Returns quality assurance performance evaluation data - aggregated by -by Monitoring agency (MA) for a parameter code aggregated by matching input -parameter and MA_code for the time frame between bdate and edate.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance performance
        -
        evaluation data. for all monitoring sites for with the MA_code requested
        -
        for the time frame between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.qa_annualperformanceevaltransaction(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Returns AQS submissions transaction format (RD) of the annual performance -evaluation data (raw). Includes data pairs for QA - aggregated by -Monitoring agency (MA) for a parameter code aggregated by matching input -parameter and MA_code provided for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance performance
        -
        evaluation data in the AQS submissions transaction format (RD)for all sites
        -
        matching the MA_code requested for the time frame between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.qa_blanks(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of blank quality assurance data. Blanks are unexposed -sample collection devices (e.g., filters) that are transported with the -exposed sample devices to assess if contamination is occurring during the -transport or handling of the samples. Data is aggregated by monitoring -agency code (MA_code).

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance blank sample
        -
        data for all monitors within the input MA_code.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.qa_collocated_assessments(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of collocated assessment data aggregated by matching input -parameter, and monitoring agency (MA) code provided for bdate - edate -time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance collocated
        -
        assessment data for monitors within a monitoring agency.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.qa_flowrateaudit(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Return Quality assurance flowrate audit data.

        -

        Return a table containing flow rate audit data aggregated by parameter -code and monitoring agency code (_by_MA) for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): flow rate audit data for the
        -
        requested MA_code.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.qa_flowrateverification(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table containing flow rate Verification data for a parameter code -aggregated by matching input parameter, and monitoring agency (MA) code -provided for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): flow rate audit data for the
        -
        requested MA_code.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.qa_one_point_qc(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table one point QC check data aggregated by monitoring agency -code (_by_MA).

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): flow rate audit data for the
        -
        requested MA_code.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.qa_pep_audit(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of Performance Evaluation Program (PEP) audit data -aggregated by monitoring agency code (_by_MA) for the time frame between -bdate and edate.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance PEP audit data
        -
        for a monitoring agency.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.byma.byma.transactionsample(parameter, bdate, edate, MA_code, cbdate=None, cedate=None, return_header=False)
        -

        Return transactionsample data - aggregated by Monitoring agency (MA) in -the AQS Submission Transaction Format (RD) sample (raw) data for a -parameter code aggregated by matching input parameter, and monitoring -agency (MA) code provided for bdate - edate time frame. Includes data both -in submitted and standard units.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        MA_codea python character object which represents the 4 digit AQS

        Monitoring Agency code (with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): transaction sample (raw) data in
        -
        the AQS submission transaction format (RD) corresponding to the inputs
        -
        provided.
        -
        -
        -
        -
        - -
        -
        -

        pyaqsapi.bypqao.bypqao module

        -

        Functions that aggregate data by pqao -(By Primary Quality Assurance Organization).

        -
        -
        -pyaqsapi.bypqao.bypqao.qa_annualperformanceeval(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Return quality assurance performance evaluation data - aggregated by -Primary Quality Assurance Organization (PQAO) for a parameter -code aggregated by matching input parameter and pqao_code for the -time frame between bdate and edate.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data. for single monitoring site for the
        -
        pqao_code requested for the time frame between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bypqao.bypqao.qa_annualperformanceevaltransaction(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Returns AQS submissions transaction format (RD) of the annual -performance evaluation data (raw). Includes data pairs for -QA - aggregated by Primary Quality Assurance Organization (PQAO) -for a parameter code aggregated by matching input parameter and -pqao_code provided for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data. for single monitoring site for the
        -
        sitenum, countycode and stateFIPS requested for the time frame
        -
        between bdate and edate
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bypqao.bypqao.qa_blanks(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of blank quality assurance data. Blanks are unexposed -sample collection devices (e.g., filters) that are transported with the -exposed sample devices to assess if contamination is occurring during the -transport or handling of the samples. Data is aggregated by Primary Quality -Assurance Organization (PQAO).

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance blank data
        -
        for monitors within a pqao.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bypqao.bypqao.qa_collocated_assessments(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of blank quality assurance data. Blanks are unexposed -sample collection devices (e.g., filters) that are transported with the -exposed sample devices to assess if contamination is occurring during the -transport or handling of the samples. Data is aggregated by Primary Quality -Assurance Organization (PQAO).

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance blank data
        -
        for monitors within a pqao.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bypqao.bypqao.qa_flowrateaudit(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Return Quality assurance flowrate audit data.

        -

        Return quality assurance flow rate audit data aggregated by parameter code -and Primary Quality Assurance Organization (PQAO) code for bdate - edate -time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): flow rate audit data for the
        -
        requested pqao_code.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bypqao.bypqao.qa_flowrateverification(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table containing flow rate Verification data for a parameter code -aggregated by matching input parameter, and Primary Quality Assurance -Organization (PQAO) code provided for bdate - edate time.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance flow rate
        -
        verification data for monitors within a pqao.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bypqao.bypqao.qa_one_point_qc(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Return Quality assurance data - collocated assessment raw data aggregated -by Primary Quality Assurance Organization (PQAO) code.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): one point qc data within a pqao
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bypqao.bypqao.qa_pep_audit(parameter, bdate, edate, pqao_code, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of Performance Evaluation Program (PEP) audit data -aggregated by Primary Quality Assurance Organization (PQAO) code for the -time frame between bdate and edate.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        pqao_codea python character object which represents the 4 digit AQS

        Primary Quality Assurance Organization code -(with leading zeroes).

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance PEP audit data
        -
        for a Primary Quality Assurance Organization.
        -
        -
        -
        -
        - -
        -
        -

        pyaqsapi.bysite.bysite module

        -

        pyaqsapi Functions that aggregate data by site.

        -
        -
        -pyaqsapi.bysite.bysite.annualsummary(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of annual data aggregated at the site level.

        -

        Annual summary contains a DataFrame matching the input parameter, -stateFIPS, county_code, and sitenum provided for bdate - edate time frame. -Variables returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): annual summary data for the
        -
        sitenum, countycode and stateFIPS requested for the time frame between
        -
        bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.dailysummary(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of data aggregated at the site level.

        -

        Daily summary contains a DataFrame matching the input parameter, stateFIPS, -county_code, and sitenum provided for bdate - edate time frame. Variables -returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): daily summary data for the
        -
        sitenum, countycode and stateFIPS requested for the time frame between
        -
        bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.monitors(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of monitors.

        -
        -
        Return a table of monitors and related metadata at sites

        with the provided parameter, stateFIPS, county_code, and sitenum -for bdate - edate time frame.

        -
        -
        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): monitors from
        -
        the selected site.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_annualpeferomanceeval(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return quality assurance performance evaluation data - aggregated by -site for a parameter code aggregated by matching input -parameter, sitenum, countycode and stateFIPS provided for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data. for single monitoring site for the
        -
        sitenum, countycode and stateFIPS requested for the time frame
        -
        between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_annualperformanceevaltransaction(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Returns AQS submissions transaction format (RD) of the annual -performance evaluation data (raw). Includes data pairs for -QA - aggregated by site for a parameter code aggregated by matching -input parameter, sitenum, countycode and stateFIPS provided for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data. for single monitoring site for the
        -
        sitenum, countycode and stateFIPS requested for the time frame
        -
        between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_blanks(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of blank quality assurance data. -Blanks are unexposed sample collection devices (e.g., -filters) that are transported with the exposed sample devices -to assess if contamination is occurring during the transport -or handling of the samples. Data is aggregated at the site level.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE
        -
        returns a AQSAPI_v2 object.
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance blank
        -
        sample data for single monitoring site for the sitenum, countycode and
        -
        stateFIPS requested for the time frame between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_collocated_assessments(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of collocated assessment data aggregated by matching -input parameter, stateFIPS, county_code, and sitenum provided for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance collocated
        -
        assessment data for monitors within a site.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_flowrateaudit(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return Quality assurance flowrate audit data.

        -

        Return a table containing flow rate audit data aggregated by -parameter code, stateFIPS, countycode and site number for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): flow rate audit data
        -
        for the requested sitenum, countycode and stateFIPS for the time
        -
        period between bdate - edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_flowrateverification(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of containing flow rate verification data aggregated by -matching input parameter, stateFIPS, county_code, and sitenum provided for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance flow rate
        -
        verification data for monitors at a site.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_one_point_qc(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of one point QC raw data aggregated -by parameter code, stateFIPS, countycode and site number.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): for the requested sitenum,
        -
        countycode and stateFIPS for the time period between bdate - edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.qa_pep_audit(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of Performance Evaluation Program (PEP) audit -data aggregated by parameter code, stateFIPS, countycode and -site number for the time frame between bdate and edate.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        PEP audit data within a stateFIPS, countycode and sitenum
        -
        for the time frame between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.quarterlysummary(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of quarterly data aggregated at the site level.

        -

        Quarterly summary contains a DataFrame matching the input parameter, -stateFIPS, county_code, and sitenum provided for bdate - edate time frame. -Variables returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quarterly summary statistics for
        -
        the given parameter for a single countycode and stateFIPS combination.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.sampledata(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, duration=None, return_header=False)
        -

        Returns sample data where the data is aggregated at the site level.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        durationan optional python character string that represents the

        parameter duration code that limits returned data to a -specific sample duration. The default value of None results -in no filtering based on duration code.Valid durations -include actual sample durations and not calculated durations -such as 8 hour carbon monoxide or ozone rolling averages, -3/6 day PM averages or lead 3 month rolling averages. Use -aqs_sampledurations() for a list of all available -duration codes.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): sample data aggregated at the
        -
        site level matching the input stateFIPS, countycode and sitenum
        -
        for the time frame between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bysite.bysite.transactionsample(parameter, bdate, edate, stateFIPS, countycode, sitenum, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of Returns transactionsample data aggregated by site -in the AQS Submission Transaction Format (RD) sample (raw) data aggregated -by matching input parameter, stateFIPS, county_code, and sitenum provided -for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        sitenuma python character object which represents the 4 digit site

        number (with leading zeros) within the county and state -being requested.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): transaction sample
        -
        (raw) data in the AQS submission transaction format (RD)
        -
        corresponding to the inputs provided.
        -
        -
        -
        -
        - -
        -
        -

        pyaqsapi.bystate.bystate module

        -

        Functions that aggregated data by state.

        -
        -
        -pyaqsapi.bystate.bystate.annualsummary(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of annual data aggregated at the state level.

        -

        Annual summary contains a DataFrame matching the input parameter and -stateFIPS provided for bdate - edate time frame. Variables returned include -mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): annual summary data for the
        -
        stateFIPS requested.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.dailysummary(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of data aggregated at the state level.

        -

        Daily summary contains a DataFrame matching the input parameter and -stateFIPS provided for bdate - edate time frame. Variables -returned include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): daily summary statistics for the
        -
        given parameter for a single stateFIPS.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.monitors(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of monitors.

        -

        Return a table of monitors and related metadata at all sites -with the provided parameter and stateFIPS for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): monitors from the

        selected state.

        -
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_annualperformanceeval(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return quality assurance performance evaluation data - aggregated by -site for a parameter code aggregated by matching input -parameter, and stateFIPS provided for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data for all monitoring sites for the
        -
        matching parameter and stateFIPS requested for the time frame
        -
        between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_annualperformanceevaltransaction(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return AQS submissions transaction format (RD) of the annual -performance evaluation data (raw). Includes data pairs for -QA - aggregated by county for a parameter code aggregated by matching -input parameter and stateFIPS provided for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance
        -
        performance evaluation data. for all monitoring sites with matching
        -
        parameter and stateFIPS requested for the time frame
        -
        between bdate and edate.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_blanks(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of blank quality assurance data. Blanks are unexposed -sample collection devices (e.g., filters) that are transported with the -exposed sample devices to assess if contamination is occurring during -the transport or handling of the samples. Data is aggregated at the state -level.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance blank sample
        -
        data for all monitors within the input stateFIPS.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_collocated_assessments(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of collocated assessment data aggregated by matching input -parameter and stateFIPS provided for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance collocated
        -
        assessment data for monitors within a state.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_flowrateaudit(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return Quality assurance flowrate audit data.

        -

        Return a table of monitors and related metadata at all sites -with the provided parameter and stateFIPS for bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): monitors from the

        selected state.

        -
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_flowrateverification(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a table containing flow rate Verification data for a parameter code -aggregated matching input parameter, and stateFIPS, provided for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance flow rate
        -
        verification data for monitors within a state.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_one_point_qc(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame or an AQS_Data Mart_APIv2 S3 object containing Quality -assurance data - flow rate audit raw data aggregated by state FIPS for -bdate - edate time frame.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): one point qc data within the
        -
        input stateFIPS for bdate - edate time frame..
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.qa_pep_audit(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a table of Performance Evaluation Program (PEP) audit data -aggregated by parameter code, and stateFIPS for the time frame between -bdate and edate.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quality assurance PEP audit data
        -
        within a state.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.quarterlysummary(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return a DataFrame of quarterly data aggregated at the state level.

        -

        Quarterly summary contains a DataFrame matching the input parameter, -stateFIPS a provided for bdate - edate time frame. Variables returned -include mean value, maxima, percentiles, and etc.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): quarterly summary statistics for
        -
        the given parameter for a all monitors with matching parameter and
        -
        stateFIPS combination within the bdate - edate timeframe.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.sampledata(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, duration=None, return_header=False)
        -

        Return sample data where the data is aggregated at the state level.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        durationan optional python character string that represents the

        parameter duration code that limits returned data to a -specific sample duration. The default value of None results -in no filtering based on duration code.Valid durations -include actual sample durations and not calculated durations -such as 8 hour carbon monoxide or ozone rolling averages, -3/6 day PM averages or lead 3 month rolling averages. Use -aqs_sampledurations() for a list of all available -duration codes.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): containing sample data
        -
        for all monitors matching stateFIPS for the given parameter.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.bystate.bystate.transactionsample(parameter, bdate, edate, stateFIPS, cbdate=None, cedate=None, return_header=False)
        -

        Return transactionsample data - aggregated by state in the AQS Submission -Transaction Format (RD) sample (raw) data for a parameter code aggregated -by matching input parameter, and stateFIPS provided for bdate - edate time -frame. Includes data both in submitted and standard units.

        -
        -
        Parameters:
        -
        -
        parametera character list or a single character string

        which represents the parameter code of the air -pollutant related to the data being requested.

        -
        -
        bdatea python date object which represents that begin date of the data

        selection. Only data on or after this date will be returned.

        -
        -
        edatea python date object which represents that end date of the data

        selection. Only data on or before this date will be returned.

        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        cbdatea python 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.

        -
        -
        cedatea python 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 optional variable which defaults -to None.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): transaction sample (raw) data
        -
        in the AQS submission transaction format (RD) corresponding to the inputs
        -
        provided.
        -
        -
        -
        -
        - -
        -
        -

        pyaqsapi.helperfunctions module

        -

        helperfunctions.

        -
        -
        -class pyaqsapi.helperfunctions.AQSAPI_V2
        -

        Bases: object

        -
        -

        AQSAPI_V2 class used to store and retrieve data from the EPA AQS -Datamart API.

        -
        -

        # for some reason Sphinx does not like this Attributes section so it is -# commented out, for now.

        -

        # Attributes -# ---------- -# _header (pandas DataFrame): header information returned from the -# AQS Datamart API. -# _request_time (str): the time stamp that the call to the AQS Datamart -# API was received. -# _status (str): the status (associated with the _status_code) returned -# from a call to the AQS Datamart API. -# _status_code (str): the numeric status_code (represented as a string) -# that is returned from a call to the AQS Datamart API. -# _rows (str): the number of rows contained in the _data. -# _url (str): a string representing the URL used to make the AQS Datamart -# API call. -# _data (pandas DataFrame): the data returned from a call to the -# AQS Datamart API.

        -
        -
        -

        Methods

        - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

        set_data():

        set_header():

        get_data():

        get_header():

        get_status_code():

        get_header():

        get_url():

        get_header():

        get_request_time():

        -
        -
        -get_data()
        -

        Return the Data portion of the AQSAPI_V2 instance.

        -
        -
        Returns:
        -
        -
        (pandas DataFrame) a DataFrame containing the Data portion of the
        -
        AQSAPI_V2 instance.
        -
        -
        -
        -
        - -
        -
        -get_header()
        -

        Return the Header portion of the AQSAPI_V2 instance.

        -
        -
        Returns:
        -
        -
        (pandas DataFrame) a DataFrame containing the Header portion of the
        -
        AQSAPI_V2 instance.
        -
        -
        -
        -
        - -
        -
        -get_request_time()
        -

        Retrieve the time that the request to the AQS DataMart API was made.

        -
        -
        Returns:
        -
        -
        (str) A string representing the time that that request to the AQS
        -
        DataMart API was made.
        -
        -
        -
        -
        - -
        -
        -get_status_code()
        -

        Retrieve the status code from the API call.

        -
        -
        Returns:
        -
        -
        (str) A string representing the status code returned from the EPA
        -
        DataMart API.
        -
        -
        -
        -
        - -
        -
        -get_url()
        -

        Retrieve the URL of the AQS DataMart API request.

        -
        -
        Returns:
        -
        -
        (str) A string representing the status code returned from the EPA
        -
        DataMart API.
        -
        -
        -
        -
        - -
        -
        -set_data(Data)
        -

        Set the Data of a single AQSAPI_V2 object.

        -

        Data must be a pandas DataFrame.

        -
        -
        Warns:
        -
        -
        A warning is thrown if Data is not a pandas DataFrame
        -
        -
        -
        -
        - -
        -
        -set_header(Header)
        -

        Set the header of a single AQSAPI_V2 object. Header must be a -pandas DataFrame.

        -
        -
        Parameters:
        -
        -
        HeaderPandas DataFrame

        A pandas.DataFrame instance with the header information.

        -
        -
        -
        -
        Returns:
        -
        -
        None.
        -
        -
        -
        Warns:
        -
        -
        A warning is thrown if Header is not a pandas DataFrame
        -
        -
        -
        -
        - -
        - -
        -
        -pyaqsapi.helperfunctions.aqs_credentials(username=None, key=None)
        -

        Sets the user credentials for the AQS API. This function -needs to be called once and only once every time this library -is re-loaded. Users must have a valid username and key which -can be obtained through the use of the aqs_sign_up function, -use pyaqsapi.aqs_sign_up() to sign up for AQS data mart credentials.

        -
        -
        Parameters:
        -
        -
        usernamea python character object which represents the email account

        that will be used to connect to the AQS API.

        -
        -
        keythe key used in conjunction with the username given to connect to

        AQS Data Mart.

        -
        -
        -
        -
        Returns:
        -
        -
        None
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.helperfunctions.aqs_removeheader(aqsobject)
        -

        Coerces a single AQS_Data_Mart_APIv2 instance or a list of -AQS_Data_Mart_APIv2 instance into a single DataFrame object. -This function decouples the Data from the AQSAPI_v2 object and returns -only the Data portion as a DataFrame. If the input is a list of AQSAPI_v2 -objects combines the Data portion of each AQS_Data_Mart_APIv2 object -into a DataFrame with Header information discarded. -Else returns the input with no changes.

        -
        -
        Parameters:
        -
        -
        aqsobjectAn object of AQSAPI_v2 or a list of AQSAPI_v2 objects.
        -
        -
        -
        Returns:
        -
        -
        (DataFrame) A DataFrame containing the data portion of the AQSAPI_V2
        -
        object.
        -
        -
        -
        -
        - -
        -
        -

        pyaqsapi.listfunctions module

        -

        listfunctions.

        -
        -
        -pyaqsapi.listfunctions.aqs_cbsas(return_header=False)
        -

        Return a table of all Core Based Statistical Areas (cbsa) and their -associated cbsa_codes.

        -
        -
        Parameters:
        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): all cbsas and their associated
        -
        cbsa_codes.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.listfunctions.aqs_classes(return_header=False)
        -

        Return a table of Parameter classes (groups of parameters, i.e. "criteria" -or "all"). The information from this function can be used as input to other -API calls.

        -
        -
        Parameters:
        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): Parameter classes (groups of
        -
        parameters, i.e. "criteria" or "all").
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.listfunctions.aqs_counties_by_state(stateFIPS, return_header=False)
        -

        Return a table of all counties in within the stateFIPS provided.

        -
        -
        Parameters:
        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): all counties in the requested
        -
        state.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.listfunctions.aqs_fields_by_service(service, return_header=False)
        -
        -
        Return a table containing the list and definitions of fields in the

        service requested.

        -
        -
        -
        -
        Parameters:
        -
        -
        servicea string which represents the services provided by the AQS

        API. For a list of available services refer to -https://aqs.epa.gov/aqsweb/documents/data_api.html#services

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): details the status of the AQS

        API.

        -
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.listfunctions.aqs_isavailable(return_header=False)
        -

        Return a table explaining the status of the AQS API.

        -
        -
        Parameters:
        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): details the status of the AQS

        API.

        -
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.listfunctions.aqs_knownissues(return_header=False)
        -

        Return a table of any known issues with system functionality or the data. -These are usually issues that have been identified internally and will -require some time to correct in Data Mart or the API. This function -implements a direct API call to Data Mart and returns data directly from -the API. Issues returned via this function do not include any issues from -the pyaqsapi python package.

        -
        -
        Parameters:
        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): information involving known
        -
        issues with the Data Mart API.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.listfunctions.aqs_mas(return_header=False)
        -

        Return a DataFrame of monitoring agencies (MA).

        -
        -
        Parameters:
        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): monitoring agencies and their
        -
        associated agency code.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.listfunctions.aqs_parameters_by_class(parameterclass, return_header=False)
        -

        Return a table of Parameter classes (groups of parameters, i.e. "criteria" -or "all"). The information from this function can be used as input to other -API calls.

        -
        -
        Parameters:
        -
        -
        parameterclass: a python character object that represents the class

        requested, use aqs_classes() for retrieving available -classes. The parameterclass python character object must be -a valid parameterclass as returned from aqs_classes(). -The class must be an exact match to what is returned from -aqs_classes().

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): parameters associated with the
        -
        parameterclass requested. None is returned for parameterclasses not found.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.listfunctions.aqs_pqaos(return_header=False)
        -

        Return a table of primary quality assurance organizations (pqaos).

        -
        -
        Parameters:
        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): pqaos and their associated
        -
        pqao_codes.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.listfunctions.aqs_revisionhistory(return_header=False)
        -

        Return a table Returns that contains change history to the AQS Data Mart -API.

        -
        -
        Parameters:
        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): details change history to the
        -
        AQS Data Mart API.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.listfunctions.aqs_sampledurations(return_header=False)
        -

        Return a table of sample durations and their associated duration codes. -Returned values are not calculated durations such as 8 hour carbon monoxide -or ozone rolling averages, 3/6 day PM averages or Pb 3 month rolling -averages.

        -
        -
        Parameters:
        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): sample durations and
        -
        their associated duration codes
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.listfunctions.aqs_sites_by_county(stateFIPS, countycode, return_header=False)
        -

        Return data containing a table of all air monitoring sites with the input -state and county FIPS code combination.

        -
        -
        Parameters:
        -
        -
        stateFIPSa python character object which represents the 2 digit

        state FIPS code (with leading zero) for the state being -requested. Use aqs_states() for the list of available -FIPS codes.

        -
        -
        countycodea python character object which represents the 3 digit

        state FIPS code for the county being requested -(with leading zero(s)). Use aqs_counties_by_state() for -the list of available county codes for each state.

        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): all air monitoring sites with
        -
        the requested state and county FIPS codes.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.listfunctions.aqs_states(return_header=False)
        -

        Return a table of US states, US territories, and the district or Columbia -with their respective FIPS codes.

        -
        -
        Parameters:
        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): states and their associated FIPS
        -
        code.
        -
        -
        -
        -
        - -
        -
        -

        pyaqsapi.metadatafunctions module

        -

        metadatafunctions.

        -
        -
        -pyaqsapi.metadatafunctions.aqs_is_available(return_header=False)
        -

        Return the status of the AQS API.

        -
        -
        Parameters:
        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): Details the status of the
        -
        AQS API (The status information is located in the header).
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.metadatafunctions.aqs_knownissues(return_header=False)
        -

        Return a table of any known issues with system functionality or the data. -These are usually issues that have been identified internally and will -require some time to correct in Data Mart or the API. This function -implements a direct API call to Data Mart and returns data directly from -the API. Issues returned via this function do not include any issues from -the pyaqsapi python package.

        -
        -
        Parameters:
        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): Information involving known
        -
        issues with the Data Mart API.
        -
        -
        -
        -
        - -
        -
        -pyaqsapi.metadatafunctions.aqs_revisionhistory(return_header=False)
        -

        Return the change history to the AQS Data Mart API.

        -
        -
        Parameters:
        -
        -
        return_headerIf FALSE (default) only returns data requested. If TRUE

        returns a AQSAPI_v2 object.

        -
        -
        -
        -
        Returns:
        -
        -
        (pandas DataFrame or an AQSAPI_V2 object): Information on the revision
        -
        history to the AQS Datamart API.
        -
        -
        -
        -
        - -
        -
        -

        pyaqsapi.setupfunctions module

        -

        setupfunctions.

        -
        -
        -pyaqsapi.setupfunctions.aqs_sign_up(email)
        -

        Use this service to register as a new user or to reset an existing user's -key. A verification email will be sent to the email account specified. To -reset a password: If the request is made with an email that is already -registered, a new key will be issued for that account and emailed to the -listed address. Usage is the same in either case. Refer to the email -message for further instructions before continuing.

        -
        -
        Parameters:
        -
        -
        emailA python 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 email will be sent to the account -specified. Follow the instructions in the verification e-mail -before proceeding to use any other functionality of the AQS API. -Register your credential with the aqs_credentials() before using -the other functions in this library.

        -
        -
        -
        -
        Returns:
        -
        -
        None.
        -
        -
        -
        -
        - -
        -
        -
        - - -
        -
        -
        - -
        - -
        -

        © 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/searchindex.js b/docs/_build/html/searchindex.js index 3ceed5b..1b0b66b 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", "pyaqsapi", "pyaqsapi.bybox", "pyaqsapi.bycbsa", "pyaqsapi.bycounty", "pyaqsapi.byma", "pyaqsapi.bypqao", "pyaqsapi.bysite", "pyaqsapi.bystate"], "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", "pyaqsapi.rst", "pyaqsapi.bybox.rst", "pyaqsapi.bycbsa.rst", "pyaqsapi.bycounty.rst", "pyaqsapi.byma.rst", "pyaqsapi.bypqao.rst", "pyaqsapi.bysite.rst", "pyaqsapi.bystate.rst"], "titles": ["pyaqsapi's documentation", "EPA Disclaimer", "Install pyaqsapi", "Introduction", "Load pyaqsapi", "About RAQSAPI", "About the timeliness of AQS Data", "Using pyaqsapi", "Data Mart aggregate functions", "pyaqsapi package", "pyaqsapi.bybox package", "pyaqsapi.bycbsa package", "pyaqsapi.bycounty package", "pyaqsapi.byma package", "pyaqsapi.bypqao package", "pyaqsapi.bysite package", "pyaqsapi.bystate package"], "terms": {"thi": [0, 1, 3, 7, 9, 10, 11, 12, 13, 14, 15, 16], "softwar": [0, 1], "applic": [0, 1], "wa": [0, 1, 4, 9, 11, 12, 13, 14, 15, 16], "develop": [0, 1], "u": [0, 1, 3, 7, 8, 9], "environment": [0, 1, 3, 7], "protect": [0, 1, 3, 7], "agenc": [0, 1, 3, 7, 8, 9, 13], "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, 12, 13, 14, 15, 16], "made": [0, 1, 9], "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, 10, 11, 12, 15, 16], "ha": [0, 1, 3], "relinquish": [0, 1], "control": [0, 1, 8], "inform": [0, 1, 3, 7, 9], "longer": [0, 1, 8], "respons": [0, 1], "integr": [0, 1], "confidenti": [0, 1], "avail": [0, 1, 3, 8, 9, 10, 11, 12, 15, 16], "specif": [0, 1, 9, 10, 11, 12, 15, 16], "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, 9], "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, 9, 12, 13, 16], "state": [0, 1, 3, 8, 9, 12, 15, 16], "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, 10, 11, 12, 15, 16], "certain": [0, 1], "mai": [0, 1, 7], "chang": [0, 1, 7, 9, 11, 12, 13, 14, 15, 16], "remov": [0, 1], "without": [0, 1, 7], "notic": [0, 1], "As": [0, 1], "result": [0, 1, 3, 8, 9, 10, 11, 12, 15, 16], "packag": [0, 1, 2, 3, 4, 5, 7], "also": [0, 1, 7], "reflect": [0, 1], "respect": [0, 1, 9], "improv": [0, 1], "design": [0, 1], "qualiti": [0, 1, 3, 7, 8, 9, 11, 12, 13, 14, 15, 16], "author": [0, 1], "assum": [0, 1], "liabil": [0, 1], "problem": [0, 1], "occur": [0, 1, 9, 12, 13, 14, 15, 16], "hardwar": [0, 1], "account": [0, 1, 7, 9], "modul": [0, 3, 7], "python": [0, 2, 3, 4, 5, 7, 9, 10, 11, 12, 13, 14, 15, 16], "3": [0, 3, 5, 7, 9, 10, 11, 12, 15, 16], "program": [0, 3, 5, 9, 12, 13, 14, 15, 16], "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, 10, 11, 12, 15, 16], "air": [0, 3, 7, 9, 10, 11, 12, 13, 14, 15, 16], "1": [0, 3, 6, 9, 11, 12], "directli": [0, 3, 9], "enabl": [0, 3], "omit": [0, 3], "legaci": [0, 3], "challeng": [0, 3], "includ": [0, 3, 9, 10, 11, 12, 13, 14, 15, 16], "coerc": [0, 3, 9], "json": [0, 3], "object": [0, 3, 7, 9, 10, 11, 12, 13, 14, 15, 16], "usabl": [0, 3], "multipl": [0, 3, 8], "year": [0, 3, 8, 9, 11, 12], "format": [0, 3, 8, 9, 12, 13, 14, 15, 16], "request": [0, 3, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "handl": [0, 3, 9, 12, 13, 14, 15, 16], "pollut": [0, 3, 9, 10, 11, 12, 13, 14, 15, 16], "rate": [0, 3, 8, 9, 11, 12, 13, 14, 15, 16], "limit": [0, 3, 9, 10, 11, 12, 15, 16], "all": [0, 3, 6, 7, 8, 9, 10, 11, 12, 13, 15, 16], "basic": [0, 3], "have": [0, 3, 5, 7, 9], "implement": [0, 3, 9], "ar": [0, 2, 3, 4, 5, 7, 8, 9, 12, 13, 14, 15, 16], "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, 9], "need": [0, 3, 6, 7, 9], "extern": [0, 3], "odbc": [0, 3], "driver": [0, 3], "configur": [0, 3], "deal": [0, 3], "secur": [0, 3], "vulner": [0, 3], "associ": [0, 3, 9], "them": [0, 3], "most": [0, 3, 5], "paramet": [0, 3, 5, 7, 9, 10, 11, 12, 13, 14, 15, 16], "return_head": [0, 3, 7, 9, 10, 11, 12, 13, 14, 15, 16], "which": [0, 3, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "default": [0, 3, 7, 9, 10, 11, 12, 13, 14, 15, 16], "fals": [0, 3, 7, 9, 10, 11, 12, 13, 14, 15, 16], "If": [0, 3, 6, 7, 9, 10, 11, 12, 13, 14, 15, 16], "decid": [0, 3], "true": [0, 3, 7, 9, 10, 11, 12, 13, 14, 15, 16], "return": [0, 3, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "aqs_datamart_apiv2": [0, 3], "an": [0, 3, 7, 9, 10, 11, 12, 13, 14, 15, 16], "instanc": [0, 3, 9], "method": [0, 3, 7, 9], "header": [0, 3, 7, 9], "other": [0, 3, 4, 5, 9], "metadata": [0, 3, 9, 10, 12, 15, 16], "relat": [0, 3, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "call": [0, 3, 7, 8, 9], "after": [0, 3, 7, 9, 10, 11, 12, 13, 14, 15, 16], "each": [0, 3, 5, 7, 8, 9, 11, 12, 15], "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], "host": [0, 6], "real": [0, 6], "time": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "collect": [0, 6, 9, 12, 13, 14, 15, 16], "now": [0, 6, 9], "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], "detail": [0, 6, 9], "see": [0, 6], "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, 11], "aim": [0, 5], "featur": [0, 5], "pariti": [0, 5], "neither": [0, 5], "project": [0, 2, 5, 7], "than": [0, 5, 9, 10], "languag": [0, 5], "prefer": [0, 5], "benefit": [0, 5], "one": [0, 5, 7, 8, 9, 13, 14, 15, 16], "over": [0, 5], "To": [0, 2, 9], "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, 9], "make": [0, 4, 8, 9], "sure": [0, 4], "virtual": [0, 4], "where": [0, 4, 8, 9, 10, 11, 12, 15, 16], "import": [0, 4, 9, 11, 12], "those": [0, 7], "who": [0, 7], "alreadi": [0, 7, 9], "should": [0, 7], "few": [0, 7], "minor": [0, 7], "differ": [0, 7, 8], "how": [0, 7, 8], "panda": [0, 7, 9, 10, 11, 12, 13, 14, 15, 16], "frame": [0, 7, 9, 10, 11, 12, 13, 14, 15, 16], "export": [0, 7], "when": [0, 7, 9, 11, 12, 13, 14, 15, 16], "simpli": [0, 7], "manual": [0, 7], "aqsapi_v2": [0, 7, 9, 10, 11, 12, 13, 14, 15, 16], "get_data": [0, 7, 9], "class": [0, 7, 9], "get_head": [0, 7, 9], "done": [0, 7], "aqs_sign_up": [0, 7, 9], "take": [0, 7, 8], "input": [0, 7, 9, 10, 11, 12, 13, 14, 15, 16], "email": [0, 7, 9], "charact": [0, 7, 9, 10, 11, 12, 13, 14, 15, 16], "repres": [0, 7, 9, 10, 11, 12, 13, 14, 15, 16], "address": [0, 7, 9], "want": [0, 7], "success": [0, 7], "messag": [0, 7, 9], "provid": [0, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "new": [0, 7, 9], "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, 12, 13, 14, 15, 16], "mail": [0, 7, 9], "given": [0, 7, 9, 11, 12, 15, 16], "store": [0, 7, 9], "global": [0, 7], "variabl": [0, 7, 9, 10, 11, 12, 13, 14, 15, 16], "everi": [0, 7, 9], "valid": [0, 7, 9, 10, 11, 12, 15, 16], "reject": [0, 7], "password": [0, 7, 9], "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, 11, 12, 15, 16], "suppli": [0, 7], "intend": [0, 7], "authent": [0, 7], "onli": [0, 7, 9, 10, 11, 12, 13, 14, 15, 16], "monitor": [0, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "befor": [0, 7, 9, 10, 11, 12, 13, 14, 15, 16], "aqs_credenti": [0, 7, 9], "enter": [0, 7], "both": [0, 7, 9, 12, 13, 16], "either": [0, 7, 8, 9], "note": [0, 7, 8, 9, 10], "howev": [0, 7], "sourc": [0, 7], "do": [0, 7, 9], "creat": [0, 7], "sinc": [0, 7], "ew": [0, 7], "restrict": [0, 8], "maximum": [0, 8, 9, 10], "amount": [0, 8], "full": [0, 8], "per": [0, 8], "These": [0, 8, 9], "abl": [0, 8], "repeat": [0, 8], "complet": [0, 8], "being": [0, 8, 9, 10, 11, 12, 13, 14, 15, 16], "group": [0, 8, 9], "There": [0, 8], "famili": [0, 8], "seven": [0, 8], "site": [0, 8, 9, 10, 11, 12, 13, 14, 15, 16], "bysit": [0, 8], "counti": [0, 8, 9, 12, 15, 16], "bycounti": [0, 8], "bystat": [0, 8], "latitud": [0, 8, 9, 10], "longitud": [0, 8, 9, 10], "bound": [0, 8, 9, 10], "box": [0, 8, 9, 10], "bybox": [0, 8], "byma": [0, 8], "primari": [0, 8, 9, 14], "assur": [0, 8, 9, 11, 12, 13, 14, 15, 16], "organ": [0, 8, 9, 14], "bypqao": [0, 8], "core": [0, 8, 9, 11], "base": [0, 8, 9, 10, 11, 12, 13, 14, 15, 16], "statist": [0, 8, 9, 11, 12, 15, 16], "area": [0, 8, 9, 10, 11], "defin": [0, 8, 9, 11], "censu": [0, 8, 9, 11], "bureau": [0, 8, 9, 11], "bycbsa": [0, 8], "within": [0, 8, 9, 10, 11, 12, 13, 14, 15, 16], "13": [0, 8], "thirteen": [0, 8], "sampl": [0, 8, 9, 10, 11, 12, 13, 14, 15, 16], "sampledata": [0, 8, 9, 10, 11, 12, 15, 16], "daili": [0, 8, 9, 10, 11, 12, 15, 16], "summari": [0, 8, 9, 10, 11, 12, 15, 16], "dailydata": [0, 8], "annual": [0, 8, 9, 10, 11, 12, 13, 14, 15, 16], "annualdata": [0, 8], "blank": [0, 8, 9, 12, 13, 14, 15, 16], "qa_blank": [0, 8, 9, 12, 13, 14, 15, 16], "colloc": [0, 8, 9, 12, 13, 14, 15, 16], "assess": [0, 8, 9, 12, 13, 14, 15, 16], "qa_collocated_assess": [0, 8, 9, 12, 13, 14, 15, 16], "flow": [0, 8, 9, 11, 12, 13, 14, 15, 16], "verif": [0, 8, 9, 11, 12, 13, 14, 15, 16], "qa_flowrateverif": [0, 8, 9, 12, 13, 14, 15, 16], "audit": [0, 8, 9, 12, 13, 14, 15, 16], "aqs_qa_flowrateaudit": [0, 8], "One": [0, 8], "point": [0, 8, 9, 13, 14, 15, 16], "raw": [0, 8, 9, 12, 13, 14, 15, 16], "qa_one_point_qc": [0, 8, 9, 12, 13, 14, 15, 16], "pep": [0, 8, 9, 12, 13, 14, 15, 16], "qa_pep_audit": [0, 8, 9, 12, 13, 14, 15, 16], "transact": [0, 8, 9, 12, 13, 14, 15, 16], "submiss": [0, 8, 9, 12, 13, 14, 15, 16], "rd": [0, 8, 9, 12, 13, 14, 15, 16], "transactionsampl": [0, 8, 9, 12, 13, 15, 16], "perform": [0, 8, 9, 12, 13, 14, 15, 16], "evalu": [0, 8, 9, 12, 13, 14, 15, 16], "qa_annualpeferomanceev": [0, 8, 9, 13, 15], "qa_annualpeferomanceevaltransact": [0, 8], "name": [0, 8], "list": [0, 8, 9, 10, 11, 12, 13, 14, 15, 16], "abov": [0, 8], "": [1, 2, 3, 6, 7, 9, 12, 15], "refer": [1, 9], "us": [1, 2, 5, 6, 9, 10, 11, 12, 13, 14, 15, 16], "data": [1, 3, 7, 9, 10, 11, 12, 13, 14, 15, 16], "mart": [1, 3, 7, 9], "api": [1, 3, 5, 6, 7, 8, 9], "function": [1, 3, 5, 7, 9, 10, 11, 12, 13, 14, 15, 16], "document": [1, 9], "user": [1, 3, 9], "pyaqsapi": [3, 5, 6, 8], "epa": [3, 6, 9], "aq": [3, 4, 7, 8, 9, 11, 12, 13, 14, 15, 16], "credenti": [3, 9], "librari": [3, 9], "instal": [3, 4], "set": [3, 9], "datamart": [6, 7, 9], "raqsapi": [6, 7], "load": [7, 9], "aggreg": [9, 10, 11, 12, 13, 14, 15, 16], "annualsummari": [9, 10, 11, 12, 15, 16], "bdate": [9, 10, 11, 12, 13, 14, 15, 16], "edat": [9, 10, 11, 12, 13, 14, 15, 16], "minlat": [9, 10], "maxlat": [9, 10], "minlon": [9, 10], "maxlon": [9, 10], "cbdate": [9, 10, 11, 12, 13, 14, 15, 16], "none": [9, 10, 11, 12, 13, 14, 15, 16], "cedat": [9, 10, 11, 12, 13, 14, 15, 16], "datafram": [9, 10, 11, 12, 13, 14, 15, 16], "_by_box": [9, 10], "contain": [9, 10, 11, 12, 13, 14, 15, 16], "match": [9, 10, 11, 12, 13, 14, 15, 16], "rectangular": [9, 10], "valu": [9, 10, 11, 12, 15, 16], "maxima": [9, 10, 11, 12, 15, 16], "percentil": [9, 10, 11, 12, 15, 16], "etc": [9, 10, 11, 12, 15, 16], "string": [9, 10, 11, 12, 13, 14, 15, 16], "code": [9, 10, 11, 12, 13, 14, 15, 16], "date": [9, 10, 11, 12, 13, 14, 15, 16], "begin": [9, 10, 11, 12, 13, 14, 15, 16], "select": [9, 10, 11, 12, 13, 14, 15, 16], "end": [9, 10, 11, 12, 13, 14, 15, 16], "minimum": [9, 10], "geograph": [9, 10], "decim": [9, 10], "north": [9, 10], "posit": [9, 10], "south": [9, 10], "east": [9, 10], "west": [9, 10], "80": [9, 10], "less": [9, 10], "70": [9, 10], "singl": [9, 10, 11, 12, 13, 14, 15, 16], "dailysummari": [9, 10, 11, 12, 15, 16], "statefip": [9, 10, 12, 14, 15, 16], "tabl": [9, 10, 11, 12, 13, 14, 15, 16], "quarterlysummari": [9, 10, 11, 12, 15, 16], "durat": [9, 10, 11, 12, 15, 16], "quarterli": [9, 10, 11, 12, 15, 16], "county_cod": [9, 10, 12, 15], "option": [9, 10, 11, 12, 13, 14, 15, 16], "filter": [9, 10, 11, 12, 13, 14, 15, 16], "actual": [9, 10, 11, 12, 15, 16], "calcul": [9, 10, 11, 12, 15, 16], "8": [9, 10, 11, 12, 15, 16], "hour": [9, 10, 11, 12, 15, 16], "carbon": [9, 10, 11, 12, 15, 16], "monoxid": [9, 10, 11, 12, 15, 16], "ozon": [9, 10, 11, 12, 15, 16], "roll": [9, 10, 11, 12, 15, 16], "averag": [9, 10, 11, 12, 15, 16], "6": [9, 10, 11, 12, 15, 16], "dai": [9, 10, 11, 12, 15, 16], "pm": [9, 10, 11, 12, 15, 16], "lead": [9, 10, 11, 12, 13, 14, 15, 16], "month": [9, 10, 11, 12, 15, 16], "aqs_sampledur": [9, 10, 11, 12, 15, 16], "cbsa": [9, 11], "cbsa_cod": [9, 11], "level": [9, 11, 12, 15, 16], "5": [9, 11, 12], "digit": [9, 11, 12, 13, 14, 15, 16], "zero": [9, 11, 12, 13, 14, 15, 16], "last": [9, 11, 12, 13, 14, 15, 16], "indic": [9, 11, 12, 13, 14, 15, 16], "updat": [9, 11, 12, 13, 14, 15, 16], "aqs_data": [9, 11, 16], "mart_apiv2": [9, 11, 16], "exampl": [9, 11, 12], "no2": [9, 11], "charlott": [9, 11], "concord": [9, 11], "gastonia": [9, 11], "nc": [9, 11, 12], "quarter": [9, 11], "2017": [9, 11], "datetim": [9, 11, 12], "42602": [9, 11], "16740": [9, 11], "timefram": [9, 11, 16], "countycod": [9, 12, 14, 15], "2": [9, 12, 15, 16], "fip": [9, 12, 15, 16], "aqs_stat": [9, 12, 15, 16], "aqs_counties_by_st": [9, 12, 15], "frm": [9, 12], "fem": [9, 12], "pm2": [9, 12], "wake": [9, 12], "between": [9, 12, 13, 14, 15, 16], "januari": [9, 12], "2015": [9, 12], "februari": [9, 12], "28": [9, 12], "2016": [9, 12], "88101": [9, 12], "37": [9, 12], "183": [9, 12], "qa_annualperformanceev": [9, 12, 14, 16], "qa_annualperformanceevaltransact": [9, 12, 13, 14, 15, 16], "pair": [9, 12, 13, 14, 15, 16], "qa": [9, 12, 13, 14, 15, 16], "unexpos": [9, 12, 13, 14, 15, 16], "devic": [9, 12, 13, 14, 15, 16], "g": [9, 12, 13, 14, 15, 16], "transport": [9, 12, 13, 14, 15, 16], "expos": [9, 12, 13, 14, 15, 16], "contamin": [9, 12, 13, 14, 15, 16], "dure": [9, 12, 13, 14, 15, 16], "qa_flowrateaudit": [9, 12, 13, 14, 15, 16], "flowrat": [9, 12, 13, 14, 15, 16], "submit": [9, 12, 13, 16], "standard": [9, 12, 13, 16], "correspond": [9, 12, 13, 15, 16], "ma": [9, 13], "By": [9, 13, 14], "ma_cod": [9, 13], "4": [9, 13, 14, 15], "_by_ma": [9, 13], "qc": [9, 13, 14, 15, 16], "check": [9, 13], "pqao": [9, 14], "pqao_cod": [9, 14], "sitenum": [9, 14, 15], "number": [9, 15], "period": [9, 15], "s3": [9, 16], "some": 9, "reason": 9, "sphinx": 9, "attribut": 9, "comment": 9, "out": 9, "_header": 9, "_request_tim": 9, "str": 9, "stamp": 9, "receiv": 9, "_statu": 9, "statu": 9, "_status_cod": 9, "numer": 9, "status_cod": 9, "_row": 9, "row": 9, "_data": 9, "_url": 9, "url": 9, "set_data": 9, "set_head": 9, "get_status_cod": 9, "get_url": 9, "get_request_tim": 9, "portion": 9, "must": 9, "warn": 9, "thrown": 9, "onc": 9, "re": 9, "obtain": 9, "through": 9, "sign": 9, "up": 9, "conjunct": 9, "aqs_removehead": 9, "aqsobject": 9, "aqs_data_mart_apiv2": 9, "decoupl": 9, "discard": 9, "els": 9, "aqs_cbsa": 9, "aqs_class": 9, "criteria": 9, "aqs_fields_by_servic": 9, "definit": 9, "field": 9, "gov": 9, "aqsweb": 9, "data_api": 9, "html": 9, "aqs_isavail": 9, "explain": 9, "aqs_knownissu": 9, "known": 9, "issu": 9, "usual": 9, "identifi": 9, "intern": 9, "correct": 9, "involv": 9, "aqs_ma": 9, "aqs_parameters_by_class": 9, "parameterclass": 9, "exact": 9, "what": 9, "found": 9, "aqs_pqao": 9, "aqs_revisionhistori": 9, "histori": 9, "pb": 9, "aqs_sites_by_counti": 9, "territori": 9, "district": 9, "columbia": 9, "aqs_is_avail": 9, "locat": 9, "revis": 9, "regist": 9, "reset": 9, "specifi": 9, "usag": 9, "case": 9, "further": 9, "instruct": 9, "continu": 9, "follow": 9, "proceed": 9, "your": 9}, "objects": {"pyaqsapi": [[10, 0, 0, "-", "bybox"], [11, 0, 0, "-", "bycbsa"], [12, 0, 0, "-", "bycounty"], [13, 0, 0, "-", "byma"], [14, 0, 0, "-", "bypqao"], [15, 0, 0, "-", "bysite"], [16, 0, 0, "-", "bystate"], [9, 0, 0, "-", "helperfunctions"], [9, 0, 0, "-", "listfunctions"], [9, 0, 0, "-", "metadatafunctions"], [9, 0, 0, "-", "setupfunctions"]], "pyaqsapi.bybox": [[10, 0, 0, "-", "bybox"]], "pyaqsapi.bybox.bybox": [[10, 1, 1, "", "annualsummary"], [10, 1, 1, "", "dailysummary"], [10, 1, 1, "", "monitors"], [10, 1, 1, "", "quarterlysummary"], [10, 1, 1, "", "sampledata"]], "pyaqsapi.bycbsa": [[11, 0, 0, "-", "bycbsa"]], "pyaqsapi.bycbsa.bycbsa": [[11, 1, 1, "", "annualsummary"], [11, 1, 1, "", "dailysummary"], [11, 1, 1, "", "monitors"], [11, 1, 1, "", "quarterlysummary"], [11, 1, 1, "", "sampledata"]], "pyaqsapi.bycounty": [[12, 0, 0, "-", "bycounty"]], "pyaqsapi.bycounty.bycounty": [[12, 1, 1, "", "annualsummary"], [12, 1, 1, "", "dailysummary"], [12, 1, 1, "", "monitors"], [12, 1, 1, "", "qa_annualperformanceeval"], [12, 1, 1, "", "qa_annualperformanceevaltransaction"], [12, 1, 1, "", "qa_blanks"], [12, 1, 1, "", "qa_collocated_assessments"], [12, 1, 1, "", "qa_flowrateaudit"], [12, 1, 1, "", "qa_flowrateverification"], [12, 1, 1, "", "qa_one_point_qc"], [12, 1, 1, "", "qa_pep_audit"], [12, 1, 1, "", "quarterlysummary"], [12, 1, 1, "", "sampledata"], [12, 1, 1, "", "transactionsample"]], "pyaqsapi.byma": [[13, 0, 0, "-", "byma"]], "pyaqsapi.byma.byma": [[13, 1, 1, "", "qa_annualpeferomanceeval"], [13, 1, 1, "", "qa_annualperformanceevaltransaction"], [13, 1, 1, "", "qa_blanks"], [13, 1, 1, "", "qa_collocated_assessments"], [13, 1, 1, "", "qa_flowrateaudit"], [13, 1, 1, "", "qa_flowrateverification"], [13, 1, 1, "", "qa_one_point_qc"], [13, 1, 1, "", "qa_pep_audit"], [13, 1, 1, "", "transactionsample"]], "pyaqsapi.bypqao": [[14, 0, 0, "-", "bypqao"]], "pyaqsapi.bypqao.bypqao": [[14, 1, 1, "", "qa_annualperformanceeval"], [14, 1, 1, "", "qa_annualperformanceevaltransaction"], [14, 1, 1, "", "qa_blanks"], [14, 1, 1, "", "qa_collocated_assessments"], [14, 1, 1, "", "qa_flowrateaudit"], [14, 1, 1, "", "qa_flowrateverification"], [14, 1, 1, "", "qa_one_point_qc"], [14, 1, 1, "", "qa_pep_audit"]], "pyaqsapi.bysite": [[15, 0, 0, "-", "bysite"]], "pyaqsapi.bysite.bysite": [[15, 1, 1, "", "annualsummary"], [15, 1, 1, "", "dailysummary"], [15, 1, 1, "", "monitors"], [15, 1, 1, "", "qa_annualpeferomanceeval"], [15, 1, 1, "", "qa_annualperformanceevaltransaction"], [15, 1, 1, "", "qa_blanks"], [15, 1, 1, "", "qa_collocated_assessments"], [15, 1, 1, "", "qa_flowrateaudit"], [15, 1, 1, "", "qa_flowrateverification"], [15, 1, 1, "", "qa_one_point_qc"], [15, 1, 1, "", "qa_pep_audit"], [15, 1, 1, "", "quarterlysummary"], [15, 1, 1, "", "sampledata"], [15, 1, 1, "", "transactionsample"]], "pyaqsapi.bystate": [[16, 0, 0, "-", "bystate"]], "pyaqsapi.bystate.bystate": [[16, 1, 1, "", "annualsummary"], [16, 1, 1, "", "dailysummary"], [16, 1, 1, "", "monitors"], [16, 1, 1, "", "qa_annualperformanceeval"], [16, 1, 1, "", "qa_annualperformanceevaltransaction"], [16, 1, 1, "", "qa_blanks"], [16, 1, 1, "", "qa_collocated_assessments"], [16, 1, 1, "", "qa_flowrateaudit"], [16, 1, 1, "", "qa_flowrateverification"], [16, 1, 1, "", "qa_one_point_qc"], [16, 1, 1, "", "qa_pep_audit"], [16, 1, 1, "", "quarterlysummary"], [16, 1, 1, "", "sampledata"], [16, 1, 1, "", "transactionsample"]], "pyaqsapi.helperfunctions": [[9, 2, 1, "", "AQSAPI_V2"], [9, 1, 1, "", "aqs_credentials"], [9, 1, 1, "", "aqs_removeheader"]], "pyaqsapi.helperfunctions.AQSAPI_V2": [[9, 3, 1, "", "get_data"], [9, 3, 1, "", "get_header"], [9, 3, 1, "", "get_request_time"], [9, 3, 1, "", "get_status_code"], [9, 3, 1, "", "get_url"], [9, 3, 1, "", "set_data"], [9, 3, 1, "", "set_header"]], "pyaqsapi.listfunctions": [[9, 1, 1, "", "aqs_cbsas"], [9, 1, 1, "", "aqs_classes"], [9, 1, 1, "", "aqs_counties_by_state"], [9, 1, 1, "", "aqs_fields_by_service"], [9, 1, 1, "", "aqs_isavailable"], [9, 1, 1, "", "aqs_knownissues"], [9, 1, 1, "", "aqs_mas"], [9, 1, 1, "", "aqs_parameters_by_class"], [9, 1, 1, "", "aqs_pqaos"], [9, 1, 1, "", "aqs_revisionhistory"], [9, 1, 1, "", "aqs_sampledurations"], [9, 1, 1, "", "aqs_sites_by_county"], [9, 1, 1, "", "aqs_states"]], "pyaqsapi.metadatafunctions": [[9, 1, 1, "", "aqs_is_available"], [9, 1, 1, "", "aqs_knownissues"], [9, 1, 1, "", "aqs_revisionhistory"]], "pyaqsapi.setupfunctions": [[9, 1, 1, "", "aqs_sign_up"]]}, "objtypes": {"0": "py:module", "1": "py:function", "2": "py:class", "3": "py:method"}, "objnames": {"0": ["py", "module", "Python module"], "1": ["py", "function", "Python function"], "2": ["py", "class", "Python class"], "3": ["py", "method", "Python method"]}, "titleterms": {"pyaqsapi": [0, 2, 4, 7, 9, 10, 11, 12, 13, 14, 15, 16], "": 0, "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], "raqsapi": [0, 5], "instal": [0, 2], "load": [0, 4], "us": [0, 7], "sign": [0, 7], "up": [0, 7], "set": [0, 7], "user": [0, 7], "credenti": [0, 7], "librari": [0, 7], "mart": [0, 8], "aggreg": [0, 8], "function": [0, 8], "api": 0, "refer": 0, "index": 0, "packag": [9, 10, 11, 12, 13, 14, 15, 16], "submodul": [9, 10, 11, 12, 13, 14, 15, 16], "bybox": [9, 10], "modul": [9, 10, 11, 12, 13, 14, 15, 16], "bycbsa": [9, 11], "bycounti": [9, 12], "byma": [9, 13], "bypqao": [9, 14], "bysit": [9, 15], "bystat": [9, 16], "helperfunct": 9, "listfunct": 9, "metadatafunct": 9, "setupfunct": 9, "content": [10, 11, 12, 13, 14, 15, 16]}, "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's documentation": [[0, "pyaqsapi-s-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"]], "Data Mart aggregate functions": [[0, "data-mart-aggregate-functions"], [8, "data-mart-aggregate-functions"]], "pyaqsapi API reference documentation": [[0, "pyaqsapi-api-reference-documentation"]], "Index": [[0, "index"]], "pyaqsapi package": [[9, "pyaqsapi-package"]], "Submodules": [[9, "submodules"], [10, "submodules"], [11, "submodules"], [12, "submodules"], [13, "submodules"], [14, "submodules"], [15, "submodules"], [16, "submodules"]], "pyaqsapi.bybox.bybox module": [[9, "module-pyaqsapi.bybox.bybox"], [10, "module-pyaqsapi.bybox.bybox"]], "pyaqsapi.bycbsa.bycbsa module": [[9, "module-pyaqsapi.bycbsa.bycbsa"], [11, "module-pyaqsapi.bycbsa.bycbsa"]], "pyaqsapi.bycounty.bycounty module": [[9, "module-pyaqsapi.bycounty.bycounty"], [12, "module-pyaqsapi.bycounty.bycounty"]], "pyaqsapi.byma.byma module": [[9, "module-pyaqsapi.byma.byma"], [13, "module-pyaqsapi.byma.byma"]], "pyaqsapi.bypqao.bypqao module": [[9, "module-pyaqsapi.bypqao.bypqao"], [14, "module-pyaqsapi.bypqao.bypqao"]], "pyaqsapi.bysite.bysite module": [[9, "module-pyaqsapi.bysite.bysite"], [15, "module-pyaqsapi.bysite.bysite"]], "pyaqsapi.bystate.bystate module": [[9, "module-pyaqsapi.bystate.bystate"], [16, "module-pyaqsapi.bystate.bystate"]], "pyaqsapi.helperfunctions module": [[9, "module-pyaqsapi.helperfunctions"]], "pyaqsapi.listfunctions module": [[9, "module-pyaqsapi.listfunctions"]], "pyaqsapi.metadatafunctions module": [[9, "module-pyaqsapi.metadatafunctions"]], "pyaqsapi.setupfunctions module": [[9, "module-pyaqsapi.setupfunctions"]], "pyaqsapi.bybox package": [[10, "pyaqsapi-bybox-package"]], "Module contents": [[10, "module-pyaqsapi.bybox"], [11, "module-pyaqsapi.bycbsa"], [12, "module-pyaqsapi.bycounty"], [13, "module-pyaqsapi.byma"], [14, "module-pyaqsapi.bypqao"], [15, "module-pyaqsapi.bysite"], [16, "module-pyaqsapi.bystate"]], "pyaqsapi.bycbsa package": [[11, "pyaqsapi-bycbsa-package"]], "pyaqsapi.bycounty package": [[12, "pyaqsapi-bycounty-package"]], "pyaqsapi.byma package": [[13, "pyaqsapi-byma-package"]], "pyaqsapi.bypqao package": [[14, "pyaqsapi-bypqao-package"]], "pyaqsapi.bysite package": [[15, "pyaqsapi-bysite-package"]], "pyaqsapi.bystate package": [[16, "pyaqsapi-bystate-package"]]}, "indexentries": {"epa disclaimer": [[0, "index-0"], [1, "index-0"]], "raqsapi": [[0, "index-2"], [5, "index-0"]], "aggregate functions": [[0, "index-8"], [8, "index-1"]], "install pyaqsapi": [[0, "index-3"], [2, "index-0"]], "load pyaqsapi": [[0, "index-4"], [4, "index-0"]], "pyaqsapi aggregate functions (brief)": [[0, "index-7"], [8, "index-0"]], "services": [[0, "index-9"], [8, "index-2"]], "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"]], "aqsapi_v2 (class in pyaqsapi.helperfunctions)": [[9, "pyaqsapi.helperfunctions.AQSAPI_V2"]], "annualsummary() (in module pyaqsapi.bybox.bybox)": [[9, "pyaqsapi.bybox.bybox.annualsummary"], [10, "pyaqsapi.bybox.bybox.annualsummary"]], "annualsummary() (in module pyaqsapi.bycbsa.bycbsa)": [[9, "pyaqsapi.bycbsa.bycbsa.annualsummary"], [11, "pyaqsapi.bycbsa.bycbsa.annualsummary"]], "annualsummary() (in module pyaqsapi.bycounty.bycounty)": [[9, "pyaqsapi.bycounty.bycounty.annualsummary"], [12, "pyaqsapi.bycounty.bycounty.annualsummary"]], "annualsummary() (in module pyaqsapi.bysite.bysite)": [[9, "pyaqsapi.bysite.bysite.annualsummary"], [15, "pyaqsapi.bysite.bysite.annualsummary"]], "annualsummary() (in module pyaqsapi.bystate.bystate)": [[9, "pyaqsapi.bystate.bystate.annualsummary"], [16, "pyaqsapi.bystate.bystate.annualsummary"]], "aqs_cbsas() (in module pyaqsapi.listfunctions)": [[9, "pyaqsapi.listfunctions.aqs_cbsas"]], "aqs_classes() (in module pyaqsapi.listfunctions)": [[9, "pyaqsapi.listfunctions.aqs_classes"]], "aqs_counties_by_state() (in module pyaqsapi.listfunctions)": [[9, "pyaqsapi.listfunctions.aqs_counties_by_state"]], "aqs_credentials() (in module pyaqsapi.helperfunctions)": [[9, "pyaqsapi.helperfunctions.aqs_credentials"]], "aqs_fields_by_service() (in module pyaqsapi.listfunctions)": [[9, "pyaqsapi.listfunctions.aqs_fields_by_service"]], "aqs_is_available() (in module pyaqsapi.metadatafunctions)": [[9, "pyaqsapi.metadatafunctions.aqs_is_available"]], "aqs_isavailable() (in module pyaqsapi.listfunctions)": [[9, "pyaqsapi.listfunctions.aqs_isavailable"]], "aqs_knownissues() (in module pyaqsapi.listfunctions)": [[9, "pyaqsapi.listfunctions.aqs_knownissues"]], "aqs_knownissues() (in module pyaqsapi.metadatafunctions)": [[9, "pyaqsapi.metadatafunctions.aqs_knownissues"]], "aqs_mas() (in module pyaqsapi.listfunctions)": [[9, "pyaqsapi.listfunctions.aqs_mas"]], "aqs_parameters_by_class() (in module pyaqsapi.listfunctions)": [[9, "pyaqsapi.listfunctions.aqs_parameters_by_class"]], "aqs_pqaos() (in module pyaqsapi.listfunctions)": [[9, "pyaqsapi.listfunctions.aqs_pqaos"]], "aqs_removeheader() (in module pyaqsapi.helperfunctions)": [[9, "pyaqsapi.helperfunctions.aqs_removeheader"]], "aqs_revisionhistory() (in module pyaqsapi.listfunctions)": [[9, "pyaqsapi.listfunctions.aqs_revisionhistory"]], "aqs_revisionhistory() (in module pyaqsapi.metadatafunctions)": [[9, "pyaqsapi.metadatafunctions.aqs_revisionhistory"]], "aqs_sampledurations() (in module pyaqsapi.listfunctions)": [[9, "pyaqsapi.listfunctions.aqs_sampledurations"]], "aqs_sign_up() (in module pyaqsapi.setupfunctions)": [[9, "pyaqsapi.setupfunctions.aqs_sign_up"]], "aqs_sites_by_county() (in module pyaqsapi.listfunctions)": [[9, "pyaqsapi.listfunctions.aqs_sites_by_county"]], "aqs_states() (in module pyaqsapi.listfunctions)": [[9, "pyaqsapi.listfunctions.aqs_states"]], "dailysummary() (in module pyaqsapi.bybox.bybox)": [[9, "pyaqsapi.bybox.bybox.dailysummary"], [10, "pyaqsapi.bybox.bybox.dailysummary"]], "dailysummary() (in module pyaqsapi.bycbsa.bycbsa)": [[9, "pyaqsapi.bycbsa.bycbsa.dailysummary"], [11, "pyaqsapi.bycbsa.bycbsa.dailysummary"]], "dailysummary() (in module pyaqsapi.bycounty.bycounty)": [[9, "pyaqsapi.bycounty.bycounty.dailysummary"], [12, "pyaqsapi.bycounty.bycounty.dailysummary"]], "dailysummary() (in module pyaqsapi.bysite.bysite)": [[9, "pyaqsapi.bysite.bysite.dailysummary"], [15, "pyaqsapi.bysite.bysite.dailysummary"]], "dailysummary() (in module pyaqsapi.bystate.bystate)": [[9, "pyaqsapi.bystate.bystate.dailysummary"], [16, "pyaqsapi.bystate.bystate.dailysummary"]], "get_data() (pyaqsapi.helperfunctions.aqsapi_v2 method)": [[9, "pyaqsapi.helperfunctions.AQSAPI_V2.get_data"]], "get_header() (pyaqsapi.helperfunctions.aqsapi_v2 method)": [[9, "pyaqsapi.helperfunctions.AQSAPI_V2.get_header"]], "get_request_time() (pyaqsapi.helperfunctions.aqsapi_v2 method)": [[9, "pyaqsapi.helperfunctions.AQSAPI_V2.get_request_time"]], "get_status_code() (pyaqsapi.helperfunctions.aqsapi_v2 method)": [[9, "pyaqsapi.helperfunctions.AQSAPI_V2.get_status_code"]], "get_url() (pyaqsapi.helperfunctions.aqsapi_v2 method)": [[9, "pyaqsapi.helperfunctions.AQSAPI_V2.get_url"]], "module": [[9, "module-pyaqsapi.bybox.bybox"], [9, "module-pyaqsapi.bycbsa.bycbsa"], [9, "module-pyaqsapi.bycounty.bycounty"], [9, "module-pyaqsapi.byma.byma"], [9, "module-pyaqsapi.bypqao.bypqao"], [9, "module-pyaqsapi.bysite.bysite"], [9, "module-pyaqsapi.bystate.bystate"], [9, "module-pyaqsapi.helperfunctions"], [9, "module-pyaqsapi.listfunctions"], [9, "module-pyaqsapi.metadatafunctions"], [9, "module-pyaqsapi.setupfunctions"], [10, "module-pyaqsapi.bybox"], [10, "module-pyaqsapi.bybox.bybox"], [11, "module-pyaqsapi.bycbsa"], [11, "module-pyaqsapi.bycbsa.bycbsa"], [12, "module-pyaqsapi.bycounty"], [12, "module-pyaqsapi.bycounty.bycounty"], [13, "module-pyaqsapi.byma"], [13, "module-pyaqsapi.byma.byma"], [14, "module-pyaqsapi.bypqao"], [14, "module-pyaqsapi.bypqao.bypqao"], [15, "module-pyaqsapi.bysite"], [15, "module-pyaqsapi.bysite.bysite"], [16, "module-pyaqsapi.bystate"], [16, "module-pyaqsapi.bystate.bystate"]], "monitors() (in module pyaqsapi.bybox.bybox)": [[9, "pyaqsapi.bybox.bybox.monitors"], [10, "pyaqsapi.bybox.bybox.monitors"]], "monitors() (in module pyaqsapi.bycbsa.bycbsa)": [[9, "pyaqsapi.bycbsa.bycbsa.monitors"], [11, "pyaqsapi.bycbsa.bycbsa.monitors"]], "monitors() (in module pyaqsapi.bycounty.bycounty)": [[9, "pyaqsapi.bycounty.bycounty.monitors"], [12, "pyaqsapi.bycounty.bycounty.monitors"]], "monitors() (in module pyaqsapi.bysite.bysite)": [[9, "pyaqsapi.bysite.bysite.monitors"], [15, "pyaqsapi.bysite.bysite.monitors"]], "monitors() (in module pyaqsapi.bystate.bystate)": [[9, "pyaqsapi.bystate.bystate.monitors"], [16, "pyaqsapi.bystate.bystate.monitors"]], "pyaqsapi.bybox.bybox": [[9, "module-pyaqsapi.bybox.bybox"], [10, "module-pyaqsapi.bybox.bybox"]], "pyaqsapi.bycbsa.bycbsa": [[9, "module-pyaqsapi.bycbsa.bycbsa"], [11, "module-pyaqsapi.bycbsa.bycbsa"]], "pyaqsapi.bycounty.bycounty": [[9, "module-pyaqsapi.bycounty.bycounty"], [12, "module-pyaqsapi.bycounty.bycounty"]], "pyaqsapi.byma.byma": [[9, "module-pyaqsapi.byma.byma"], [13, "module-pyaqsapi.byma.byma"]], "pyaqsapi.bypqao.bypqao": [[9, "module-pyaqsapi.bypqao.bypqao"], [14, "module-pyaqsapi.bypqao.bypqao"]], "pyaqsapi.bysite.bysite": [[9, "module-pyaqsapi.bysite.bysite"], [15, "module-pyaqsapi.bysite.bysite"]], "pyaqsapi.bystate.bystate": [[9, "module-pyaqsapi.bystate.bystate"], [16, "module-pyaqsapi.bystate.bystate"]], "pyaqsapi.helperfunctions": [[9, "module-pyaqsapi.helperfunctions"]], "pyaqsapi.listfunctions": [[9, "module-pyaqsapi.listfunctions"]], "pyaqsapi.metadatafunctions": [[9, "module-pyaqsapi.metadatafunctions"]], "pyaqsapi.setupfunctions": [[9, "module-pyaqsapi.setupfunctions"]], "qa_annualpeferomanceeval() (in module pyaqsapi.byma.byma)": [[9, "pyaqsapi.byma.byma.qa_annualpeferomanceeval"], [13, "pyaqsapi.byma.byma.qa_annualpeferomanceeval"]], "qa_annualpeferomanceeval() (in module pyaqsapi.bysite.bysite)": [[9, "pyaqsapi.bysite.bysite.qa_annualpeferomanceeval"], [15, "pyaqsapi.bysite.bysite.qa_annualpeferomanceeval"]], "qa_annualperformanceeval() (in module pyaqsapi.bycounty.bycounty)": [[9, "pyaqsapi.bycounty.bycounty.qa_annualperformanceeval"], [12, "pyaqsapi.bycounty.bycounty.qa_annualperformanceeval"]], "qa_annualperformanceeval() (in module pyaqsapi.bypqao.bypqao)": [[9, "pyaqsapi.bypqao.bypqao.qa_annualperformanceeval"], [14, "pyaqsapi.bypqao.bypqao.qa_annualperformanceeval"]], "qa_annualperformanceeval() (in module pyaqsapi.bystate.bystate)": [[9, "pyaqsapi.bystate.bystate.qa_annualperformanceeval"], [16, "pyaqsapi.bystate.bystate.qa_annualperformanceeval"]], "qa_annualperformanceevaltransaction() (in module pyaqsapi.bycounty.bycounty)": [[9, "pyaqsapi.bycounty.bycounty.qa_annualperformanceevaltransaction"], [12, "pyaqsapi.bycounty.bycounty.qa_annualperformanceevaltransaction"]], "qa_annualperformanceevaltransaction() (in module pyaqsapi.byma.byma)": [[9, "pyaqsapi.byma.byma.qa_annualperformanceevaltransaction"], [13, "pyaqsapi.byma.byma.qa_annualperformanceevaltransaction"]], "qa_annualperformanceevaltransaction() (in module pyaqsapi.bypqao.bypqao)": [[9, "pyaqsapi.bypqao.bypqao.qa_annualperformanceevaltransaction"], [14, "pyaqsapi.bypqao.bypqao.qa_annualperformanceevaltransaction"]], "qa_annualperformanceevaltransaction() (in module pyaqsapi.bysite.bysite)": [[9, "pyaqsapi.bysite.bysite.qa_annualperformanceevaltransaction"], [15, "pyaqsapi.bysite.bysite.qa_annualperformanceevaltransaction"]], "qa_annualperformanceevaltransaction() (in module pyaqsapi.bystate.bystate)": [[9, "pyaqsapi.bystate.bystate.qa_annualperformanceevaltransaction"], [16, "pyaqsapi.bystate.bystate.qa_annualperformanceevaltransaction"]], "qa_blanks() (in module pyaqsapi.bycounty.bycounty)": [[9, "pyaqsapi.bycounty.bycounty.qa_blanks"], [12, "pyaqsapi.bycounty.bycounty.qa_blanks"]], "qa_blanks() (in module pyaqsapi.byma.byma)": [[9, "pyaqsapi.byma.byma.qa_blanks"], [13, "pyaqsapi.byma.byma.qa_blanks"]], "qa_blanks() (in module pyaqsapi.bypqao.bypqao)": [[9, "pyaqsapi.bypqao.bypqao.qa_blanks"], [14, "pyaqsapi.bypqao.bypqao.qa_blanks"]], "qa_blanks() (in module pyaqsapi.bysite.bysite)": [[9, "pyaqsapi.bysite.bysite.qa_blanks"], [15, "pyaqsapi.bysite.bysite.qa_blanks"]], "qa_blanks() (in module pyaqsapi.bystate.bystate)": [[9, "pyaqsapi.bystate.bystate.qa_blanks"], [16, "pyaqsapi.bystate.bystate.qa_blanks"]], "qa_collocated_assessments() (in module pyaqsapi.bycounty.bycounty)": [[9, "pyaqsapi.bycounty.bycounty.qa_collocated_assessments"], [12, "pyaqsapi.bycounty.bycounty.qa_collocated_assessments"]], "qa_collocated_assessments() (in module pyaqsapi.byma.byma)": [[9, "pyaqsapi.byma.byma.qa_collocated_assessments"], [13, "pyaqsapi.byma.byma.qa_collocated_assessments"]], "qa_collocated_assessments() (in module pyaqsapi.bypqao.bypqao)": [[9, "pyaqsapi.bypqao.bypqao.qa_collocated_assessments"], [14, "pyaqsapi.bypqao.bypqao.qa_collocated_assessments"]], "qa_collocated_assessments() (in module pyaqsapi.bysite.bysite)": [[9, "pyaqsapi.bysite.bysite.qa_collocated_assessments"], [15, "pyaqsapi.bysite.bysite.qa_collocated_assessments"]], "qa_collocated_assessments() (in module pyaqsapi.bystate.bystate)": [[9, "pyaqsapi.bystate.bystate.qa_collocated_assessments"], [16, "pyaqsapi.bystate.bystate.qa_collocated_assessments"]], "qa_flowrateaudit() (in module pyaqsapi.bycounty.bycounty)": [[9, "pyaqsapi.bycounty.bycounty.qa_flowrateaudit"], [12, "pyaqsapi.bycounty.bycounty.qa_flowrateaudit"]], "qa_flowrateaudit() (in module pyaqsapi.byma.byma)": [[9, "pyaqsapi.byma.byma.qa_flowrateaudit"], [13, "pyaqsapi.byma.byma.qa_flowrateaudit"]], "qa_flowrateaudit() (in module pyaqsapi.bypqao.bypqao)": [[9, "pyaqsapi.bypqao.bypqao.qa_flowrateaudit"], [14, "pyaqsapi.bypqao.bypqao.qa_flowrateaudit"]], "qa_flowrateaudit() (in module pyaqsapi.bysite.bysite)": [[9, "pyaqsapi.bysite.bysite.qa_flowrateaudit"], [15, "pyaqsapi.bysite.bysite.qa_flowrateaudit"]], "qa_flowrateaudit() (in module pyaqsapi.bystate.bystate)": [[9, "pyaqsapi.bystate.bystate.qa_flowrateaudit"], [16, "pyaqsapi.bystate.bystate.qa_flowrateaudit"]], "qa_flowrateverification() (in module pyaqsapi.bycounty.bycounty)": [[9, "pyaqsapi.bycounty.bycounty.qa_flowrateverification"], [12, "pyaqsapi.bycounty.bycounty.qa_flowrateverification"]], "qa_flowrateverification() (in module pyaqsapi.byma.byma)": [[9, "pyaqsapi.byma.byma.qa_flowrateverification"], [13, "pyaqsapi.byma.byma.qa_flowrateverification"]], "qa_flowrateverification() (in module pyaqsapi.bypqao.bypqao)": [[9, "pyaqsapi.bypqao.bypqao.qa_flowrateverification"], [14, "pyaqsapi.bypqao.bypqao.qa_flowrateverification"]], "qa_flowrateverification() (in module pyaqsapi.bysite.bysite)": [[9, "pyaqsapi.bysite.bysite.qa_flowrateverification"], [15, "pyaqsapi.bysite.bysite.qa_flowrateverification"]], "qa_flowrateverification() (in module pyaqsapi.bystate.bystate)": [[9, "pyaqsapi.bystate.bystate.qa_flowrateverification"], [16, "pyaqsapi.bystate.bystate.qa_flowrateverification"]], "qa_one_point_qc() (in module pyaqsapi.bycounty.bycounty)": [[9, "pyaqsapi.bycounty.bycounty.qa_one_point_qc"], [12, "pyaqsapi.bycounty.bycounty.qa_one_point_qc"]], "qa_one_point_qc() (in module pyaqsapi.byma.byma)": [[9, "pyaqsapi.byma.byma.qa_one_point_qc"], [13, "pyaqsapi.byma.byma.qa_one_point_qc"]], "qa_one_point_qc() (in module pyaqsapi.bypqao.bypqao)": [[9, "pyaqsapi.bypqao.bypqao.qa_one_point_qc"], [14, "pyaqsapi.bypqao.bypqao.qa_one_point_qc"]], "qa_one_point_qc() (in module pyaqsapi.bysite.bysite)": [[9, "pyaqsapi.bysite.bysite.qa_one_point_qc"], [15, "pyaqsapi.bysite.bysite.qa_one_point_qc"]], "qa_one_point_qc() (in module pyaqsapi.bystate.bystate)": [[9, "pyaqsapi.bystate.bystate.qa_one_point_qc"], [16, "pyaqsapi.bystate.bystate.qa_one_point_qc"]], "qa_pep_audit() (in module pyaqsapi.bycounty.bycounty)": [[9, "pyaqsapi.bycounty.bycounty.qa_pep_audit"], [12, "pyaqsapi.bycounty.bycounty.qa_pep_audit"]], "qa_pep_audit() (in module pyaqsapi.byma.byma)": [[9, "pyaqsapi.byma.byma.qa_pep_audit"], [13, "pyaqsapi.byma.byma.qa_pep_audit"]], "qa_pep_audit() (in module pyaqsapi.bypqao.bypqao)": [[9, "pyaqsapi.bypqao.bypqao.qa_pep_audit"], [14, "pyaqsapi.bypqao.bypqao.qa_pep_audit"]], "qa_pep_audit() (in module pyaqsapi.bysite.bysite)": [[9, "pyaqsapi.bysite.bysite.qa_pep_audit"], [15, "pyaqsapi.bysite.bysite.qa_pep_audit"]], "qa_pep_audit() (in module pyaqsapi.bystate.bystate)": [[9, "pyaqsapi.bystate.bystate.qa_pep_audit"], [16, "pyaqsapi.bystate.bystate.qa_pep_audit"]], "quarterlysummary() (in module pyaqsapi.bybox.bybox)": [[9, "pyaqsapi.bybox.bybox.quarterlysummary"], [10, "pyaqsapi.bybox.bybox.quarterlysummary"]], "quarterlysummary() (in module pyaqsapi.bycbsa.bycbsa)": [[9, "pyaqsapi.bycbsa.bycbsa.quarterlysummary"], [11, "pyaqsapi.bycbsa.bycbsa.quarterlysummary"]], "quarterlysummary() (in module pyaqsapi.bycounty.bycounty)": [[9, "pyaqsapi.bycounty.bycounty.quarterlysummary"], [12, "pyaqsapi.bycounty.bycounty.quarterlysummary"]], "quarterlysummary() (in module pyaqsapi.bysite.bysite)": [[9, "pyaqsapi.bysite.bysite.quarterlysummary"], [15, "pyaqsapi.bysite.bysite.quarterlysummary"]], "quarterlysummary() (in module pyaqsapi.bystate.bystate)": [[9, "pyaqsapi.bystate.bystate.quarterlysummary"], [16, "pyaqsapi.bystate.bystate.quarterlysummary"]], "sampledata() (in module pyaqsapi.bybox.bybox)": [[9, "pyaqsapi.bybox.bybox.sampledata"], [10, "pyaqsapi.bybox.bybox.sampledata"]], "sampledata() (in module pyaqsapi.bycbsa.bycbsa)": [[9, "pyaqsapi.bycbsa.bycbsa.sampledata"], [11, "pyaqsapi.bycbsa.bycbsa.sampledata"]], "sampledata() (in module pyaqsapi.bycounty.bycounty)": [[9, "pyaqsapi.bycounty.bycounty.sampledata"], [12, "pyaqsapi.bycounty.bycounty.sampledata"]], "sampledata() (in module pyaqsapi.bysite.bysite)": [[9, "pyaqsapi.bysite.bysite.sampledata"], [15, "pyaqsapi.bysite.bysite.sampledata"]], "sampledata() (in module pyaqsapi.bystate.bystate)": [[9, "pyaqsapi.bystate.bystate.sampledata"], [16, "pyaqsapi.bystate.bystate.sampledata"]], "set_data() (pyaqsapi.helperfunctions.aqsapi_v2 method)": [[9, "pyaqsapi.helperfunctions.AQSAPI_V2.set_data"]], "set_header() (pyaqsapi.helperfunctions.aqsapi_v2 method)": [[9, "pyaqsapi.helperfunctions.AQSAPI_V2.set_header"]], "transactionsample() (in module pyaqsapi.bycounty.bycounty)": [[9, "pyaqsapi.bycounty.bycounty.transactionsample"], [12, "pyaqsapi.bycounty.bycounty.transactionsample"]], "transactionsample() (in module pyaqsapi.byma.byma)": [[9, "pyaqsapi.byma.byma.transactionsample"], [13, "pyaqsapi.byma.byma.transactionsample"]], "transactionsample() (in module pyaqsapi.bysite.bysite)": [[9, "pyaqsapi.bysite.bysite.transactionsample"], [15, "pyaqsapi.bysite.bysite.transactionsample"]], "transactionsample() (in module pyaqsapi.bystate.bystate)": [[9, "pyaqsapi.bystate.bystate.transactionsample"], [16, "pyaqsapi.bystate.bystate.transactionsample"]], "pyaqsapi.bybox": [[10, "module-pyaqsapi.bybox"]], "pyaqsapi.bycbsa": [[11, "module-pyaqsapi.bycbsa"]], "pyaqsapi.bycounty": [[12, "module-pyaqsapi.bycounty"]], "pyaqsapi.byma": [[13, "module-pyaqsapi.byma"]], "pyaqsapi.bypqao": [[14, "module-pyaqsapi.bypqao"]], "pyaqsapi.bysite": [[15, "module-pyaqsapi.bysite"]], "pyaqsapi.bystate": [[16, "module-pyaqsapi.bystate"]]}}) \ 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/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], "modul": [0, 3, 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], "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], "listfunct": [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 diff --git a/docs/conf.py b/docs/conf.py index 58a038b..a730a87 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -36,13 +36,14 @@ "numpydoc", "sphinx.ext.napoleon", "sphinxcontrib.bibtex", + "sphinx.ext.autosectionlabel", ] # bibtext file location bibtex_bibfiles = ["manual/pyaqsapi.bib"] # Add any paths that contain templates here, relative to this directory. -templates_path = ["_templates"] +# templates_path = ["_templates"] # List of patterns, relative to source directory, that match files and # directories to ignore when looking for source files. @@ -54,8 +55,14 @@ "setup.py", "*modules.rst", "*setup.rst", + "pyaqsapi*.rst", + "*pyaqsapiFunctions-Brief.rst", + "genindex.rst", ] +# get rid of those duplicate label warnings when embedding a child rst file +# into another rst file. +suppress_warnings = ["autosectionlabel.*"] # -- Options for HTML output -------------------------------------------------- diff --git a/docs/genindex.rst b/docs/genindex.rst new file mode 100644 index 0000000..66a2352 --- /dev/null +++ b/docs/genindex.rst @@ -0,0 +1,2 @@ +Index +===== \ No newline at end of file diff --git a/docs/ignored_wordlist.txt b/docs/ignored_wordlist.txt index 6b6197c..349fd37 100644 --- a/docs/ignored_wordlist.txt +++ b/docs/ignored_wordlist.txt @@ -1,7 +1,7 @@ annualdata annualsummary -annualpeferomanceeval -annualpeferomanceevaltransaction +annualperformanceeval +annualperformanceevaltransaction aqs Barnstable bdate @@ -29,6 +29,8 @@ flowrateaudit flowrateverification Gastonia helperfunctions +isavailable +knownissues listfunctions maxima maxlat @@ -46,8 +48,11 @@ pyaqsapiFunctions qa qc quarterly +quarterlydata quarterlysummary RAQSAPI +removeheader +revisionhistory rst sampledata sampleduration diff --git a/docs/index.rst b/docs/index.rst index 08a44d9..8745d98 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -3,12 +3,16 @@ You can adapt this file completely to your liking, but it should at least contain the root `toctree` directive. +.. sectionauthor:: Clinton Mccrowey epa.gov> + +=========================== +pyaqsapi user documentation +=========================== -pyaqsapi's documentation -========================= .. toctree:: :maxdepth: 2 :numbered: + :hidden: .. include:: manual/EPA_Disclaimer.rst .. include:: manual/Introduction.rst @@ -19,12 +23,17 @@ pyaqsapi's documentation .. include:: manual/Using_pyaqsapi.rst .. This is temporary until the long version is finished -.. include:: manual/pyaqsapiFunctions-Brief.rst +.. +.. include:: manual/pyaqsapiFunctions-Long.rst + pyaqsapi API reference documentation -==================================== +------------------------------------ + * :ref:`modindex` -Index -===== + +pyaqsapi index +-------------- + * :ref:`genindex` diff --git a/docs/manual/pyaqsapiFunctions-Brief.rst b/docs/manual/pyaqsapiFunctions-Brief.rst index dd38309..0a972a6 100644 --- a/docs/manual/pyaqsapiFunctions-Brief.rst +++ b/docs/manual/pyaqsapiFunctions-Brief.rst @@ -1,4 +1,4 @@ -.. index:: pyaqsapi aggregate functions (brief) +:orphan: Data Mart aggregate functions ============================= @@ -34,25 +34,24 @@ Note that not all aggregations are available for each service. These thirteen services are: - - \ Monitors (\*monitors) - - \ Sample Data (\*sampledata) - - \ Daily Summary Data (\*dailydata) - - \ Annual Summary Data (annualdata) - - \ Quality Assurance - Blanks Data (\*qa_blanks) - - \ Quality Assurance - Collocated Assessments - (\*qa_collocated_assessments) - - \ Quality Assurance - Flow Rate Verifications (\*qa_flowrateverification) - - \ Quality Assurance - Flow Rate Audits (\*aqs_qa_flowrateaudit) - - \ Quality Assurance - One Point Quality Control Raw Data - (\*qa_one_point_qc) - - \ Quality Assurance - PEP Audits (\*qa_pep_audit) - - \ Transaction Sample - AQS Submission data in transaction Format (RD) - (\*transactionsample) - - \ Quality Assurance - Annual Performance Evaluations - (\*qa_annualpeferomanceeval) - - \ Quality Assurance - Annual Performance Evaluations in the AQS - \ Submission transaction format (RD) - \ (\*qa_annualpeferomanceevaltransaction) + * Monitors (monitors) + * Sample Data (sampledata) + * Daily Summary Data (dailydata) + * Annual Summary Data (annualdata) + * Quality Assurance - Blanks Data (qa_blanks) + * Quality Assurance - Collocated Assessments + (qa_collocated_assessments) + * Quality Assurance - Flow Rate Verifications (qa_flowrateverification) + * Quality Assurance - Flow Rate Audits (aqs_qa_flowrateaudit) + * Quality Assurance - One Point Quality Control Raw Data + (qa_one_point_qc) + * Quality Assurance - PEP Audits (qa_pep_audit) + * Transaction Sample - AQS Submission data in transaction Format (RD) + (transactionsample) + * Quality Assurance - Annual Performance Evaluations + (qa_annualperformanceeval) + * Quality Assurance - Annual Performance Evaluations in the AQS + Submission transaction format (RD) (qa_annualperformanceevaltransaction) Aggregate functions are named aqs..() where diff --git a/docs/manual/pyaqsapiFunctions-Long.rst b/docs/manual/pyaqsapiFunctions-Long.rst new file mode 100644 index 0000000..7da7e15 --- /dev/null +++ b/docs/manual/pyaqsapiFunctions-Long.rst @@ -0,0 +1,841 @@ +.. index:: Functions Exported by pyaqsapi + +Functions Exported by pyaqsapi +==================================================== +The pyaqsapi package includes the following submodules which are not +loaded by default: +:: + +* pyaqsapi.bysite +* pyaqsapi.bycounty +* pyaqsapi.bycounty +* pyaqsapi.bycbsa +* pyaqsapi.bybox +* pyaqsapi.byma +* pyaqsapi.ma + +With these submodules loaded to entire list of functions exported by the +pyaqsapi package includes: + +:: + +* pyaqsapi.aqs_cbsas, +* pyaqsapi.aqs_classes, +* pyaqsapi.aqs_counties_by_state, +* pyaqsapi.aqs_credentials, +* pyaqsapi.aqs_credentials, +* pyaqsapi.aqs_fields_by_service, +* pyaqsapi.aqs_fields_by_service, +* pyaqsapi.aqs_isavailable, +* pyaqsapi.aqs_isavailable, +* pyaqsapi.aqs_knownissues, +* pyaqsapi.aqs_knownissues, +* pyaqsapi.aqs_mas, +* pyaqsapi.aqs_parameters_by_class, +* pyaqsapi.aqs_pqaos, +* pyaqsapi.aqs_removeheader, +* pyaqsapi.aqs_revisionhistory, +* pyaqsapi.aqs_revisionhistory, +* pyaqsapi.aqs_sampledurations, +* pyaqsapi.aqs_sign_up, +* pyaqsapi.aqs_sign_up, +* pyaqsapi.aqs_sites_by_county, +* pyaqsapi.aqs_states, +* pyaqsapi.bybox.annualsummary, +* pyaqsapi.bybox.dailysummary, +* pyaqsapi.bybox.helperfunctions, +* pyaqsapi.bybox.monitors, +* pyaqsapi.bybox.quarterlysummary, +* pyaqsapi.bybox.sampledata, +* pyaqsapi.bycbsa.annualsummary, +* pyaqsapi.bycbsa.dailysummary, +* pyaqsapi.bycbsa.helperfunctions, +* pyaqsapi.bycbsa.monitors, +* pyaqsapi.bycbsa.quarterlysummary, +* pyaqsapi.bycbsa.sampledata, +* pyaqsapi.bycounty.annualsummary, +* pyaqsapi.bycounty.dailysummary, +* pyaqsapi.bycounty.helperfunctions, +* pyaqsapi.bycounty.monitors, +* pyaqsapi.bycounty.qa_annualperformanceeval, +* pyaqsapi.bycounty.qa_annualperformanceevaltransaction, +* pyaqsapi.bycounty.qa_blanks, +* pyaqsapi.bycounty.qa_collocated_assessments, +* pyaqsapi.bycounty.qa_flowrateaudit, +* pyaqsapi.bycounty.qa_flowrateverification, +* pyaqsapi.bycounty.qa_one_point_qc, +* pyaqsapi.bycounty.qa_pep_audit, +* pyaqsapi.bycounty.quarterlysummary, +* pyaqsapi.bycounty.sampledata, +* pyaqsapi.bycounty.transactionsample, +* pyaqsapi.byma.qa_annualpeferomanceeval, +* pyaqsapi.byma.qa_annualperformanceevaltransaction, +* pyaqsapi.byma.qa_blanks, +* pyaqsapi.byma.qa_collocated_assessments, +* pyaqsapi.byma.qa_flowrateaudit, +* pyaqsapi.byma.qa_flowrateverification, +* pyaqsapi.byma.qa_one_point_qc, +* pyaqsapi.byma.qa_pep_audit, +* pyaqsapi.byma.transactionsample, +* pyaqsapi.bypqao.qa_annualperformanceeval, +* pyaqsapi.bypqao.qa_annualperformanceevaltransaction, +* pyaqsapi.bypqao.qa_blanks, +* pyaqsapi.bypqao.qa_collocated_assessments, +* pyaqsapi.bypqao.qa_flowrateaudit, +* pyaqsapi.bypqao.qa_flowrateverification, +* pyaqsapi.bypqao.qa_one_point_qc, +* pyaqsapi.bypqao.qa_pep_audit, +* pyaqsapi.bysite.annualsummary, +* pyaqsapi.bysite.dailysummary, +* pyaqsapi.bysite.helperfunctions, +* pyaqsapi.bysite.monitors, +* pyaqsapi.bysite.qa_annualpeferomanceeval, +* pyaqsapi.bysite.qa_annualperformanceevaltransaction, +* pyaqsapi.bysite.qa_blanks, +* pyaqsapi.bysite.qa_collocated_assessments, +* pyaqsapi.bysite.qa_flowrateaudit, +* pyaqsapi.bysite.qa_flowrateverification, +* pyaqsapi.bysite.qa_one_point_qc, +* pyaqsapi.bysite.qa_pep_audit, +* pyaqsapi.bysite.quarterlysummary, +* pyaqsapi.bysite.sampledata, +* pyaqsapi.bysite.transactionsample, +* pyaqsapi.bystate.annualsummary, +* pyaqsapi.bystate.dailysummary, +* pyaqsapi.bystate.helperfunctions, +* pyaqsapi.bystate.monitors, +* pyaqsapi.bystate.qa_annualperformanceeval, +* pyaqsapi.bystate.qa_annualperformanceevaltransaction, +* pyaqsapi.bystate.qa_blanks, +* pyaqsapi.bystate.qa_collocated_assessments, +* pyaqsapi.bystate.qa_flowrateaudit, +* pyaqsapi.bystate.qa_flowrateverification, +* pyaqsapi.bystate.qa_one_point_qc, +* pyaqsapi.bystate.qa_pep_audit, +* pyaqsapi.bystate.quarterlysummary, +* pyaqsapi.bystate.sampledata, +* pyaqsapi.bystate.transactionsample + + +pyaqsapi functions are named according to the service and filter variables that +are available by the AQS Data Mart API. Refer to `Air Quality System (AQS) API +`_ for full details of the +AQS DataMart API. + + +Variable descriptions and usage +=============================== +These are all the available variables that can be used with various functions +exported from the pyaqsapi library listed alphabetically. Not all of these +variables are used with every function, and not all of these parameters are +required. See the :ref: `pyaqsapi functional families` section to +see which parameters are used with each function. + +* AQSobject: + an object of type AQSAPI_V2 that is returned from pyaqsapi + aggregate functions wheen return_header is True. + +* bdate: + a date object which represents the begin date of the data selection. + Only data on or after this date will be returned. + +* 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. + +* 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. + +* countycode: + a character object which represents the 3 digit state FIPS code for the + county being requested (with leading zero(s)). Refer to + :ref: `listfunctions` for a table of available county codes for each state. + +* duration (optional): + a character string that represents the parameter duration code that limits + returned data to a specific sample duration. The default value of None + will result in no filtering based on duration code. Valid durations + include actual sample durations and not calculated durations such as 8 hour + CO or O\ :sub:`3`\ rolling averages, 3/6 day PM averages or Pb 3 month + rolling averages. Refer to :ref: `aqs_sampledurations()` for a table of all + available duration codes. + +* edate: + a date object which represents the end date of the data selection. Only + data on or before this date will be returned. + +* 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 + email will be sent to the account specified. + +* key: + a character object which represents the key used in conjunction with the + username given to connect to AQS Data Mart. + +* MA_code: + a character object which represents the 4 digit AQS Monitoring Agency code + (with leading zeroes). + +* maxlat: + a character object which represents the maximum latitude of a geographic + box. Decimal latitude with north begin positive. Only data south of this + latitude will be returned. + +* maxlon: + a character object which represents the maximum longitude of a + geographic box. Decimal longitude with east being positive. Only + data west of this longitude will be returned. Note that -80 is less + than -70. + +* minlat: + a character object which represents the minimum latitude of a + geographic box. Decimal latitude with north being positive. + Only data north of this latitude will be returned. + +* minlon: + a character object which represents the minimum longitude of a + geographic box. Decimal longitude with east begin positive. Only + data east of this longitude will be returned. + +* parameter: + a character list or single character object which represents the parameter + code of the air pollutant related to the data being requested. + +* return_Header: + If False (default) only returns data requested as a pandas DataFrame. If + True returns a AQSAPI_V2 object. + +* service: + a string which represents the services provided by the AQS API. For a list + of available services refer to + `_` + for the complete listing of services available through the EPA + AQS Datamart API + +* sitenum: + a character object which represents the 4 digit site number (with + leading zeros) within the county and state being requested. + +* stateFIPS: + a character object which represents the 2 digit state FIPS code + (with leading zero) for the state being requested. + +* pqao_code: + a character object which represents the 4 digit AQS Primary Quality + Assurance Organization code (with leading zeroes). + +* username: + a character object which represents the email account that will be used to + connect to the AQS API. + +pyaqsapi functional families +============================ + +Sign up and credentials +----------------------- +The functions included in this family of functions are: + +:: + +* aqs_credentials +* aqs_sign_up + +These functions are used to sign up with Data Mart and to store credential + information to use with pyaqsapi. The aqs_sign_up function takes + one parameter: + +* email: + +The aqs_credentials function takes two parameters: + +* username: +* key: + +Data Mart API metadata functions +-------------------------------- +The functions included in this family of functions are: + +:: + +* aqs_isavailable +* aqs_knownissues +* aqs_fields_by_service +* aqs_revisionhistory + +These functions return Data Mart meta data + +The aqs_isavailable function takes no parameters and returns a + table which details the status of the AQS API. + +The aqs_fields_by_service function takes one parameter, service, + which is a character object which represents the services provided by + the AQS API. For a list of available services see + `Air Quality System (AQS) API - Services Overview + `_ + +The aqs_knownissues function takes no parameters and Returns a + table of any known issues with system functionality or the data. These are + usually issues that have been identified internally and will require some + time to correct in Data Mart or the API. This function implements a direct + API call to Data Mart and returns data directly from the API. Issues + returned via this function do not include any issues from the pyaqsapi + package. + +The aqs_revisionhistory function is used to query Data Mart for the + change history to the API. + +Data Mart API list functions +---------------------------- +The functions included in this family of functions are: +:: + +* aqs_cbsas, +* aqs_classes, +* aqs_counties_by_state, +* aqs_fields_by_service, +* aqs_isavailable, +* aqs_knownissues, +* aqs_mas, +* aqs_parameters_by_class, +* aqs_pqaos, +* aqs_revisionhistory, +* aqs_sampledurations, +* aqs_sites_by_county, +* aqs_states + + +List functions return the API status, API options or groupings that can be used + in conjunction with other API calls. By default each function in this + category returns results as a DataTable. If return_header parameter is set + to True a AQSAPI_v2 object is returned instead. + +aqs_cbsas returns a table of all available Core Based Statistical + Areas (cbsas) and their respective cbsa codes. + +aqs_states takes no arguments and returns a table of the available + states and their respective state FIPS codes. + +aqs_sampledurations takes no arguments and returns a table of the + available sample duration code used to construct other requests. + +aqs_classes takes no arguments and returns a table of parameter + classes (groups of parameters, i.e. "criteria" or "all"). + +aqs_counties_by_state takes one parameter, stateFIPS, which is a two + digit state FIPS code for the state being requested represented as a + character object and returns a table of counties and their + respective FIPS code for the state requested. Use aqs_states to + receive a table of valid state FIPS codes. + +aqs_sites_by_county takes two parameters, stateFIPS, which is a + two digit state FIPS code for the state being requested and county_code + which is a three digit county FIPS code for the county being requested, + both stateFIPS and county_code should be encoded as a character object. + This function returns a table of all air monitoring sites with the + requested state and county FIPS code combination. + +aqs_pqaos takes no parameters and returns an AQSAPI_V2 + object containing a table of primary quality assurance + organizations (pqaos). + +aqs_mas takes no parameters and returns an AQSAPI_V2 + object containing a table of monitoring agencies (MA). + +Data Mart aggregate functions +----------------------------- + +..note:: + AQS Data Mart API restricts the maximum amount of monitoring data to one + full year of data per API call. These functions are able to return multiple + years of data by making repeated calls to the API. Each call to the Data + Mart API will take time to complete. The more years of data being requested + the longer pyaqsapi will take to return the results. + +These functions retrieve aggregated data from the Data Mart API and are + grouped by how each function aggregates the data. There are 5 different + families of related aggregate functions. These families are arranged by how + the Data Mart API groups the returned data, bysite, bycounty, bystate, + by (bybox) and + by (bycbsa). Within each family + of aggregated data functions there are functions that call on the 10 + different services that the Data Mart API provides. All Aggregate + functions return a pandas DataFrame by default. If the return_Header + parameter is set to True an AQSAPI_V2 object is returned instead. + +These fourteen services are: + +1. **Monitors**: Returns operational information about the samplers (monitors) + used to collect the data. Includes identifying information, + operational dates, operating organizations, etc. Functions + using this service contain monitors in the function + name. + +2. **Sample Data**: Returns sample data - the most fine grain data reported to + EPA. Usually hourly, sometimes 5-minute, 12-hour, etc. + This service is available in several geographic selections + based on geography: site, county, state, cbsa (core based + statistical area, a grouping of counties), or + by latitude/longitude bounding box. Functions using this + service contain sampledata in the function name. + All Sample Data functions accept two additional, optional + parameters; cbdate and cedate. + + + 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. + + + 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 optional variable which defaults to None. + + + duration: an optional character string that represents the parameter + duration code that limits returned data to + a specific sample duration. The default value of + None results in no filtering based on + duration code. Valid durations include actual sample + durations and not calculated durations such as 8 hour + CO or $O_3$ rolling averages, 3/6 day PM averages or + Pb 3 month rolling averages. Refer to + [aqs_sampledurations()] for a list of all available + duration codes. + +3. **Daily Summary Data**: Returns data summarized at the daily level. All daily + summaries are calculated on midnight to midnight + basis in local time. Variables returned include + date, mean value, maximum value, etc. Functions + using this service contain Dailysummary in + the function name. All Daily Summary Data functions + accept two additional parameters; cbdate and cedate + + + 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. + + + 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 optional variable which defaults to None. + +4. **Annual Summary Data**: Returns data summarized at the yearly level. + Variables include mean value, maxima, + percentiles, etc. Functions using this service + contain annualdata in the function name. All + Annual Summary Data functions accept two + additional parameters; cbdate and cedate. + + + 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. + + + 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 + optional variable which defaults to None. + +5. **Quarterly Summary Data**: Returns data summarized at the quarterly level. + Variables include mean value, maxima, + percentiles, etc. Functions using this service + contain quarterlydata in the function name. All + Annual Summary Data functions accept two + additional parameters; cbdate and cedate. + + + 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. + + + 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 + optional variable which defaults to None. + +6. **Quality Assurance - Blanks Data**: + Quality assurance data - blanks samples. + Blanks are unexposed sample collection devices + (e.g., filters) that are transported with the + exposed sample devices to assess if contamination + is occurring during the transport or handling of + the samples. Functions using this service contain + qa_blanks in the function name. + +7. **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 this service + contain qa_collocated_assessments in the + function name. + +8. **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 taking + a measurement of the flow rate. Functions using this + service contain qa_flowrateverification in + the function name. + +9. **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 different + method than is used for flow rate verifications. + Functions using this service contain + qa_flowrateaudit in the function name. + +10. **Quality Assurance - One Point Quality Control Raw Data**: + Quality assurance data - one point quality control check + raw data. At least every two weeks, certain gaseous + monitors must be challenged with a known concentration to + determine monitor performance. Functions using this + service contain qa_one_point_qc in the function + name. + +11. **Quality Assurance - pep Audits**: + Quality assurance data - performance evaluation program + (pep) audits. pep audits are independent assessments used + to estimate total measurement system bias with a primary + quality assurance organization. Functions using this + service contain qa_pep_audit in the function + name. + +12. **Transaction Sample - AQS Submission data in transaction format (RD)**: + Transaction sample data - The raw transaction sample data + uploaded to AQS by the agency responsible for data + submissions in RD format. Functions using this + service contain transactionsample in the + function name. Transaction sample data is only available + aggregated by site, county, state or monitoring agency. + +13. **Quality Assurance - Annual Performance Evaluations**: + Quality assurance data - Annual performance evaluations. + A performance evaluation must be conducted on each primary + monitor once per year. The percent differences between + known and measured concentrations at several levels are + used to assess the quality of the monitoring data. + Functions using this service contain + aqs_qa_annualperformanceeval in the function + name. Annual performance in transaction format are + only available aggregated by site, county, state, + monitoring agency, and primary quality assurance + organization. Annual performance evaluations are only + available aggregated by site, county, state, + monitoring agency, and primary quality assurance + organization. + +14. **Quality Assurance - Annual performance Evaluations in transaction** \ + **format (RD)**: + Quality assurance data - The raw transaction annual + performance evaluations data in RD format. Functions using + this service contain + aqs_qa_annualperformanceevaltransaction in the + function name. Annual performance evaluations in transaction + format are only available aggregated by site, county, state, + monitoring agency, and primary quality assurance + organization. + + +Data Mart aggregate functions bysite +-------------------------------------- +The pyaqsapi.bysite module exports the following functions: +:: + +* bysite.annualsummary, +* bysite.dailysummary, +* bysite.helperfunctions, +* bysite.monitors, +* bysite.qa_annualpeferomanceeval, +* bysite.qa_annualperformanceevaltransaction, +* bysite.qa_blanks, +* bysite.qa_collocated_assessments, +* bysite.qa_flowrateaudit, +* bysite.qa_flowrateverification, +* bysite.qa_one_point_qc, +* bysite.qa_pep_audit, +* bysite.quarterlysummary, +* bysite.sampledata, +* bysite.transactionsample + +Functions in this family of functions aggregate data at the site level. All + bysite functions accept the following variables: + +* parameter: +* bdate: +* edate: +* stateFIPS: +* countycode: +* sitenum: +* cbdate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata functions and + quarterlysummary functions). +* cedate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata functions and + quarterlysummary functions). +* return_header (optional): set to False by default. +* duration (optional): (This parameter is only used in conjunction with + sampledata functions). + +Data Mart aggregate functions bycounty +---------------------------------------- +The pyaqsapi.bycounty module exports the following functions: +:: + +* bycounty.annualsummary, +* bycounty.dailysummary, +* bycounty.helperfunctions, +* bycounty.monitors, +* bycounty.qa_annualperformanceeval, +* bycounty.qa_annualperformanceevaltransaction, +* bycounty.qa_blanks, +* bycounty.qa_collocated_assessments, +* bycounty.qa_flowrateaudit, +* bycounty.qa_flowrateverification, +* bycounty.qa_one_point_qc, +* bycounty.qa_pep_audit, +* bycounty.quarterlysummary, +* bycounty.sampledata, +* bycounty.transactionsample + +Functions in this family of functions aggregate data at the county level. + All functions accept the following variables: + +* parameter: +* bdate: +* edate: +* stateFIPS: +* countycode: +* cbdate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* cedate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* return_header (optional): set to False by default. +* duration (optional): (This parameter is only used in conjunction with + sampledata functions). + +Data Mart aggregate functions bystate +--------------------------------------- +The pyaqsapi.bystate module exports the following functions: +:: + +* bystate.annualsummary, +* bystate.dailysummary, +* bystate.helperfunctions, +* bystate.monitors, +* bystate.qa_annualperformanceeval, +* bystate.qa_annualperformanceevaltransaction, +* bystate.qa_blanks, +* bystate.qa_collocated_assessments, +* bystate.qa_flowrateaudit, +* bystate.qa_flowrateverification, +* bystate.qa_one_point_qc, +* bystate.qa_pep_audit, +* bystate.quarterlysummary, +* bystate.sampledata, +* bystate.transactionsample + +Functions in this family of functions aggregate data at the state level. + All functions accept the following variables: + +* parameter: +* bdate: +* edate: +* stateFIPS: +* countycode: +* cbdate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* cedate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* return_header (optional): set to False by default. +* duration (optional): (This parameter is only used in conjunction with + sampledata functions). + +Data Mart aggregate functions by Monitoring agency (MA) +------------------------------------------------------- +The pyaqsapi.byma module exports the following functions: +:: + +* byma.qa_annualpeferomanceeval, +* byma.qa_annualperformanceevaltransaction, +* byma.qa_blanks, +* byma.qa_collocated_assessments, +* byma.qa_flowrateaudit, +* byma.qa_flowrateverification, +* byma.qa_one_point_qc, +* byma.qa_pep_audit, +* byma.transactionsample + +Functions in this family of functions aggregate data at the state level. + All functions accept the following variables: + +* parameter: +* bdate: +* edate: +* stateFIPS: +* cbdate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata functions and + quarterlysummary functions). +* cedate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* return_header (optional): set to False by default. +* duration (optional): (This parameter is only used in conjunction with + sampledata functions). + + +functions in this family of functions aggregate data at the Monitoring Agency + (MA) level. All functions accept the following variables: + +* parameter: +* bdate: +* edate: +* MA_code: +* cbdate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* cedate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* return_header (optional): set to False by default. +* duration (optional): (This parameter is only used in conjunction with + sampledata functions). + +Data Mart aggregate functions by Core Based Statistical Area (cbsa) +------------------------------------------------------------------- +The pyaqsapi.bycbsa module exports the following functions: +:: + +* bycbsa.annualsummary, +* bycbsa.dailysummary, +* bycbsa.helperfunctions, +* bycbsa.monitors, +* bycbsa.quarterlysummary, +* bycbsa.sampledata + +Functions in this family of functions aggregate data at the Core Based + Statistical Area (cbsa, as defined by the US Census Bureau) level. + All functions accept the following variables: + +* parameter: +* bdate: +* edate: +* cbsa_code: +* cbdate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* cedate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* return_header (optional): set to False by default. +* duration (optional): (This parameter is only used in conjunction with + sampledata functions). + + +Data Mart aggregate functions by Primary Quality Assurance Organization (pqao) +------------------------------------------------------------------------------ +The pyaqsapi.bypqao module exports the following functions: +:: + +* bypqao.qa_annualperformanceeval, +* bypqao.qa_annualperformanceevaltransaction, +* bypqao.qa_blanks, +* bypqao.qa_collocated_assessments, +* bypqao.qa_flowrateaudit, +* bypqao.qa_flowrateverification, +* bypqao.qa_one_point_qc, +* bypqao.qa_pep_audit + +Functions in this family of functions aggregate data at the Primary Quality + Assurance Organization (pqao) level. All functions accept the following + variables: + +* parameter: +* bdate: +* edate: +* pqao_code: +* return_header (optional): set to False by default. + +Data Mart aggregate functions by latitude/longitude bounding box (bybox) +-------------------------------------------------------------------------- +The pyaqsapi.bybox module exports the following functions: +:: + +* bybox.annualsummary, +* bybox.dailysummary, +* bybox.helperfunctions, +* bybox.monitors, +* bybox.quarterlysummary, +* bybox.sampledata + +Functions in this family of functions aggregate data by a + latitude/longitude bounding box (bybox) level. All functions accept the + following variables: + +* parameter: +* bdate: +* edate: +* minlat: +* minlon: +* maxlon: +* maxlat: +* cbdate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* cedate (optional): (This parameter is only used in conjunction with + sampledata, dailysummary, + annualdata and + quarterlysummary functions). +* return_header (optional): set to False by default. +* duration (optional): (This parameter is only used in conjunction with + sampledata functions). + +pyaqsapi Miscellaneous functions +-------------------------------- + +These are miscellaneous functions exported by pyaqsapi. + +aqs_removeheader is the function that the pyaqsapi library +uses internally to coerce an AQSAPI_V2 object into a pandas DataFrame. +This is useful if the user saves the output from another pyaqsapi function +with return_header = True set but later decides that they want just a +simple pandas DataFrame object. This function takes only one variable: + +* AQSobject: + + diff --git a/docs/modules.rst b/docs/modules.rst index 6610862..6b67e55 100644 --- a/docs/modules.rst +++ b/docs/modules.rst @@ -1,5 +1,5 @@ -pyaqsapi -======== +pyaqsapi Reference API Documentation +==================================== .. toctree:: :maxdepth: 4 diff --git a/docs/pyaqsapi.rst b/docs/pyaqsapi.rst index 05090ed..b2cad20 100644 --- a/docs/pyaqsapi.rst +++ b/docs/pyaqsapi.rst @@ -1,8 +1,30 @@ -pyaqsapi package +pyaqsapi API reference documentation ================ -Submodules ----------- +pyaqsapi base Package +~~~~~~~~~~~~~~~~~~~~~ +.. automodule:: pyaqsapi.helperfunctions + :members: + :undoc-members: + :show-inheritance: + +.. automodule:: pyaqsapi.listfunctions + :members: + :undoc-members: + :show-inheritance: + +.. automodule:: pyaqsapi.metadatafunctions + :members: + :undoc-members: + :show-inheritance: + +.. automodule:: pyaqsapi.setupfunctions + :members: + :undoc-members: + :show-inheritance: + +pyaqsapi Submodules +------------------- pyaqsapi.bybox.bybox module ~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/docs/pycodestlyecheck.txt b/docs/pycodestlyecheck.txt deleted file mode 100644 index e69de29..0000000

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 I`ApmY2iG9gV*mgE diff --git a/docs/_build/doctrees/index.doctree b/docs/_build/doctrees/index.doctree index 17471f924a243c93c2a84490fea62410d233aaae..22128d28e59f3ae28443b69a3ee7f978325ec637 100644 GIT binary patch literal 200722 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 diff --git a/docs/_build/doctrees/manual/pyaqsapiFunctions-Brief.doctree b/docs/_build/doctrees/manual/pyaqsapiFunctions-Brief.doctree index 3c85ba39b7c031ae2e58b4954e231f0b9669e24a..921eb561edad14e1bd58791fc0a01c634b7ff317 100644 GIT binary patch literal 13461 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 RO~s@`EsOt@sm1l$e*x@aF%19! literal 14102 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 diff --git a/docs/_build/doctrees/manual/pyaqsapiFunctions-Long.doctree b/docs/_build/doctrees/manual/pyaqsapiFunctions-Long.doctree new file mode 100644 index 0000000000000000000000000000000000000000..317d3a4637d0737cc5618cb55f3f19e095a14775 GIT binary patch literal 171246 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 J=E!sA{y)C-wmSd- diff --git a/docs/_build/doctrees/pyaqsapi.bycounty.doctree b/docs/_build/doctrees/pyaqsapi.bycounty.doctree deleted file mode 100644 index cc1e1cbc7354da49d358e7e51a3ca15a28e5acac..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 245432 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 z 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 HZTSBK-Cn1^ diff --git a/docs/_build/doctrees/pyaqsapi.byma.doctree b/docs/_build/doctrees/pyaqsapi.byma.doctree deleted file mode 100644 index bc170814495d5ce845f48250706094d9c6c0f4b4..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 134072 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 CaGXg1 diff --git a/docs/_build/doctrees/pyaqsapi.bypqao.doctree b/docs/_build/doctrees/pyaqsapi.bypqao.doctree deleted file mode 100644 index 2e6b3cfff487cce123e9514833138bacbbc61286..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 121017 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