simtools-plot-simtel-events#

Plot simulated events.

This application produces figures from one or more sim_telarray (.simtel.zst) files by calling functions in simtools.visualization.simtel_event_plots. It is meant to run after simulations (e.g., simtools-simulate-flasher, simtools-simulate-illuminator).

What it does#

  • Loads each provided sim_telarray file

  • Generates selected plots (camera image, time traces, waveform matrices, peak timing, etc.)

  • Optionally saves all figures to a single multi-page PDF per input file

  • Optionally also saves individual PNGs

Command line arguments#

simtel_files (list, required)

One or more sim_telarray files to visualize (.simtel.zst).

plots (list, optional)

Which plots to generate. Choose from: event_image, time_traces, waveform_matrix, step_traces, integrated_signal_image, integrated_pedestal_image, peak_timing, all. Default: event_image.

tel_id (int, optional)

Telescope ID to visualize. If omitted, the first available telescope will be used.

n_pixels (int, optional)

For time_traces: number of pixel traces to draw. Default: 3.

pixel_step (int, optional)

For step_traces and waveform_matrix: step between pixel indices. Default: 100.

max_pixels (int, optional)

For step_traces: cap the number of plotted pixels. Default: None.

vmax (float, optional)

For waveform_matrix: upper limit of color scale. Default: None.

half_width (int, optional)

For integrated_*_image: half window width in samples. Default: 8.

offset (int, optional)

For integrated_pedestal_image: offset between pedestal and peak windows. Default: 16.

sum_threshold (float, optional)

For peak_timing: minimum pixel sum to consider a pixel. Default: 10.0.

peak_width (int, optional)

For peak_timing: expected peak width in samples. Default: 8.

examples (int, optional)

For peak_timing: show example traces. Default: 3.

timing_bins (int, optional)

For peak_timing: number of histogram bins for peak sample. Default: None (contiguous bins).

distance (float, optional)

Optional distance annotation for event_image.

output_file (str, optional)

Base name for output. If provided, outputs will be placed under the standard IOHandler output directory and named <base>_<inputstem>.pdf. If omitted, defaults are derived from each input file name.

save_pngs (flag, optional)

Also save individual PNG files per figure.

dpi (int, optional)

DPI for PNG outputs. Default: 300.

output_path (str, optional)

Path to save the output files.

Examples#

  1. Camera image and time traces for a single file, save a PDF:

    simtools-plot-simtel-events

    –simtel_files tests/resources/ff-1m_flasher.simtel.zst –plots event_image time_traces –tel_id 1 –output_file simulate_illuminator_inspect

  2. All plots for multiple files, PNGs and PDFs:

    simtools-plot-simtel-events

    –simtel_files f1.simtel.zst f2.simtel.zst –plots all –save_pngs –dpi 200

plot_simtel_events.main()[source]#

Generate plots from sim_telarray files.