Compiling

Compiling your own version of xara.

Dependencies

The first step for compiling xara is to download some basic dependencies. The primary system dependencies required for compiling are LAPACK/BLAS and Tcl. Packages providing these libraries are listed below for various package management ecosystems. Anaconda is recommended for those that are not familiar with compiling.

Note

When building in an Anaconda environment, you should install all dependencies with conda or mamba, and preferably from the conda-forge channel. Expand the notes on Anaconda below.

Anaconda (Mac, Windows, Linux)

When using conda, you need to ensure that CMake only finds compilers that are compatible with the libraries in the environment. System compilers (like those installed by the operating system’s package manager) often cannot be used and can lead to segfaults. The following command should install everything you need:

conda install -c conda-forge fortran-compiler cxx-compiler c-compiler openblas openmpi

APT (Ubuntu, Debian Linux)

Dependency	Package
BLAS	`libopenblas-dev`
Tcl*	`tcl-dev`
Compilers	`build-essential`

Brew (MacOS)

Dependency	Package
Tcl*	`tcl-tk`
Compilers	`gcc`

Pacman (Arch, Manjaro Linux)

Dependency	Package
LAPACK	`lapack`
BLAS	`blas`
Tcl*	`tcl`

Yum (CentOS, Redhat Linux)

Dependency	Package
LAPACK	`lapack-devel`
Tcl*	`tcl-devel`

Prerequisites

Clone the package repository:

git clone https://github.com/peer-open-source/xara

install run-time dependencies. These are the libraries that will be needed in order to use OpenSees. To install these, run:
```
python -m pip install xara
```
Install compile-time dependencies; see Dependencies below. These dependencies are only needed for the compiling process.

Windows installation notes

On Windows you should additionally install Intel compilers and Conan

Compiling

The next steps describe how to set up your compilers and build the OpenSees library.

Create a directory to hold build artifacts
```
mkdir build
```
Configure the system for your system
```
cd build
cmake ..
```
Start compiling
```
cmake --build . --target OpenSees -j8
```
When libOpenSeesRT.so is compiled locally, the opensees package needs to be told where to find it. This can be done by setting an environment variable with the name OPENSEESRT_LIB to point to the location of libOpenSeesRT.so in the build tree. To this end, you may want to add a line like the following to your shell startup script (e.g., .bashrc):
```
export OPENSEESRT_LIB="/path/to/your/compiled/libOpenSeesRT.so"
```

Create a directory to hold build artifacts
```
mkdir build
```

Run Conan

cd build
conan install .. --build missing

Configure the system for your system
```
cmake ..
```
Start compiling
```
cmake --build . --target OpenSees -j8
```
When libOpenSeesRT.so is compiled locally, the opensees package needs to be told where to find it. This can be done by setting an environment variable with the name OPENSEESRT_LIB to point to the location of libOpenSeesRT.so in the build tree. To this end, you may want to add a line like the following to your shell startup script (e.g., .bashrc):
```
export OPENSEESRT_LIB="/path/to/your/compiled/libOpenSeesRT.so"
```

Check that everything was built properly by running the following command:

python -m opensees

This should start an OpenSees interpreter which can be closed by running the exit command.

• add frame-0002 (6d9c19c)

On this page:

Docs

Dependencies

Prerequisites

Compiling