This is still a work in progress and mostly for personal use thus far.
pip install -r requirements.txt
Open a 3d image (.tif or .npy) with the GUI using python gui.py "path/to/your/image"
For example: python gui.py "img2.tif". Once in the GUI, you can open previously saved Masks that are saved as npy files. When a button has a keybinding associated with it, it is indicated on the button. Note that you are only working on one cell until you decide to move on to the next one or go to the previous one with the cell counter (<>). That is, you can only add to or erase elements of the current cell. The first image is the xy-view, the second image the xz-view, the third the yz-view. Annotating on the xy-view is recommended, you can then double-check on the other views if there are some inconsistencies. Some useful functions:
Find Cell: Goes to the center of the cell with the highest cell index that was last annotated. Useful if your brain has melted from too much annotation and you want to check if the new color of the brush is different and you are actually working on a new cell or still the old one. It can also help to locate the cell in the other views (xz and yz).
Left click: used for annotating cells; Right click: copy exact coordinates of a cell from one slice. Right clicking again pastes the coordinates of that cell from the last slice (must be the same view). Copy-paste with right-click works regardless of what cell you are working on.
Select Cell: Sometimes you may want to correct an old cell. You can press "S" and then left-click on a cell, which means it is now editable. The "Selected Cell Index" and "Highest Cell Index" reflect that. Once you deselect this button, you will be back to the highest cell index.
Local Contrast Enhancement: In case of a particularly dark/unclear region, you may apply local contrast enhancement. Draw a rectangle on the image after pressing the LCE button, and then press submit. A cuboid in the image volume is now locally enhanced using CLAHE.
All the other functions should be self-explanatory.