Skip to content
/ Draco Public
forked from lanl/Draco

An object-oriented component library supporting radiation transport applications.

License

Notifications You must be signed in to change notification settings

brryan/Draco

This branch is 973 commits behind lanl/Draco:develop.

Folders and files

NameName
Last commit message
Last commit date
Aug 5, 2021
Sep 6, 2021
Nov 8, 2021
Oct 26, 2021
Nov 8, 2021
Oct 26, 2021
Mar 26, 2021
May 7, 2021
Aug 12, 2020
Dec 3, 2020
Aug 5, 2021
Apr 28, 2020
Jun 30, 2021
Oct 6, 2021
Oct 16, 2020
Dec 21, 2020
Oct 7, 2021
Sep 26, 2020
Jun 30, 2021
Jul 6, 2021

Repository files navigation

Draco

GNU Build Status LLVM Build Status Windows Build Status codecov.io Latest Version PyPI GitHub Super-Linter

Draco is an object-oriented component library geared towards numerically intensive, radiation (particle) transport applications built for parallel computing hardware. It consists of semi-independent packages and a robust build system. The packages in draco provide a set of components that can be used by multiple clients to build transport codes. The build system can also be extracted for use in clients.

To clone draco:

git clone https://github.com/lanl/Draco.git

To get started, please see Development - Quick Start Guide in the wiki. Pull requests must satisfy the requirements listed in the Style Guide.

Spack - Draco can be installed via the spack package manager

Synopsis of Active Draco Packages

  • c4 - A communications library for message passing interfaces (MPI).
    • For builds without MPI, all communication commands will be no-op functions (DRACO_C4={MPI;SCALAR}). Also provides a wrapper to libquo
  • cdi - Access to material data. The Common Data Interface (CDI) specifies a common abstraction for objects and libraries that return material data (opacities, atomic cross sections, equation-of-state data, etc.)
  • cdi_analytic - Analytic models for physical data
  • cdi_CPEloss - Stopping power models for charged particles.
  • cdi_eospac - Equation-of-State data
    • These classes wrap the EOSPAC6 libraries that read sesame files; Commonly used to access gray opacity data and heat capacities. (EOSPAC_LIB_DIR=<path>).
  • cdi_ipcress - Gray and multigroup opacities
    • The classes in this component will read and parse opacity values from an IPCRESS file produced by TOPS.
  • cdi_ndi - Wrapper around LANL's Nuclear Data Interface (NDI) library for accessing nuclear data tables.
  • compton_interface - Provides access to Compton scattering models and data as provided by the CSK library..
  • compton_tools - Provides performant converter, reader, and interpolation tools for Compton data
  • device - Wrapper for heterogeneous device communication
    • The classes in this component provide access to DaCS (deprecated) and CUDA calls for use on heterogeneous architecture platforms (GPU machines).
  • diagnostics - CPP macros that are activated at compile time that can provide additional diagnostic verbosity during calculations.
  • ds++ - Basic services and data structures library.
    • Array containers, assertion and Design-by-Contract, access to low level OS functions, file and path manipulation, unit test system, etc.
  • experimental - Implementations of C++ features that are not yet available to all compilers that are used when installing Draco libraries. Currently, this component provides mdspan.
  • fit - Least squares fitting routines.
  • fpe_trap - Catch IEEE floating point exceptions
  • FortranCheck - Test Fortran compatibility and interoperability
    • The examples in this component will demonstrate if the Fortran compiler is working; if Fortran/C inter-language linking/running is working and sample ISO_C_BINDING calls.
  • kde - KDE are a natural extension of quadrature. They reconstruct a smooth representation of a sampled field based on a specified Kernel shape. This populates the initial KDE infrastructure and some simple 1D reconstructions.
  • lapack_wrap - C++ wrapper for BLAS and LAPACK.
  • linear - direct solvers for small linear systems of equations.
  • mesh - Encapsulate mesh definition and accessors.
  • mesh_element - defines fundamental mesh element types used by mesh, meshReaders and RTT_Format_Reader.
  • meshReaders - Read RTT format mesh files.
  • min - Optimization routines. Find the minimum of a function.
  • norms - Calculate norms for data sets.
  • ode - Ordinary differential equation solvers (e.g.: Runge-Kutta).
  • parser - Lexical file/input parser.
  • quadrature - access to angular integration functions and related data.
  • rng - A random number generator component
    • The primary set of functions provided by this component were derived from Random123 random number library. A few additional random number generators are also provided.
  • roots - Root finding algorithms
  • RTT_Format_Reader - meshReaders implementation for RTT format mesh files or input-streams.
  • special_functions - Specialized math functions like factorial and Dirac delta.
  • units - Provides encapsulated unit systems, functions to convert between unit systems and physical constants.
  • VendorChecks - A testing component to ensure that discovered and used vendor libraries behave as expected.
  • viz - Generates Ensight files for data visualization.

Deprecated packages

  • plot2d - C++ interface to XMGrace 2-dimensional plotting (removed 2020 Dec 3).
  • shared_lib - Dynamically load/unload shared object libraries via dl load (removed 2020 Sep 7).
  • traits - A traits class used by viz.

Authors

Many thanks go to Draco's contributors.

Draco was originally written by staff from Los Alamos's CCS-2 Computational Physics and Methods Group:

CCS-2 Draco Team: Kelly G. Thompson, Kent G. Budge, Matt A. Cleveland, Ryan T. Wollaeger, Alex R. Long, Ben R. Ryan, Kendra P. Long, James S. Warsa, Tim Kelley, Jae H. Chang, Andrew T. Till, Seth D. Cook, Ondrej Certik, and David A. Dixon.

Prior Contributors: Gabriel M. Rockefeller, Allan B. Wollaber, Rob B. Lowrie, Paul W. Talbot, Katherine J. Wang, Peter Ahrens, Daniel Holladay, Massimiliano Rosa, Todd J. Urbatsch, Jeff D. Densmore, Jeff Furnish, John McGhee, Kris C. Garrett, Mike Buksas, Nick Myers, Paul Henning, Randy Roberts, Seth Johnson, Todd Adams, Tom Evans, and Lori Pritchett-Sheats.

Release

Draco is released under the BSD 3-Clause License. For more details see the LICENSE file.

About

An object-oriented component library supporting radiation transport applications.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C++ 77.3%
  • CMake 10.1%
  • Python 3.1%
  • Emacs Lisp 3.0%
  • Shell 2.9%
  • C 1.5%
  • Other 2.1%