LArSoft  v09_90_00
Liquid Argon Software toolkit - https://larsoft.org/
RawDataDrawer.cxx File Reference

Class to aid in the rendering of RawData objects. More...

#include <algorithm>
#include <cmath>
#include <cstddef>
#include <limits>
#include <memory>
#include <tuple>
#include <type_traits>
#include <typeinfo>
#include <utility>
#include "TBox.h"
#include "TFrame.h"
#include "TH1F.h"
#include "TVirtualPad.h"
#include "larcore/Geometry/Geometry.h"
#include "lardata/DetectorInfoServices/DetectorPropertiesService.h"
#include "lardataalg/Utilities/StatCollector.h"
#include "lardataobj/RawData/RawDigit.h"
#include "lardataobj/RawData/raw.h"
#include "lareventdisplay/EventDisplay/ChangeTrackers.h"
#include "lareventdisplay/EventDisplay/ColorDrawingOptions.h"
#include "lareventdisplay/EventDisplay/RawDataDrawer.h"
#include "lareventdisplay/EventDisplay/RawDrawingOptions.h"
#include "larevt/CalibrationDBI/Interface/ChannelStatusProvider.h"
#include "larevt/CalibrationDBI/Interface/ChannelStatusService.h"
#include "larevt/CalibrationDBI/Interface/DetPedestalProvider.h"
#include "larevt/CalibrationDBI/Interface/DetPedestalService.h"
#include "nuevdb/EventDisplayBase/View2D.h"
#include "art/Framework/Principal/Event.h"
#include "art/Framework/Principal/Handle.h"
#include "art/Framework/Services/Registry/ServiceHandle.h"
#include "canvas/Persistency/Common/Ptr.h"
#include "canvas/Utilities/Exception.h"
#include "canvas/Utilities/InputTag.h"
#include "cetlib_except/demangle.h"
#include "messagefacility/MessageLogger/MessageLogger.h"

Go to the source code of this file.

Classes

class  details::PointerToData_t< T >
 
class  evd::details::RawDigitInfo_t
 Information about a RawDigit; may contain uncompressed duplicate of data. More...
 
struct  evd::details::RawDigitInfo_t::SampleInfo_t
 
class  evd::details::RawDigitCacheDataClass
 Cached set of RawDigitInfo_t. More...
 
struct  evd::details::RawDigitCacheDataClass::BoolWithUpToDateMetadata
 
class  evd::details::GridAxisClass
 Manages a cell-like division of a coordinate. More...
 
class  evd::details::CellGridClass
 Manages a grid-like division of 2D space. More...
 
class  evd::details::ADCCorrectorClass
 Applies Birks correction. More...
 
class  evd::RawDataDrawer::OperationBaseClass
 
class  evd::RawDataDrawer::ManyOperations
 
class  evd::RawDataDrawer::BoxDrawer
 
class  evd::RawDataDrawer::RoIextractorClass
 

Namespaces

 details
 
 evd
 LArSoft includes.
 
 evd::details
 

Functions

std::vector< evd::details::RawDigitInfo_t >::const_iterator evd::details::begin (RawDigitCacheDataClass const &cache)
 
std::vector< evd::details::RawDigitInfo_t >::const_iterator evd::details::end (RawDigitCacheDataClass const &cache)
 

Detailed Description

Class to aid in the rendering of RawData objects.

Author
messi.nosp@m.er@i.nosp@m.ndian.nosp@m.a.ed.nosp@m.u

This class prepares the rendering of the raw digits content for the 2D view of the display. In particular, it fills the 2D view of detected charge vs. time and wire number for a single TPC. The code is not ready to support an arbitrary TPC from the detector; it can be fixed to support that, but a good deal of the calling code also has to change.

Notes from Gianluca Petrillo (petri.nosp@m.llo@.nosp@m.fnal..nosp@m.gov) on August 19, 2015

As of August 2015, this class performs some preprocessing for the data to be displayed. The main argument here is that the display assigns to each plane a space of 600x250 pixels, while the amound of data is typically 500x5000 elements. These numbers vary wildly: while the first number is close to the current default size for a new window, that window can be resized and windows many times larger can be obtained; for the data content, a MicroBooNE plane contains 2400x9600 elements (that's roughly 25 millions, and there is three of them), each of the two LArIAT planes contains 240x3200 (less than 1 million), and a single TPC of DUNE's 35t prototype about 350x4800 (but it is larger when extended readout window modes are used). The code produces TBox'es to be rendered by the nuevdb event display infrastructure. The code before August 2015 would produce one box for each of the aggregated charge; charge could be aggregated in time by FHiCL configuration to merge TDC ticks. This typically bloats rendering time, since rendering of all boxes is attempted. The new code performs dynamic aggregation after discovering the actual size of the graphical viewport, and it submits at most one TBox per pixel. Additional improvement is caching of the uncompressed raw data, so that following zooming is faster, and especially a way to bypass the decompression when the original data is not compressed in the first place, that saves a bit of time and quite some memory.

Todo:
There are probably a number of glitches and shortcuts in the current preprocessing implementation. If they become a problem, they can probably be fixed on demand. Examples include:
  • no alignment of the boxes with the wire and tick numbers
  • possible border effects
  • the fact that only the maximum charge is displayed on each box , and no dynamic charge range detection is in place
  • the first drawing is performed with a grid that is not the final one (because for some reason the frame starts larger than it should and is resized later)
  • the drawing honours the zoom region the user selected, even if the viewport ends up being larger (that is, if upstream decides that the zoom region is too small and a larger area will be drawn, the additional area will be blank)

Definition in file RawDataDrawer.cxx.