search

mguc / arts

Acoustic Ray Tracing Simulator
BSD 3-Clause "New" or "Revised" License
1 stars 0 forks source link

readme

ARTS

ARTS stands for "Acoustic Ray Tracing Simulator" and is primarly designed to generate test data for Indoor Localization and Mapping Problems in a given 3D environment and for a set of receivers and sources.

Requirements

Docker

Probably the easiest and fastest way to get started is to install Docker. Just follow the instructions for your specific OS. After Docker has been installed just run the following command to pull the docker image and to start an interactive shell in a Docker container.

OSX and Linux:

docker/run.sh

Windows:

docker/run.bat

Packages

If you are preferring to build the project locally, check out the Dockerfile for required packages. Instead of building CGAL yourself you can install the package for your distribution. The version might differ, but the result should be the same. Examples:

Ubuntu 18.04:

sudo apt-get install libcgal-dev

Building the project

In the project directory simply run:

cmake -DCMAKE_BUILD_TYPE=Release .
make

This will build two targets:

Running examples

The following example performs a simulation in a room with the dimensions 4m x 5m x 3m and one receiver and one source node sitting at position (0,0,0), which is the center of the room:

./arts_cli -e rsc/environment/4x5x3room.obj

If you run it natively you can add -v option to open the CGAL Basic Viewer:

./arts_cli -e rsc/environment/4x5x3room.obj -v

Wish list