Application License [](https://www.gnu.org/licenses/gpl-3.0)
Works on both Linux [](https://svgshare.com/i/Zhy.svg) and Windows [](https://svgshare.com/i/ZhY.svg). Mac OS [](https://svgshare.com/i/ZjP.svg) support is available via `conda`.
Status of Documentation [](https://wrfplot.readthedocs.io/en/latest/?badge=latest)
Details of PyPi package [](https://pypi.python.org/pypi/wrfplot/) [](https://pepy.tech/project/wrfplot)
Status of builds  
Conda details    
## About wrfplot
**wrfplot** is a command line application written in Python programming language to plot set of diagnostic variables from World Research and Forecasting (WRF) atmospheric model output file. Though, WRF model output files are simple NetCDF, it requires one to install various software and libraries to plot a few variables. Python has many modules that can deal with WRF model output data set. However, setting up theses libraries, plotting variables through reading lot of documentation is tedious process. **wrfplot** aims to fill this gap by proving an application that is easy to install and use.
The idea of developing wrfplot came to my mind as I frequently revisit the same code base again and again to tweak few lines of code to get changes in final plots. Therefore, I was looking for a command line application that would help me to tweak the common WRF model forecast images by providing appropriate command line options. I could not find any and hence created one.
## Documentation
Documentation of this project is located at https://wrfplot.readthedocs.io.
## Use Cases
A typical use case of wrfplot would be to include as part of your WRF model run framework to plotting of variables immediately after the model run is completed. The other use case would be to use it for producing publication quality 2D maps which does not much tweaking for your publication.
## Installation on all Platforms (Windows, Linux and Mac OS)
Support for all platforms is provided through `conda-forge`. If you have already conda installed, then following command is enough to install `wrfplot`:
```
conda install -c cond-forge wrfplot
```
Check your installation by typing following command which should show the version number:
```
wrfplot --version
0.1.0
```
## Binary (standalone) Installation
Since it is intended to be used as command line, the application is also distributed as stand-alone on both Linux and Windows. You must download the correct version of application installer or setup file. Both are described below:
### Windows Only
Go to https://github.com/wxguy/wrfplot/releases and look for latest release. The Windows setup executable will have name `wrfplot-windows-64bit.exe`. Click on the link and download it to local disk. The rest of the installation procedure is same as you do for any other windows setup files. Once installed Check if installation is successful by typing following command in `cmd` window which should not produce any errors:
```
wrfplot --version
0.1.0
```
### Linux Only
You must have at least `Ubuntu 22.04` or above for this to work. There is no additional packages or admin rights are required to install this package. Go to https://github.com/wxguy/wrfplot/releases and look for latest release. The Linux installer will have name `wrfplot-linux-64bit.run`. Click on the link and download it to local disk. Thereafter execute the below command (assuming that the Linux installer is downloaded at `~/Downloads`):
```
bash ~/Downloads/wrfplot-linux-64bit.run
```
that would produce the output as indicated below:
```
Verifying archive integrity... 100% MD5 checksums are OK. All good.
Uncompressing wrfplot_Linux_Installer 100%
Removing previous install directory...
Installing wrfplot to /home/wxguy/.wrfplot...
Renaming '/home/wxguy/wrfplot' directory to '/home/wxguy/.wrfplot'..
'/home/wxguy/.local/bin' directory already exists. Not creating it.
Linking wrfplot executable...
Updating .bashrc file to include install directory...
/home/wxguy/.local/bin directory already added to PATH. Skipping...
Installation completed. Please restart your terminal to continue using wrfplot...
```
Once installed Check if installation is successful by typing following command in terminal which should not produce any errors:
```
wrfplot --version
0.1.0
```
### Mac OS Only
At the moment, Mac OS support is not available in binary format. You can install `wrfplot` using method mentioned above.
## How to use?
Please refer to https://wrfplot.readthedocs.io for complete documentation on how to use `wrfplot` application.
## TODO
Add following command line options:
* ~~`--cmap` : Use user provided colour map~~
* ~~`--ulevels ` : To plot upper level data as per user defined upper levels~~
* `--clevels ` : Control contour levels
* `--animation` : Create animation for specific variable(s) in GIF for max compatibility
* `--save-format`: Save image in specific file format
* `--list-save-format` : List all supported image file format
* `--title` : Custom title for the plot
* `--title-font-size` : Specify title font size
## Author
J Sundar aka WxGuy (wrf.guy@gmail.com)
Raw data
{
"_id": null,
"home_page": "https://github.com/wxguy/wrfplot",
"name": "wrfplot",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7.0",
"maintainer_email": "",
"keywords": "Scientific,Engineering,Atmospheric Science,Weather Model,Plotting,Software Development,Numerical Weather Prediction,NWP",
"author": "J Sundar",
"author_email": "J Sundar <wrf.guy@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/f3/e0/6de661a678e5e2ae4b9fc85c8d89a381226c4233be961e9ae9b77c34c2f9/wrfplot-0.9.2.tar.gz",
"platform": null,
"description": "Application License [](https://www.gnu.org/licenses/gpl-3.0)\n\nWorks on both Linux [](https://svgshare.com/i/Zhy.svg) and Windows [](https://svgshare.com/i/ZhY.svg). Mac OS [](https://svgshare.com/i/ZjP.svg) support is available via `conda`.\n\nStatus of Documentation [](https://wrfplot.readthedocs.io/en/latest/?badge=latest)\n\nDetails of PyPi package [](https://pypi.python.org/pypi/wrfplot/) [](https://pepy.tech/project/wrfplot)\n\nStatus of builds  \n\nConda details    \n\n## About wrfplot\n\n**wrfplot** is a command line application written in Python programming language to plot set of diagnostic variables from World Research and Forecasting (WRF) atmospheric model output file. Though, WRF model output files are simple NetCDF, it requires one to install various software and libraries to plot a few variables. Python has many modules that can deal with WRF model output data set. However, setting up theses libraries, plotting variables through reading lot of documentation is tedious process. **wrfplot** aims to fill this gap by proving an application that is easy to install and use. \n\nThe idea of developing wrfplot came to my mind as I frequently revisit the same code base again and again to tweak few lines of code to get changes in final plots. Therefore, I was looking for a command line application that would help me to tweak the common WRF model forecast images by providing appropriate command line options. I could not find any and hence created one.\n\n## Documentation\n\nDocumentation of this project is located at https://wrfplot.readthedocs.io.\n\n## Use Cases\n\nA typical use case of wrfplot would be to include as part of your WRF model run framework to plotting of variables immediately after the model run is completed. The other use case would be to use it for producing publication quality 2D maps which does not much tweaking for your publication.\n\n## Installation on all Platforms (Windows, Linux and Mac OS)\n\nSupport for all platforms is provided through `conda-forge`. If you have already conda installed, then following command is enough to install `wrfplot`:\n\n```\nconda install -c cond-forge wrfplot\n```\nCheck your installation by typing following command which should show the version number:\n\n```\nwrfplot --version\n0.1.0\n```\n\n\n## Binary (standalone) Installation\n\nSince it is intended to be used as command line, the application is also distributed as stand-alone on both Linux and Windows. You must download the correct version of application installer or setup file. Both are described below:\n\n### Windows Only\n\nGo to https://github.com/wxguy/wrfplot/releases and look for latest release. The Windows setup executable will have name `wrfplot-windows-64bit.exe`. Click on the link and download it to local disk. The rest of the installation procedure is same as you do for any other windows setup files. Once installed Check if installation is successful by typing following command in `cmd` window which should not produce any errors:\n\n```\nwrfplot --version\n0.1.0\n```\n\n### Linux Only\n\n You must have at least `Ubuntu 22.04` or above for this to work. There is no additional packages or admin rights are required to install this package. Go to https://github.com/wxguy/wrfplot/releases and look for latest release. The Linux installer will have name `wrfplot-linux-64bit.run`. Click on the link and download it to local disk. Thereafter execute the below command (assuming that the Linux installer is downloaded at `~/Downloads`):\n\n ```\n bash ~/Downloads/wrfplot-linux-64bit.run\n ```\n\n that would produce the output as indicated below:\n\n ```\nVerifying archive integrity... 100% MD5 checksums are OK. All good.\nUncompressing wrfplot_Linux_Installer 100% \nRemoving previous install directory...\nInstalling wrfplot to /home/wxguy/.wrfplot...\nRenaming '/home/wxguy/wrfplot' directory to '/home/wxguy/.wrfplot'..\n'/home/wxguy/.local/bin' directory already exists. Not creating it.\nLinking wrfplot executable...\nUpdating .bashrc file to include install directory...\n/home/wxguy/.local/bin directory already added to PATH. Skipping...\nInstallation completed. Please restart your terminal to continue using wrfplot...\n```\n\nOnce installed Check if installation is successful by typing following command in terminal which should not produce any errors:\n\n```\nwrfplot --version\n0.1.0\n```\n\n### Mac OS Only\n\nAt the moment, Mac OS support is not available in binary format. You can install `wrfplot` using method mentioned above.\n\n## How to use?\n\nPlease refer to https://wrfplot.readthedocs.io for complete documentation on how to use `wrfplot` application.\n\n\n## TODO\n\nAdd following command line options:\n\n* ~~`--cmap` : Use user provided colour map~~\n* ~~`--ulevels ` : To plot upper level data as per user defined upper levels~~\n* `--clevels ` : Control contour levels\n* `--animation` : Create animation for specific variable(s) in GIF for max compatibility\n* `--save-format`: Save image in specific file format\n* `--list-save-format` : List all supported image file format\n* `--title` : Custom title for the plot\n* `--title-font-size` : Specify title font size\n\n## Author\n\nJ Sundar aka WxGuy (wrf.guy@gmail.com)\n",
"bugtrack_url": null,
"license": "GPL3",
"summary": "Command line application to plot WRF model output data",
"version": "0.9.2",
"split_keywords": [
"scientific",
"engineering",
"atmospheric science",
"weather model",
"plotting",
"software development",
"numerical weather prediction",
"nwp"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f3e06de661a678e5e2ae4b9fc85c8d89a381226c4233be961e9ae9b77c34c2f9",
"md5": "5da2c45b0fac7d453bc6b3f9bb6afa08",
"sha256": "9c398c65994676c04f3447bb4c55642a2a08a6a6cac629e9f08a79e56a885cea"
},
"downloads": -1,
"filename": "wrfplot-0.9.2.tar.gz",
"has_sig": false,
"md5_digest": "5da2c45b0fac7d453bc6b3f9bb6afa08",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7.0",
"size": 54752380,
"upload_time": "2023-02-11T16:27:40",
"upload_time_iso_8601": "2023-02-11T16:27:40.075137Z",
"url": "https://files.pythonhosted.org/packages/f3/e0/6de661a678e5e2ae4b9fc85c8d89a381226c4233be961e9ae9b77c34c2f9/wrfplot-0.9.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-02-11 16:27:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"github_user": "wxguy",
"github_project": "wrfplot",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "wrfplot"
}
JSON
