{"id":26694466,"url":"https://github.com/deeplearnphysics/supera","last_synced_at":"2025-04-13T00:35:22.970Z","repository":{"id":110272126,"uuid":"108011434","full_name":"DeepLearnPhysics/Supera","owner":"DeepLearnPhysics","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-07T23:58:35.000Z","size":690,"stargazers_count":2,"open_issues_count":3,"forks_count":12,"subscribers_count":5,"default_branch":"develop","last_synced_at":"2025-04-13T00:34:53.555Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DeepLearnPhysics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-10-23T16:52:38.000Z","updated_at":"2025-03-28T16:15:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"9b282cab-7c51-4640-8b0c-33ee3e944c68","html_url":"https://github.com/DeepLearnPhysics/Supera","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepLearnPhysics%2FSupera","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepLearnPhysics%2FSupera/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepLearnPhysics%2FSupera/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepLearnPhysics%2FSupera/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DeepLearnPhysics","download_url":"https://codeload.github.com/DeepLearnPhysics/Supera/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248650462,"owners_count":21139670,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-03-26T18:29:38.345Z","updated_at":"2025-04-13T00:35:22.943Z","avatar_url":"https://github.com/DeepLearnPhysics.png","language":"C++","readme":"# Supera\nSupera is designed to slice up the data products output from larsoft and package them to be consumed by the mlreco workflow. The bulk of the work is done by `SuperaMCParticleCluster` which consumes inputs from `simenergydeposit(lite)`, cluster3D, and MC truth products such as `MCTrack`, `MCShower`, and `MCParticle`.\n\n## Verbosity\nVerbosity can be set for any module used in supera by setting `Verbosity : n`\n\n* `n = 0` shows `LARCV_DEBUG` and above messages\n* `n = 1` shows `LARCV_INFO` and above messages\n* `n = 2` shows `LARCV_NORMAL` and above messages\n* `n = 3` shows `LARCV_WARNING` and above messages\n* `n = 4` shows `LARCV_ERROR` and above messages\n* `n = 5` only shows `LARCV_CRITICAL` and messages\n\n## SuperaMCParticleCluster\nThis class is responsible for managing Monte Carlo (MC) particle clusters within the LArCV framework. The class is authored by drinkkazu.\n\n### Features\n* It provides functions to configure, initialize, process, and finalize instances of the class.\n* It allows creation of particles and particle groups.\n* It includes methods for analyzing simulated energy deposits and channels.\n* It has functions for merging shower touchings, conversions, ionizations, and deltas.\n* It includes functions for merging shower family touchings.\n* The class also contains private variables and methods to work with particle clusters.\n### Dependencies\nThe class depends on several other modules and classes in the LArCV framework, including:\n\n* `SuperaBase`\n* `SuperaTrue2RecoVoxel3D`\n* `FMWKInterface`\n* `MCParticleList`\n* Various data formats from `larcv/core/DataFormat`\n* `SuperaMCParticleClusterData`\n\nThe class is built upon a factory pattern, with the corresponding `SuperaMCParticleClusterProcessFactory` class provided for creating instances of `SuperaMCParticleCluster`.\n\n# Building Supera for ProtoDUNE\n\nIn general, **Supear** works fine with latest larsoft release on _cvmfs_ (linux only, sorry for mac users).\nThe following has been tested with the tags specified. It depends on [[larcv2][https://github.com/DeepLearnPhysics/larcv2]].\n\n**For building**\n```\n# ===========================\n# Prepare a working directory\n# ===========================\nsource /cvmfs/dune.opensciencegrid.org/products/dune/setup_dune.sh\nsetup larsoft v08_21_00 -q e17:prof\n\nmkdir MyWorkDir \u0026\u0026 cd MyWorkDir\nmrb newDev\nsource MyWorkDir/localProducts_larsoft_v08_21_00_e17_prof/setup\n\n# ===============\n# checkout larcv2\n# ===============\ncd $MRB_SOURCE\ngit clone https://github.com/DeepLearnPhysics/larcv2\ncd larcv2\nsource configure.sh\nmake\n\n# ================\n# checkout dunetpc\n# ================\ncd $MRB_SOURCE\nmrb g dunetpc\n\n# ===============\n# checkout supera\n# ===============\ncd $MRB_SOURCE/dunetpc/dune\ngit clone -b pdune https://github.com/kvtsang/Supera.git\ncd Supera\nsource setup.sh pdune\n\n# ============================================\n# edit $MRB_SOURCE/dunetpc/dune/CMakeLists.txt\n# add this line \"add_subdirectory(Supera)\"\n# ============================================\n\ncd $MRB_BUILDDIR\nmrbsetenv\nmrb i             # or mrb i -j \u003cn\u003e for parallel build\n```\n\n**For running**\n```\n# ==========================================\n# Do it once, before executing \"lar\" command\n# ==========================================\nsource /cvmfs/dune.opensciencegrid.org/products/dune/setup_dune.sh\nsource MyWorkDir/localProducts_larsoft_v08_21_00_e17_prof/setup\nsource MyWorkDir/larcv2/configure.sh\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeeplearnphysics%2Fsupera","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeeplearnphysics%2Fsupera","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeeplearnphysics%2Fsupera/lists"}