# GPlume
This repository contains a Python implementation of the Gaussian Plume Model for atmospheric dispersion of contaminants (PM2.5), along with an inverse modeling approach to estimate emission rates from receptor measurements. The model calculates the contaminant concentration at receptor locations based on emission rates and wind conditions. It assumes 4 sources, which can be customized according to the code that generates an input box. This code works for multiple sources and multiple receptors.
## Code Description
The main code file `gpm.py` includes the following components:
1. Contaminant Parameters: Set the parameters related to the contaminant being modeled, such as gravitational acceleration, dynamic viscosity of air, density of the contaminant, diameter of particles, deposition velocity, and molar mass of the contaminant.
2. Source and Receptor Data: Define the locations and characteristics of the emission source and receptors where deposition measurements are made. This includes the number of sources, x-y-z coordinates, labels, and emission rates.
3. `gplume` Function: This function computes the contaminant concentration (in kg/m^3) at a given set of receptor locations using the standard Gaussian plume solution. It takes into account the source characteristics, receptor locations, and wind speed.
4. `forward_atmospheric_dispersion` Function: This function calculates and plots the ground-level contaminant concentration contours based on the Gaussian Plume Model. It takes the wind speed as an input and calls the `gplume` function to calculate the concentrations. The resulting contours are displayed using the `matplotlib` library.
The `inverse.py` file introduces an inverse modeling approach to estimate emission rates from observed contaminant concentrations at receptor locations. The key components in this file are:
1. `ermak` Function: This function computes the contaminant concentration at receptor locations using the Ermak dispersion model. It takes into account the emission rates, wind speed, and other parameters.
2. Objective Function: The `objective_function` calculates the difference between predicted and observed contaminant concentrations based on the Ermak model. It sets up an optimization problem to find the optimal emission rates that minimize this difference.
3. Optimization: The `minimize` function from the `scipy.optimize` module is used to find the optimal emission rates that best fit the observed receptor measurements.
## Installing
Install and update from PyPI using an installer such as pip:
```python
$ pip install -U gplume
```
## A Simple Example
```python
# Compute and plot forward modeling
from gplume import gpm
```
```python
# Compute and plot inverse modeling
from gplume import inverse
```
## Contributing
Contributions to this project are welcome. If you find any issues or have suggestions for improvements, feel free to create a pull request or submit an issue on the GitHub repository. https://github.com/VaibhavVasdev/Gaussian-Plume_Model
## Contact
For any inquiries or questions, please contact Vaibhav Vasdev at vaibhavvasdev63@gmail.com.
Raw data
{
"_id": null,
"home_page": "https://github.com/VaibhavVasdev/Gaussian-Plume_Model",
"name": "gplume",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "GaussianPlumeModel",
"author": "Vaibhav Vasdev",
"author_email": "vaibhavvasdev63@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/fe/1e/6ad622ebaf1ac7b73ba732ec85e67991946110c28ab134f0590143bd31c0/gplume-1.0.0.tar.gz",
"platform": null,
"description": "# GPlume\n\nThis repository contains a Python implementation of the Gaussian Plume Model for atmospheric dispersion of contaminants (PM2.5), along with an inverse modeling approach to estimate emission rates from receptor measurements. The model calculates the contaminant concentration at receptor locations based on emission rates and wind conditions. It assumes 4 sources, which can be customized according to the code that generates an input box. This code works for multiple sources and multiple receptors.\n\n\n## Code Description\n\nThe main code file `gpm.py` includes the following components:\n\n1. Contaminant Parameters: Set the parameters related to the contaminant being modeled, such as gravitational acceleration, dynamic viscosity of air, density of the contaminant, diameter of particles, deposition velocity, and molar mass of the contaminant.\n\n2. Source and Receptor Data: Define the locations and characteristics of the emission source and receptors where deposition measurements are made. This includes the number of sources, x-y-z coordinates, labels, and emission rates.\n\n3. `gplume` Function: This function computes the contaminant concentration (in kg/m^3) at a given set of receptor locations using the standard Gaussian plume solution. It takes into account the source characteristics, receptor locations, and wind speed.\n\n4. `forward_atmospheric_dispersion` Function: This function calculates and plots the ground-level contaminant concentration contours based on the Gaussian Plume Model. It takes the wind speed as an input and calls the `gplume` function to calculate the concentrations. The resulting contours are displayed using the `matplotlib` library.\n\n\n\nThe `inverse.py` file introduces an inverse modeling approach to estimate emission rates from observed contaminant concentrations at receptor locations. The key components in this file are:\n\n1. `ermak` Function: This function computes the contaminant concentration at receptor locations using the Ermak dispersion model. It takes into account the emission rates, wind speed, and other parameters.\n\n2. Objective Function: The `objective_function` calculates the difference between predicted and observed contaminant concentrations based on the Ermak model. It sets up an optimization problem to find the optimal emission rates that minimize this difference.\n\n3. Optimization: The `minimize` function from the `scipy.optimize` module is used to find the optimal emission rates that best fit the observed receptor measurements.\n\n\n## Installing\n\nInstall and update from PyPI using an installer such as pip:\n\n```python\n$ pip install -U gplume\n```\n\n## A Simple Example\n\n```python\n# Compute and plot forward modeling\nfrom gplume import gpm\n```\n\n```python\n# Compute and plot inverse modeling\nfrom gplume import inverse\n```\n\n## Contributing\n\nContributions to this project are welcome. If you find any issues or have suggestions for improvements, feel free to create a pull request or submit an issue on the GitHub repository. https://github.com/VaibhavVasdev/Gaussian-Plume_Model\n\n## Contact\n\nFor any inquiries or questions, please contact Vaibhav Vasdev at vaibhavvasdev63@gmail.com.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "The Gaussian Plume Model for atmospheric dispersion and inverse modeling of contaminants with support for multiple sources and receptors.",
"version": "1.0.0",
"project_urls": {
"Homepage": "https://github.com/VaibhavVasdev/Gaussian-Plume_Model"
},
"split_keywords": [
"gaussianplumemodel"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8c00dc9bcc84c5a712d2dc8b85ca63c339a69b8368574f6e503b9ba3ac6a23fe",
"md5": "a576db6795bb3a352339b689ed717a10",
"sha256": "798589ef2fb0111e63dfa0f3e4daae7c25ca6f0e998e08a66acf832003355ea9"
},
"downloads": -1,
"filename": "gplume-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a576db6795bb3a352339b689ed717a10",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 3165,
"upload_time": "2024-07-19T19:28:35",
"upload_time_iso_8601": "2024-07-19T19:28:35.467756Z",
"url": "https://files.pythonhosted.org/packages/8c/00/dc9bcc84c5a712d2dc8b85ca63c339a69b8368574f6e503b9ba3ac6a23fe/gplume-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fe1e6ad622ebaf1ac7b73ba732ec85e67991946110c28ab134f0590143bd31c0",
"md5": "b9a0900157041aec06790b3ca87e22e9",
"sha256": "7a405158d79d63c4771bf460fbb0b49a1a708e1b37a826dce2e2c1d8266caa80"
},
"downloads": -1,
"filename": "gplume-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "b9a0900157041aec06790b3ca87e22e9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 3151,
"upload_time": "2024-07-19T19:28:36",
"upload_time_iso_8601": "2024-07-19T19:28:36.954156Z",
"url": "https://files.pythonhosted.org/packages/fe/1e/6ad622ebaf1ac7b73ba732ec85e67991946110c28ab134f0590143bd31c0/gplume-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-19 19:28:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "VaibhavVasdev",
"github_project": "Gaussian-Plume_Model",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "gplume"
}
JSON
