Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sandialabs/cambio

Spectroscopic file conversion tool
https://github.com/sandialabs/cambio

scr-988 snl-applications snl-visualization

Last synced: 2 days ago
JSON representation

Spectroscopic file conversion tool

Awesome Lists containing this project

README

        

# Cambio
Cambio converts spectrum files from nearly all common handheld and lab-based spectroscopic gamma radiation detectors, radiation portal monitors, or search systems to a format of your choice ([N42](https://www.nist.gov/programs-projects/ansiieee-n4242-standard), [PCF](https://prod-ng.sandia.gov/techlib-noauth/access-control.cgi/2017/179107.pdf), CSV, TXT, CHN, SPC, HTML, and more).

Cambio can be built either as a GUI that allows previewing the spectrum files, editing the meta-data, and interactively choosing the output format options, or Cambio can be built as a command line only utility. The command line utility is useful for calling from batch scripts, or calling from other programs to take care of reading the hundreds of potential formats, making it so your program only needs to read in a single format.

## Getting Started
To get a pre-compiled executable, head over to the [releases](https://github.com/sandialabs/cambio/releases) tab, or to download historical version of the app see: https://hekili.ca.sandia.gov/CAMBIO/.

## Building from source
### Prerequisites
To compile, you need a c++14 compiler, and:
* [boost](https://www.boost.org/) versions 1.44 through 1.65.1 will probably
work, but development is done using 1.65.1.
* To compile the GUI, you will need [Qt](https://www.qt.io/).
[Qt](https://www.qt.io/) is not needed for the command line only version.
Development is done using [Qt](https://www.qt.io/) 5.11 and 5.12.
* [cmake](https://cmake.org/)
* [SpecUtils](https://github.com/sandialabs/SpecUtils)

### Compiling
On Linux and macOS:
```bash
git clone https://github.com/sandialabs/cambio
cd cambio
git clone https://github.com/sandialabs/SpecUtils

#build GUI version
mkdir build_gui
cd build_gui
cmake -DBUILD_CAMBIO_GUI=ON -DMyQT_DIR=/path/to/qt -DBOOST_ROOT=/path/to/boost ..
make -j8

#build command line only version
cd ..
mkdir build_cl
cd build_cl
cmake -DBUILD_CAMBIO_COMMAND_LINE=ON -DBUILD_CAMBIO_GUI=OFF -DBOOST_ROOT=/path/to/boost ..
make -j8
```
And on Windows an analogous process can be used to generate Visual Studio project with the CMake GUI. Currently [CMakeLists.txt](CMakeLists.txt) is hardcoded to link to the static runtime on Windows, and statically compiled Qt.

### Installing
No installation is necessary - simple download or build the executable and run it.

## Author
William Johnson

## License
This project is licensed under the LGPL v2.1 License - see the [LICENSE](LICENSE) file for details

## Copyright
Copyright 2018 National Technology & Engineering Solutions of Sandia, LLC (NTESS).
Under the terms of Contract DE-NA0003525 with NTESS, the U.S. Government retains certain rights in this software.

## Privacy Policy
Cambio does not collect any user information or statistics, and it does not send or receive any information over the network (e.g., nothing is downloaded to, or leaves from your computer).

SCR #988