Introduction to BEE
Displaying 3D reconstruction results is difficult. Often it requires installation of some platform-dependent programs and downloading some pre-formated data. For most physicists, it's too much effort ("Just show me the results!")
BEE is a web-based application intended to solve this problem, and brings the interactive 3D world to the physicists. Some of the features include:
- No installation : Just go to the BEE homepage.
- Cross-platform : Runs everywhere with a modern web browser that supports WebGL, including mobile devices.
- Easy share: Each event has its own url that can be shared with anyone in the world.
- Interactive : Unleashes the power of WebGL with mouse and keyboard.
- Cross experiments: Supports most LArTPC detector geometries.
- Ready for analysis : User uploads, multiple algorithms, MC truth, customizable overlay, etc.
Requirements
The only requirements to run BEE are:
- A modern web browser that supports WebGL. (Will my browser work?) We recommend Google Chrome for the best experience.
- An internet connection.
- A relatively good graphic card. A discrete GPU greatly enhances the performance.
Basic Interactions
The following table summarizes the basic interactions with BEE on different devices:
| Action | Mouse | Keyboard | Touch |
|---|---|---|---|
| Rotate | Left button drag | One-finger touch | |
| Pan | Right button drag | Left / Right / Up / Down | Three-finger swipe |
| Zoom in / Zoom out | Mouse wheel | Shift+Up / Shift+Down | Pinch & Zoom |
Advanced Interactions
Show and Overlay results from different algorithms
Bee supports any algorithms that produce a set of 3D space points (with or without charge). In the right control panel, the "Recon" folder shows the list of algorithms that Bee can load. By default, only the first one is loaded and its space points are displayed on screen. To show others:
- Click on the name of the algorithm. If it is not loaded yet, Bee will download its space points from the server.
- Notice that the left panel now shows the name, size, opacity and color of the current actively selected algorithm.
- Increase the opacity until it is displayed on screen.
- You can now switch to other algorithms to adjust their opacity so that they can be overlayed.
- You may need to uncheck the "Show Charge" checkbox (on the right panel) so that the algorithm can be represented by a single color.
Hotkeys
Users may find it convenient that most actions in BEE can be achieved using keyboard shortcuts. The full list of hot-keys can be found through "Menu -> View -> Hotkey List", and is also summarized below:
| Command | Hotkey | Command | Hotkey |
|---|---|---|---|
| Toggle MC | m | Toggle Charge | q |
| Next Event | Shift+n | Prev Event | Shift+p |
| Next Recon | ] | Prev Recon | [ |
| Next Slice | k | Prev Slice | j |
| Next Flash | > | Prev Flash | < |
| Center to Event | c | Reset Camera | r |
| X-U view | u | X-V view | v |
| X-Z view | z | X-Y view | x |
| Zoom in | Shift+Up | Zoom out | Shift+Down |
| Select Recon | 1 - 9 | Unselect All | Esc |
| Increase Opacity | = | Decrease Opacity | - |
| Increase Point Size | + | Decrease Point Size | _ |
| Redraw All Points | o | Show FPS | s |