Package: aqstat
AQStataqstatis a command line Python tool for visualizing air quality data collected under theluftdaten.infoproject.Installaqstatis written in Python, so installation and usage is platform-independent.RequirementsInstall gitGet Python 3.7 or laterIf you need the latest development version or you wish to modify the code, installPoetryas well.Install latest release from PyPIThe latest release is hosted at thePython Package Index (PyPI). To installaqstatfrom there, simply run:pip install aqstatInstall latest source from GitHubThe latest development code is available atGitHub. Installation should be as simple as running the following:git clone https://github.com/vasarhelyi/aqstat.git
cd aqstat
poetry installAsaqstatuses Poetry, all Python package dependencies will be installed automatically in a local virtual environment under.venvin the project folder.UsageBasic usageRunaqstat --helpto get a quick overview on the usage ofaqstat. There are three basic commands currently available:downloadhelps you retreive air quality sensor data from the net to your local computer for later analysisplotlets you visualize air quality data of selected sensorsstatgenerates various statistical outputs for selected sensorsAn additionaltestcommand is provided as a development section to test different work-in-progress stuff.More detailed help on individual commands is also available. For example, runaqstat download --helpto get help on data download options.To get some examples on usage, check out thedoc\examples\commands.mdfile.Usage with PoetryTo executeaqstatusing Poetry, typepoetry run aqstatfrom the cloned project folder.Sensor databaseLocal sensor data is stored in folders named after sensor IDs. There are two basic data sources supported currently, a bit of a problem is that they use different IDs for different sensors (madavi.de uses a singlechip_id, sensor.community uses asensor_idfor all sensors in a given measurement unit. Furthermore, these two sources store slightly different information about the sensors.To obtain a general easy-to-use reference for all sensor data, a local description of all sensors can be given optionally. A simple JSON format is used for that, please check out thedoc\examples\metadata.jsonfile as an example how to fill the JSON form for a single sensor, or use thescripts\convert_luftdaten_csv_to_metadata_json.pyscript to generate .json files from the sensor data directly.The overall sensor database structure should look like something like this:12345/
67890/
Budapest-12345.json
Verőce-67890.jsonThe name of the.jsonfiles is arbitrary, it is useful to include human readable information, such as the location of the sensor, as in the example above.Later on, during the usage of theplotandstatcommands, filters can be defined and several outputs can be generated based on various properties given in the .json files.Contact and collaborationaqstatis made public and open-source to help each other in fighting air pollution. Pleasecontactif you have any questions on usage, something is not working properly, you have new ideas or feature requests or if you would like to help in development or collaboration or wish to support the project in any way.