libamtrack / library

Core library code
GNU General Public License v3.0
7 stars 8 forks source link
hacktoberfest hacktoberfest2022 linux proton

1. WHAT IS LIBAMTRACK?

2. HOW CAN I USE LIBAMTRACK?

libamtrack is a program library and cannot be run as a single executable. A number of interfaces is provided with different complexities depending on your needs and experience. They are given below in order of complexity. Please be aware that for option (iv)-(vi) the GNU Scientific Library (GSL) has to be installed on your system. Refer to README_DEVELOPERS on how to do that.

i. Web-interface

The web interface covers a subset of libamtrack functions for easy access and can be found on libamtrack's website: https://libamtrack.github.io/web/. The sources can be found at (/distributions/JavaScript). The interface development was started by Christoph Kolb within his Bachelor thesis and consolidated by Leszek Grzanka.

ii. R

To access (almost any) function of libamtrack, we recommend to use the R environment. libamtrack is a contributed package (http://cran.r-project.org/web/packages/libamtrack) on the Comprehensive R Archive Network (CRAN, http://cran.r-project.org) and can easily be installed and used from within R. It comes with documentation.

iii. Python, Matlab wrappers

libamtrack comes with a collection of wrappers for Python and Matlab (/distributions/Python, /distributions/Matlab).

iv. Use precompiled binaries

If you want to use libamtrack in your own code, please try to use the precompiled binaries (incl. headers) for your OS (Win, Mac OS X) are found on libamtrack's website. In case you are running Linux (or some exotic OS) you will have to compile and install libamtrack using autotools. But in the future, rpm/deb packages will be provided.

vi. Work with full sources / development

If you want to compile it on your own latest source code of libamtrack, please use this to build and install according to your OS.

Linux

Requirements:

Get the latest source code of the libamtrack:

git clone https://github.com/libamtrack/library.git

Go to library directory and then create build directory:

cd library && mkdir build

Generate build files for the libamtrack:

cmake -S . -B build

Build the libamtrack:

cmake --build build --parallel

Install the libamtrack:

cmake --install build

Windows(MSYS2)

Get first the MSYS2 and please follow the installation guide.

Requirements:

Get the latest source code of the libamtrack:

git clone https://github.com/libamtrack/library.git

Go to library directory and then create build directory:

cd library && mkdir build

Generate build files for the libamtrack:

cmake -S . -B build

Build the libamtrack:

cmake --build build --parallel

Install the libamtrack:

cmake --install build

MacOS

Get first the Homebrew to install the required packages.

Requirements:

Get the latest source code of the libamtrack:

git clone https://github.com/libamtrack/library.git

Go to library directory and then create build directory:

cd library && mkdir build

Generate build files for the libamtrack:

cmake -S . -B build

Build the libamtrack:

cmake --build build --parallel

Install the libamtrack:

cmake --install build

3. CAN I USE LIBAMTRACK IN MY RESEARCH AND/OR MODIFY THE CODE?

Everybody is welcome to read, use and modify (preferably to improve) the code according to GNU GPL 3.

4. WHERE DO I FIND DOCUMENTATION ON LIBAMTRACK?