Advanced Topics

• Structure of NA64SW project
  • Libraries
  • Applications
  • Plug-ins and Extensions
  • Source code structure
    • Automatically generated code
  • Environment variables
  • Installation Prefix (FHS)
• Key Concepts: Events, Pipeline, Handlers
  • Practical Considerations
  • Object Model
    • Pipeline Class
    • Handler Interface
  • Event object model
    • UML Notation Basics
    • Implementation Details
  • Virtual Constructor
• Handler Developers Guide
  • TL;DR
  • Bare Minimum
  • Additional Features
    • Use Calibration Data
    • Use Detector Names
    • Iterating Over Hits of Certain Type
• Principles
• Detectors naming
  • Sections
  • Instantiation of detector ID object
  • Semantics and names
  • Comparison
  • Payload Section
  • Practical Scenario #1: Handler
  • Practical Scenario #2: Data Source
  • General Practical Scenario: Subscription
  • Notes on TBName Mapping
  • Hardware Electronics Chips
  • TBname
  • Detectors identifiers in NA64SW and DAQ TBname
  • TBNames and Numerical ID Correspondance
  • Two-Staged Conversion Procedure
  • String templates and TDirAdapter class
  • Detector Selection DSL
    • DSuL: comparison expressions
    • DSuL: operators
    • List of Definitions
• Efficient Memory Model
• Calibration data
  • Preface
    • Design Considerations
    • Definitions
  • Scope of definitions
  • Introducing new data type
  • Subscribing to updates
  • Note on data types aliases
  • Note on Dependencies
  • Choosing update source
    • Calibrations config as an update source
      • Direct parameters
      • Static files
    • SDC data as an update source
      • Extending SDC with a data type
      • Registering alias for SDC data
  • General use
    • Custom indexes and loaders
    • Usage for external applications
    • Range-overriding run index
    • Generic Loader
      • YAML Calibration Info
• Notes on APV Detectors
  • Read-out Planes Layout
  • Clustering Algorithms
• Build instructions
  • Preface
  • Scenario #1: LXPLUS
  • Scenario #2: Local LXPLUS build
  • Scenario #3: Docker container
    • TL;DR
    • Details on Docker build
      • Fetch
      • Build Docker Image
      • Getting into containerized environment (basic)
      • Container Mountpoints
      • Getting into containerized environment (advanced)
      • Running Monitored processing
      • Modifying Docker Image
  • Scenario #4: local build on native system
    • Common case
    • Local Build on Ubuntu
  • Dependencies
    • Mandatory vendor-specific dependencies
    • Note on log4cpp versions
    • Optional Dependencies
  • Obtaining the Source Code
  • Configuring the source code
  • Building the code
  • Installation
  • Notes on CI/CD
• Notes on alignment in NA64
  • NA64SW tracking in general
  • Conventions
    • Coordinate frames
    • System of Units
    • Angles
• Tip: Running on CERN’s HTCondor
  • Set-up
    • Workspace dir
    • Output dir
  • Submission script
  • Job script and job environment
  • Conclusion