Metadata-Version: 2.1
Name: solarannotator
Version: 1.0.1
Summary: A tool to annotate images of the Sun
Home-page: 
Author: J. Marcus Hughes
Author-email: j-marcus.hughes@noaa.gov
Description-Content-Type: text/markdown
Requires-Dist: PyQt5
Requires-Dist: matplotlib
Requires-Dist: astropy
Requires-Dist: numpy
Requires-Dist: goes-solar-retriever
Requires-Dist: scipy
Requires-Dist: scikit-image
Requires-Dist: pillow
Requires-Dist: sunpy
Requires-Dist: lxml
Requires-Dist: reproject
Requires-Dist: zeep
Requires-Dist: drms

# Solar Annotator
[![CodeFactor](https://www.codefactor.io/repository/github/jmbhughes/solarannotator/badge)](https://www.codefactor.io/repository/github/jmbhughes/solarannotator)
[![PyPI version](https://badge.fury.io/py/solarannotator.svg)](https://badge.fury.io/py/solarannotator)

A tool for annotating solar images with themes. 

## Install
It's best to install in a clean virtual environment to avoid package conflicts or incorrect versions. 

On a Mac or Linux machine:
```
python -m venv venv
source venv/bin/activate
pip install solarannotator
```

On a Windows machine:
```
py -m venv venv
.\venv\Scripts\activate
py -m pip install solarannotator
```

For more details [visit the Packaging guide](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/#creating-a-virtual-environment).

## Running and usage
Execute from the terminal after installing by running inside your virtual environment.
```SolarAnnotator```

This launches the main software:
![Screenshot of tool](https://github.com/jmbhughes/solarannotator/blob/master/screenshot.png)

On the left hand side, you will see a preview that can be maniuplated with the controls below. 
It allows for viewing different SUVI channels with different configurations, e.g. one color versus three color. 
The preview controls allow you to select the minimum and maximum percentile shown as well as scale
the image by raising all pixels to the selected power.

You interact by drawing on the preview image to create new regions in the thematic map. You can also
relabel those patches by left-clicking in the thematic map with a new theme selected. Finally, you can see
boundaries of regions from the thematic map back in the preview image by right clicking the thematic map. 

## Future
This tool is still under development. There are many features coming. 
- [x] Ability to scale a single color image
- [x] Ability to scale in a three color image   
- [x] Right click on a region in the thematic map and see its boundary in the preview
- [x] Left click on a region in the thematic map to re-annotate all the contiguous pixels
- [x] Undo annotations
- [x] Differentiate save and save as
- [x] Add color legend to radio buttons
- [ ] Redo annotations, after ctrl-z
- [ ] Overlay HEK and other pre-determined annotations
- [ ] Multiple normalization options
- [ ] Robustify the thematic map io for better metadata passing, also use SunPy maps
- [ ] Add a help guide
- [ ] Add an ability to load a template when you create a new date
