.:pbp viewer:home: Difference between revisions
(Adding information on what the PBP_Viewer is and instructions on how to use it. There are also some warnings for functionality breaks that can be avoided and haven't been coded out yet) |
No edit summary |
||
| Line 2: | Line 2: | ||
== '''Purpose of Program''' == | == '''Purpose of Program''' == | ||
This program was developed to view and analyze individual particle images produced by airborne probes. This program can theoretically work for any group of particle images as long as the particle file is in a format readable by the program. | |||
== '''Setup and Getting Started''' == | == '''Setup --and Getting Started''' == | ||
ADPAA and SODA | |||
Individual download can work too. version stored here in this drive. may not be up to date. has sample data though. | |||
Currently works for ... SODA files | |||
to produce with soda do this | |||
produces .pbp.nc file that can be used | |||
== '''How to Use''' == | == '''How to Use''' == | ||
how to run the program | |||
to get started, you should see a particle images in the bottom left box. to scroll through images, use the << and >>. to exit the program you can click the exit button or the window "X". | |||
To the right of the particle image are three particle attributes. The program initially starts with time, diam, and allin. To change the attributes, click on the "\/" down arrow and you can scroll through the options to pick which attribute you want to see. | |||
The top left box contains filters. The top dropdown menu allows you to select which particle attribute you want to apply a filter to. The boxes below minimum and maximum are for putting in the minimum value and maximum value for the filter range. eg for time you could do 87510 and 87530 where time is in seconds from midnight and runs over 24 hours/86400 seconds. for something like rejectionflag, you can apply a filter of 0, or 4, etc, or a range from 0 to 4, but you can't do something like 0, 4, and 12, it would have to be 0 through 12. Then click the search button | |||
an issue you might run into is that sometimes it's possible to go outside the filter boundaries if the time filter is applied. If this happens, you'll notice a repeating message in the python console that says at max or min boundary. Simply click the arrows in the reverse direction and you will get back to within the filter boundaries. | |||
The top right box has the particle sorter. I RECOMMEND NOT OPENING IT AT THIS TIME. It has a bug that can mess with the data a bit, so that needs to be fixed before it gets used. The particle sorter allows you to manually create attributes to add to the particle. Once the categories are created, you can load them in and all their data. This makes it possible to flag particles as splatters, or if an image clearly contains two partices, then a flag can be added for that as well. You have to be consistent with category names, so make sure to load them in once they've already been created. This also only supports up to 5 additional categories at this time, make sure not to make more, otherwise the 6th and beyond categories will likely be left out. | |||
A 0 means uncategorized, 1 means positively categorized or the particle is true for the category, and 2 means the particle is false for the category and is added as an option if you want to make a distinction between uncategorized and false for the category. | |||
| Line 15: | Line 33: | ||
'''Questions: Q: How do you ensure that SODA2 create the file used by pbp_viewer?''' | '''Questions: Q: How do you ensure that SODA2 create the file used by pbp_viewer?''' | ||
Answer: | Answer: Click the netcdf, then the netcdf image option | ||
Revision as of 15:02, 10 September 2024
pbp_viewer Graphical Plotting Program
Purpose of Program
This program was developed to view and analyze individual particle images produced by airborne probes. This program can theoretically work for any group of particle images as long as the particle file is in a format readable by the program.
Setup --and Getting Started
ADPAA and SODA
Individual download can work too. version stored here in this drive. may not be up to date. has sample data though.
Currently works for ... SODA files to produce with soda do this produces .pbp.nc file that can be used
How to Use
how to run the program
to get started, you should see a particle images in the bottom left box. to scroll through images, use the << and >>. to exit the program you can click the exit button or the window "X".
To the right of the particle image are three particle attributes. The program initially starts with time, diam, and allin. To change the attributes, click on the "\/" down arrow and you can scroll through the options to pick which attribute you want to see.
The top left box contains filters. The top dropdown menu allows you to select which particle attribute you want to apply a filter to. The boxes below minimum and maximum are for putting in the minimum value and maximum value for the filter range. eg for time you could do 87510 and 87530 where time is in seconds from midnight and runs over 24 hours/86400 seconds. for something like rejectionflag, you can apply a filter of 0, or 4, etc, or a range from 0 to 4, but you can't do something like 0, 4, and 12, it would have to be 0 through 12. Then click the search button
an issue you might run into is that sometimes it's possible to go outside the filter boundaries if the time filter is applied. If this happens, you'll notice a repeating message in the python console that says at max or min boundary. Simply click the arrows in the reverse direction and you will get back to within the filter boundaries.
The top right box has the particle sorter. I RECOMMEND NOT OPENING IT AT THIS TIME. It has a bug that can mess with the data a bit, so that needs to be fixed before it gets used. The particle sorter allows you to manually create attributes to add to the particle. Once the categories are created, you can load them in and all their data. This makes it possible to flag particles as splatters, or if an image clearly contains two partices, then a flag can be added for that as well. You have to be consistent with category names, so make sure to load them in once they've already been created. This also only supports up to 5 additional categories at this time, make sure not to make more, otherwise the 6th and beyond categories will likely be left out.
A 0 means uncategorized, 1 means positively categorized or the particle is true for the category, and 2 means the particle is false for the category and is added as an option if you want to make a distinction between uncategorized and false for the category.
Frequently Asked Questions (FAQ)
Questions: Q: How do you ensure that SODA2 create the file used by pbp_viewer?
Answer: Click the netcdf, then the netcdf image option