{"id":13314614,"url":"https://github.com/ECP-copa/CabanaPIC","last_synced_at":"2025-03-10T20:33:39.967Z","repository":{"id":92249689,"uuid":"181550061","full_name":"ECP-copa/CabanaPIC","owner":"ECP-copa","description":"Structured PIC proxy app based on Cabana","archived":false,"fork":false,"pushed_at":"2025-02-19T21:06:25.000Z","size":8591,"stargazers_count":14,"open_issues_count":5,"forks_count":4,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-02-19T22:22:46.054Z","etag":null,"topics":["cabana","kokkos","particle-in-cell","proxy-application","vpic"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ECP-copa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2019-04-15T19:11:19.000Z","updated_at":"2025-02-19T21:06:26.000Z","dependencies_parsed_at":"2023-10-11T19:24:29.159Z","dependency_job_id":null,"html_url":"https://github.com/ECP-copa/CabanaPIC","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ECP-copa%2FCabanaPIC","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ECP-copa%2FCabanaPIC/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ECP-copa%2FCabanaPIC/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ECP-copa%2FCabanaPIC/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ECP-copa","download_url":"https://codeload.github.com/ECP-copa/CabanaPIC/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242922097,"owners_count":20207149,"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":["cabana","kokkos","particle-in-cell","proxy-application","vpic"],"created_at":"2024-07-29T18:11:50.288Z","updated_at":"2025-03-10T20:33:39.958Z","avatar_url":"https://github.com/ECP-copa.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"#CabanaPIC\n\n## Installation\n\nThis code has two major dependencies:\n\n1. Kokkos\n2. Cabana\n\nInstructions on how to obtain and install both can be found [here](https://github.com/ECP-copa/Cabana/wiki/Build-Instructions)\n\nOnce these are installed, you can configure and build this project using CMake.\nThe only necessary configuration argument is the path to Cabana (which will\nalso bring in Kokkos). An example build line will look something like this:\n\n```\ncmake -DCMAKE_PREFIX_PATH=\"$HOME/Cabana/build/install\" ..\n```\n\nCabanaPIC uses the default enabled Kokkos backend (see more information\n[here](https://github.com/kokkos/kokkos/wiki/Initialization#51-initialization-by-command-line-arguments)).\nIt is possible to require a CPU build by adding `-DREQUIRE_HOST=ON` (which uses\nthe default enabled host backend).\n\nThe default field solver is \"EM\"; to use the \"ES\" solver, add `-DSOLVER_TYPE=\"ES\"`.\n\n\nNote that if Kokkos \u003c=3.4 is used, building with GCC and CUDA support requires\nspecifying the compiler wrapper:\n\n```\ncmake -DCMAKE_PREFIX_PATH=\"$HOME/Cabana/build/install\" -DCMAKE_CXX_COMPILER=$KOKKOS_SRC_DIR/bin/nvcc_wrapper ..\n```\n\nRemember that Kokkos, Cabana, and CabanaPIC should all be built with the same\ncompiler.\n\n## Running\n\nUsers can compile in custom input decks by specifying `INPUT_DECK` at build\ntime, e.g:\n\n```\ncmake -DCMAKE_PREFIX_PATH=\"$HOME/Cabana/build/install\" -DINPUT_DECK=./decks/2stream-short.cxx ..\n```\n\nSome example decks live in `./decks`. Custom decks must follow the layout put\nforth in `./src/input/decks.h`\n\n## Feature Wishlist\n\n1. Configurable to run in different precisions (real_t to configure float/double)\n2. The particle data store layout should be configurable (AoS/SoA/AoSoA)\n3. The particle shape function used should be configurable\n\n## Copyright\n\n© (or copyright) 2019. Triad National Security, LLC. All rights reserved.\n\nThis program was produced under U.S. Government contract 89233218CNA000001 for Los Alamos National Laboratory (LANL), which is operated by Triad National Security, LLC for the U.S. Department of Energy/National Nuclear Security Administration. All rights in the program are reserved by Triad National Security, LLC, and the U.S. Department of Energy/National Nuclear Security Administration. The Government is granted for itself and others acting on its behalf a nonexclusive, paid-up, irrevocable worldwide license in this material to reproduce, prepare derivative works, distribute copies to the public, perform publicly and display publicly, and to permit others to do so.\n\nThis is open source software; you can redistribute it and/or modify it under the terms of the BSD-3 License. If software is modified to produce derivative works, such modified software should be clearly marked, so as not to confuse it with the version available from LANL.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FECP-copa%2FCabanaPIC","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FECP-copa%2FCabanaPIC","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FECP-copa%2FCabanaPIC/lists"}