Installation and Build
New documentation under development. Please refer to the
CMakeList.txt
files in the top-level directories of the SMR
Packages.
Introduction and Prerequisites
The following assumptions are made throughout this chapter:
All shell commands are bash shell commands.
All SMR packages are built with the
cmake
build system.
A number of system packages are required to build B2000++. Depending
on the Linux distribution the package names vary. cmake
will
report any missing packages.
SMR Packages
All SMR packages are available through your administrator. The following SMR packages are required for building B2000++:
CMakeModules |
|
memcom |
The B2000++ data manager. |
pymemcom |
The Python module memcom for accessing the database with Python. |
mcbrowser |
The MemCom dataset browser. Installs the mcbrowser application. |
b2000pp |
The B2000++ libraries and solvers. Installs the libb2000++ library, the B2000++ header files, and the b2ip++, b2000++, b2mass, and b2add_6dof applications. |
b2000pp_data |
Installs all B20000++ examples and test cases. Test cases are
installed in |
b2test |
Installs the b2testrunner application. |
b2toools |
Installs the B2000++ tools applications. |
b2browser |
Installs the b2browser* model browser prototype (GTK based). |
b2converters |
Installs the BDF and other file converter applications. |
simples |
Installs the Simples Python modules and applications. |
Please install all packages under one source directory. In what
follows, all packages are accessed under the directory $SMR_SRC
Although not strictly necessary, it is advised to define the following environment variables:
SMR_SRC
: Path to the directory containing all packages. Example (bash shell):export SMR_SRC=$HOME/src/git
SMR_PREFIX
: Path to the installation directory. Example (bash shell):export SMR_PREFIX=$HOME/smr/versionxxx
SMR_CMAKEMODULES
: Path to theCMakeModules
directory. Example (bash shell):export SMR_CMAKEMODULES=$SMR_SRC/CMakeModules
The cmake scripts will recognize SMR_PREFIX
and SMR_CMODULES
.
Build and Install
All packages must be build in a dedicated build directory hereunder
referred to as _build
.
To configure a package and compile and install it:
Create a build directory and go to that build directory. Example: Compile MemCom (package
memcom
):mkdir -p $HOME/_build/memcom cd $HOME/_build/memcom
Configure with evironment variables
SMR_SRC
,SMR_PREFIX
, andSMR_CMAKEMODULES
defined (see above):cmake $SMR_SRC/memcom make -j NJOBS install
First Steps after the Installation
Add the $SMR_PREFIX
path to your $PATH
(depends on shell).
Define the PYTHONPATH variable (required in this version due to a
bug). It points to $SMR_PREFIX/lib/pythonX.Y/site-packages
.
To check if B2000++ is installed properly the following command can be entered in the shell:
b2000++ -version
If the installation has been successful the following message will appear:
B2000++ version x.y
...
If the B2000++
command does not work then most probably the
PATH
environment variable is not set properly.
Run one or all of the test cases of b2000pp_data/examples
and
b2000pp_data/verification
. You can run the scordelis-lo-roof
example.:
cd $SMR_SRC/b2000pp_data/examples/static/scordelis_lo_roof b2000++ scordelis_lo_roof.mdl python3 print_vmises.py
If the python
command does not work then most probably the
PYTHONPATH
environment variable is not set properly.
Testing
Run the b2testrunner in
b2000pp_data/examples
and b2000pp_data/verification
:
b2testrunner -j n .
where n
is the number of threads to be launched.