Artist Guide¶
Some artists are complex and have many options. These are explained here.
Particles¶
Visualizes individual or collections of I3Particles.
- color by type
For simulated events only. Display discrete muon energy losses by type. The color scheme is defined as red: bremsstrahlung, green: delta-rays, blue: electron pairs, magenta: hadron photoproduction. For more information see the Atmospheric Muon and PROPOSAL papers.
- show light fronts
Visualizes energy losses as expanding light fronts. The visualization is based on a simple light front model and should not be regarded as a physically accurate representation.
- blue light fronts
Visualize light fronts (see previous option) in Cherenkov blue, otherwise use the color from the time line.
- Cherenkov cone size
Draw a Cherenkov cone.
- incoming/outgoing
For tracks that are stopping, starting, or contained, draw dashed extensions in the incoming and/or outgoing direction.
- labels
Draw labels that show the particle energy. They are only shown if the camera is very close to the particle.
- min. energy [track]
Minimum energy (in GeV) for simulated and reconstructed tracks. Increasing the value may help when displaying very energetic simulated events that take a long time to render, or to enhance high-energy features.
- min. energy [cascade]
Same as
min. energy [track]
, but for cascades.
IceTopViewer¶
Note
The IceTopViewer was partially removed in 2021, and formally removed in 2023. Steamshovel now includes a standalone IceTop viewer. The following is kept for historical information.
The IceTopViewer is a special artist which adds a new view to Steamshovel instead of adding object to the 3D scene. When it is added, the previous view (usually the 3D view) is replaced by a 2D top view on IceTop, a view of the lateral density function (LDF), and the arrival times of signals relative to a plane shower front.
Since the IceTopViewer adds an alternative view intead of an object to the 3D view, there is no checkbox to hide/show it. The Window
menu is used to switch between views.
Displays¶
- Top view
The left plot presents a top view on the IceTop array. Tanks without signal appear as gray dots. Tanks with signal appear as a half-circe, colored according to the timeline and scaled as a function of the signal charge.
If an I3Particle (see setting
particle
) is selected in the artist settings, also shown are the shower core (dot), shower direction (arrow), and intersection between shower front plane and ground plane (dashed line)- LDF view
The top right plot presents a lateral view of the shower. It remains empty until an I3Particle is selected (see setting
particle
). Shown are recorded signals versus lateral distance to the shower axis, multiplied by a sign that is positive for arrival times earlier than the core time and negative otherwise. If the selected I3Particle in the settings has an associated Params object, also the fitted LDF is shown.- Time view
Top bottom right plot presents the arrival times relative to the ideal shower front. It remains empty unless an I3Particle is selected (see setting
particle
). Shown are recorded arrival times subtracted from the ideal shower front time at the position of the station versus lateral distance to the shower axis. The sign convention is the same in the LDF view.- Waveform view
If the user selects raw data to the displayed by the viewer (see setting
time trace
), and additional plot shows up on the bottom left.It shows the recorded ATWD waveforms, and possibly the FADC waveform (see setting
show FADC
). The overlapping ATWD channels are displayed in different colors, according to the compact legend on top of the plot. High gain and low gain are shown on the positive/negative y-axis, respectively. A colored dot represents the arrival time stored in the corresponding I3RecoPulse for that tank.
Interactivity¶
- Zoom
The user may zoom into all plots, by dragging a rectangle with the mouse over the area of interest. The mouse wheel is used to zoom out.
- Selecting tanks
Any tank in any plot can be clicked. This draws a small rectangle around the tank in all views, so the corresponding points stand out above the rest. Additional text information about the tank is also shown.
If the waveform view is visible (see setting
time trace
), clicking on a tank also shows its waveform data.
Settings¶
- particle
Select the particle that represents the shower axis.
- time trace
Select waveform data for the event. Adds an additional waveform view. To hide this view, select the empty entry in the combobox.
- SLCs
Select a container with SLC signals, to be shown in addition to HLC signals.
- show no-hits
Adds markers for tanks without signals in the LDF view.
- show FADC
Show the FADC trace in the waveform view.
- show legends
Show text with useful data about the event in the corners of the plots.
- log-radius
Draw points in the LDF view and time view versus
log10(abs(lateral distance))
.- marker-size
Size of markers in LDF and time view.
- scale & power
Affects how charge is converted into radius for the semi-circles in the top view.