{"id":13686428,"url":"https://github.com/nguy/artview","last_synced_at":"2025-10-21T19:41:49.654Z","repository":{"id":21203778,"uuid":"24516568","full_name":"nguy/artview","owner":"nguy","description":"ARM Radar Toolkit Viewer","archived":false,"fork":false,"pushed_at":"2021-12-30T17:56:59.000Z","size":12445,"stargazers_count":48,"open_issues_count":33,"forks_count":21,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-08-03T15:05:18.967Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://nguy.github.io/artview","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nguy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-09-26T21:53:26.000Z","updated_at":"2024-07-12T20:42:00.000Z","dependencies_parsed_at":"2022-08-18T06:21:38.517Z","dependency_job_id":null,"html_url":"https://github.com/nguy/artview","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nguy%2Fartview","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nguy%2Fartview/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nguy%2Fartview/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nguy%2Fartview/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nguy","download_url":"https://codeload.github.com/nguy/artview/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224250216,"owners_count":17280522,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-02T15:00:32.293Z","updated_at":"2025-10-21T19:41:44.611Z","avatar_url":"https://github.com/nguy.png","language":"Python","readme":"ARTview\n=======\n\nARM Radar Toolkit Viewer\n\nARTview is an interactive GUI viewer that is built on top of the\n[Py-ART](https://github.com/ARM-DOE/pyart) toolkit.\nIt extends Py-ART by allowing the user to visualize, query, and modify data\non the fly within a self-contained environment, accessing individual or entire\ndirectories of data files.  All file types available in Py-ART can be opened with\nthe ARTview browser.\n\nInteraction with data files is through \"Plugins\". These include many functions from\nthe Py-ART package which can be selected. In addition, native ARTview plugins are provided\nto query data and select regions or points visually and more.\n\n[![DOI](https://zenodo.org/badge/doi/10.5281/zenodo.47224.svg)](http://dx.doi.org/10.5281/zenodo.47224)\n\n![Screenshot](https://github.com/nguy/ARTview/blob/master/ARTview_Screenshot.png)\n\nARTview highlights:\n\n    Dynamically switch fields (variables) and tilt angles via drop down menu.\n\n    Dynamically switch tilt angle via radio button selection.  Also easily change\n    by using the up/down arrow keys.\n\n    Browse a directory using the FileNavigator menu or left/right arrow keys.\n\n    View surface-based or (some) airborne radar files.\n\n    View (and switch between) PPI, sector or RHI type file scans.\n\n    Change display parametets such as scaling, title, units labels, colormap,\n    and add range rings.\n\n    Save output images from a drop-down menu (Or Ctrl+s on linux, Cmd+S on MacOS).\n\n    Use Py-ART auxilary file readers by right clicking a file in the FileList.\n\n    Display toolbox which allows Zooming/Panning, find point values, select regions.\n\n    The default two windows can be configured to share parameters or operate independently.\n\n    Run automated correction routines.\n\n    Hand-edit data files.\n\n    Write your own plugins to use.\n\n## Links\n[Code repository](https://github.com/nguy/ARTview)\n\n[Documentation](https://rawgit.com/nguy/ARTview/master/docs/build/html/index.html)\n\n[User Forum](https://groups.google.com/forum/#!forum/ARTview-users)\n\n[Issues](https://github.com/nguy/ARTview/issues)\n\n[Py-ART](https://github.com/ARM-DOE/pyart)\n\n## News\nSome minor bugs have been addressed to improve performance of plugins.\nThe menu has undergone a facelift to make it easier to understand the tools\nin ARTview. More user-friendly interfaces have been deployed to improve the\nexperience.\n\nA number of editing tools have now been linked (from Py-ART) and developed\ninternally. There remains further functionality development, so keep an eye\nout for new features.\nIt has performed well in internal testing, but if you find bugs in\nthere, we appreciate your help in finding and addressing them.\n\n## Tutorials\nPaul Hein has put together a [brief introduction](http://radarmet.atmos.colostate.edu/software/ARTview/).\nAnderson Gama has made a [video introduction](https://www.youtube.com/watch?v=iaNoGZTUhg4) to ARTview 1.0\nas well as [video tutorials](https://www.youtube.com/watch?v=B_BmYV7GdCA\u0026list=PLCmWx9EHGvfIrvrYSTpHrEqdVVjvKi4SF)\nto ARTview 1.2.\n\n## Install\n\nThe easiest method for installing ARTview is to use the conda packages from\nthe latest release.  To do this you must download and install\n[Anaconda](http://continuum.io/downloads) or\n[Miniconda](http://continuum.io/downloads).\nThen use the following command in a terminal or command prompt to install\nthe latest version of ARTview::\n\n    conda install -c conda-forge artview\n\nTo update an older version of ARTview to the latest release use::\n\n    conda update -c conda-forge ARTview\n\nIf you do not wish to use Anaconda or Miniconda as a Python environment or want\nto use the latest, unreleased version of ARTview see the section below on\n**Installing from source**.\n\n## Installing from source\n\nInstalling ARTview from source is the only way to get the latest updates and\nenhancements to the software that have not yet made it into a release.\nThe latest source code for ARTview can be obtained from the GitHub repository,\nhttps://github.com/nguy/ARTview.  Either download and unpack the\nsource code [zip file](https://github.com/nguy/ARTview/archive/master.zip) or\nuse git to checkout the repository::\n\n    git clone https://github.com/nguy/ARTview.git\n\nTo install in your home directory, use::\n\n    python setup.py install --user\n\nTo install for all users on Unix/Linux::\n\n    python setup.py build\n    sudo python setup.py install\n\n\n## Usage\nEither cd into the installed folder and run:\n\n```python\npython ARTview -d /some/directory/you/want/to/point/to\n```\n\nOr it can be run from anywhere with the following:\n\n```python\nARTview\n```\n\nA specific file can be loaded:\n```python\nARTview -F /some/directory/you/want/to/point/to/filename\n```\n\nA specific field (e.g. reflectivity) can be loaded:\n```python\nARTview -f 'reflectivity'\n```\n\nUse a different start-up script with -s\n```python\nARTview -s radar\n```\nThere are several [predefined scripts](SCRIPTS.md) that you can use, but you\ncan also [write your own](https://rawgit.com/nguy/ARTview/master/docs/build/html/script_tutorial.html).\n\nTo see other command line options:\n```python\nARTview -h\n```\n\nARTview should be able to recognize and correctly handle PPI, RHI and airborne files.\n\nThe default startup uses radar reflectivity and checks for a few common names.\nIf you find a file with a field that does not load, let us know and we can add it\nto the list.\n\n\n## Dependencies\n[Py-ART](https://github.com/ARM-DOE/pyart) \u003e= 1.6\n\n[matplotlib](http://matplotlib.org) \u003e= 1.1.0\n\n[Basemap](http://matplotlib.org/basemap) \u003e= 0.99\n\n[PyQt4](http://www.riverbankcomputing.co.uk/software/pyqt/intro) \u003e= 4.6\n\nMake sure that `matplotlib` is loading `PyQt4` as backend, for testing that execute `python test/qt.py`.\n\nIt is recommended to keep your Py-ART package updated, as new features may rely\nupon new code in Py-ART.\n\nAlso for a more smooth user experience we recomend to [configure pyart](http://arm-doe.github.io/pyart-docs-travis/user_reference/generated/pyart.load_config.html#pyart.load_config)\nto match the kind of files used as well as persornal preferences.\n\nDeveloped on Python 2.7.7 and 2.7.9 :: Anaconda 2.0.1 and 2.1.0\n\nARTview has been tested on:\nMacOSX 10.9.4, 10.10.2, 10.10.4\nLinux Debian (Jessie)\nLinux Red Hat (RHEL6)\n\nIt is  **strongly** encouraged to use Python 2.7 or above. There are minor issues with\nPython 2.6 operability that keep popping up. We make no guarantees that 2.6 will\nwork properly.\n\n**WARNING** ARTview has been upgraded to use PyQt5. There is a known issue working with an\nenvironment that uses Python 3 and PyQt5 on MacOSX (Linux seems to work fine).\nARTview defaults to PyQt4 if available, so it is highly recommended that you\ninstall PyQt4 if it is not already on your systems.\nWe cannot guarantee that ARTview will work with PyQt5, but will update as fixes\nbecome available.\n\nTo install a version of of PyQt4, for example if using conda:\n```\nconda install pyqt=4.11.4\n```\n\n## User Forum\n\nFor questions on the use of ARTview please write in the [mailing list](https://groups.google.com/forum/#!forum/ARTview-users),\nor for a bug report please submit an [Issue](https://github.com/nguy/ARTview/issues). We appreciate all feedback.\n\n## Contributors\n\n[Anderson Gama](https://github.com/gamaanderson)\n\n[Nick Guy](https://github.com/nguy)\n\nPaul Hein\n\nJonathan Helmus\n\nTimothy Lang\n\n## Acknowledgements\nWe would like to thank members of [conda-forge](https://github.com/conda-forge) for ensuring a working artview-feedstock for distribution.\n\n## Disclaimer\nThis is open source software and we love contributions!\nThis is not a primary project for any of the contributors, so please be patient\nif you have questions/suggestions.  In addition it needs to be stated that no\nresponsibility is taken by the authors for any adverse effects.\n\n## Special Note\nIcons used in ```FileNavigator``` were created by oxygenicons (http://www.oxygen-icons.org/)\nand distributed at the IconArchive (http://www.iconarchive.com) under\nthe GNU Lesser General Public License.\n","funding_links":[],"categories":["Radar"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnguy%2Fartview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnguy%2Fartview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnguy%2Fartview/lists"}