Differences

This shows you the differences between two versions of the page.

--- atmos:citation:research:using_the_particle_by_particle_viewer_pbp_viewer.py [2024/08/21 18:18] – klinman
+++ atmos:citation:research:using_the_particle_by_particle_viewer_pbp_viewer.py [2024/08/23 15:29] (current) – klinman
@@ Line 34: / Line 34: @@
 {{:atmos:citation:research:pbp_particlesorterunopened.png?400|}}
+  * Click to open particle sorter. The particle sorter is designed to specify categories to organize particles into and save to the pbp file that is open in the program. This means it adds a variable to the netcdf file. The exact format is still being developed.
 {{:atmos:citation:research:pbp_sorter_opened.png?400|}}
+  * "File and Commands": Still in development. Currently it can almost save the user-defined categories to the pbp file. Will include an open (doesn't need to be made actually should automaticallty open if categories are already defined. The close file should be useless then.... oh well i guess it'll just be a save categories then since the data is automatically going to be saved to the file.
+  * "Click for warning": Instructs you to save the category names to the file before origanizing particle in order to set up the new variable and any new categories that are being added.
+  * "add row": Adds a row to name or load a category and sets up the categorization buttons.
+  * "Toggle Bindings": Once the categories are defined/loaded, you can select this button to disable typing in the category boxes, and bind keys to each row for more convenient sorting instead of having to use the mouse to select everything. The buttons are "1, 2, 3, 4, 5" and "q, w, e, r, t". They will be described with the next picture.
 {{:atmos:citation:research:pbp_sorter_using.png?400|}}
+  * Here you can see that three rows/categories have been added to the file.
+  * All the categories automatically start out with a value of -1. -1 means the particle is uncategorized. If you click "add" the value goes up 1 to a 0. 0 means that the particle is false for that category. Count up one more to 1, and 1 means that the particle is true for that category. All these values are shown on the right hand side of the box. "remove" counts down.
+  * When you toggle the bindings (with the "Toggle Bindings" button), the entry boxes containing the categories are disabled, and "1, 2, 3, 4, 5" and  "q, w, e, r, t" are binded respectively to the first through fifth row. Using "1 , 2, 3, 4, 5" counts up, and "q, w, e, r, t" count down.
+  * HOW THE DATA IS SAVED.
+      * Once the particle is categorized to your satisfaction, click on the forward or back (or use the right and left arrow keys if toggled on) arrow at the bottom of the PBP_Viewer window, and the particle categorization will be saved.
+Troubleshooting section?
+A note to include when finishing this guide. Should just work on linux. windows has issue with opening files as r+ which allows edits to made to the file which is what happens with the sorter. Making a copy of the file and running the program with the copy seemed to fix that issue. Looked like both the original and copy files had write permissions so im not sure what exactly the problem was.