Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/arkottke/strata

Site response program featuring simulated profiles, random vibration theory, and a graphical user interface.
https://github.com/arkottke/strata

random-vibration-theory site-response

Last synced: 3 months ago
JSON representation

Site response program featuring simulated profiles, random vibration theory, and a graphical user interface.

Awesome Lists containing this project

README 

        
# Strata



[![License: GPL v3](https://img.shields.io/badge/License-GPL%20v3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)

[![Build Status](https://travis-ci.org/arkottke/strata.svg?branch=master)](https://travis-ci.org/arkottke/strata)

[![Build status](https://ci.appveyor.com/api/projects/status/cpgr2vsh1re8c35x/branch/master?svg=true)](https://ci.appveyor.com/project/arkottke/strata/branch/master)

[![DOI](https://zenodo.org/badge/49243972.svg)](https://zenodo.org/badge/latestdoi/49243972)



Equivalent linear site response with random vibration theory, site property

randomization, and a graphical user interface.



The _Strata_ GUI simplifies the process for performing site response analysis, but

limits the flexibility and requires extensive coding to add features. To help

address these shortcomings, I have written

[pyStrata](https://github.com/arkottke/pystrata), which is a Python library for

performing site response. With _pyStrata_, complicated customized workflows can be

developed, or examples using Jupyter notebooks can be used to aid in

understanding of the process.



## Binaries



Pre-built binaries for Windows are available from the [Github releases

page](https://github.com/arkottke/strata/releases).



## Citation



When citing Strata, refer to either the technical manual:



> Kottke, Albert R., and Ellen M. Rathje. (2008). "Technical manual for

> Strata." Report No.: 2008/10. Pacific Earthquake Engineering Research Center,

> University of California, Berkeley.



or the [DOI](https://zenodo.org/badge/latestdoi/49243972) of the release and

this website.



## Building



Compiling Strata from the source code requires the following dependencies prior

to building:



-   [CMake](https://cmake.org) (version 3.2 or later)

-   [Qt](http://doc.qt.io/) (version 5.5 or later)

-   GNU Scientific Library ([GSL](http://www.gnu.org/software/gsl/))

-   [Qwt](http://qwt.sourceforge.net/) (version 6.1 or later)

-   [FFTW](http://www.fftw.org/) (optional)



See [Building on Windows](#building-on-windows) for installing these

dependencies on windows.  Once, these dependencies are installed the Strata can

build checked out and built using the following commands:



    $> git clone https://github.com/arkottke/strata.git

    $> cd strata

    $> mkdir build

    $> cd build

    $> cmake .. -DCMAKE_BUILD_TYPE=Release

    $> make -j2



Strata executable is located in: `strata/build/source/strata`. If the build is

unable to find header files and libraries for linking, paths to these files can

be added by modifying the strata.pro text file, or by passing the INCLUDEPATH

and LIBS environmental varibles. On Linux and OS X, the variabile

LD_LIBRARY_PATH may need to be updated to include paths to Qwt and GSL library

files. On Windows, PATH should include the paths to Qwt and GSL DLL files.



### Building on Linux



Depending the distribution, the Qt binaries may or may not be in the package

manager. On Ubuntu Trusty, Qt 5.6 is available from

[ppa:beineri/opt-qt-5.10.1-trusty] [1], which can be installed with the following

steps:



    $> sudo add-apt-repository --yes ppa:beineri/opt-qt-5.10.1-trusty

    $> sudo apt-get update -qq

    $> sudo apt-get install -qq libgsl0-dev qt510base qt510tools qt510svg



If Qwt 6.1 is not available in the package manager. Qwt can be built using the

following commands:



    $> source /opt/qt10/bin/qt10-env.sh

    $> cd $HOME/..

    $> svn checkout  qwt

    $> cd qwt

    $> qmake

    $> make -j2

    $> sudo make install



Here is an example of passing adding paths for Qwt headers and shared

libraries, and GSL to CMake:



    $> QWT_ROOT_DIR=/usr/qwt-6.1.3/lib

    $> GSL_ROOT_DIR=/usr/include/gsl

    $> cmake .. -DQWT_ROOT_DIR=$QWT_ROOT_DIR -DGSL_ROOT_DIR=$GSL_ROOT_DIR -DCMAKE_BUILD_TYPE=Release



### Building on Windows



Building on Windows is greatly simplified by using

[MSYS2](https://msys2.github.io/). After installing MSYS2, the required

dependencies can be installed with the following commands:



    $> pacman -Sy

    $> pacman -S \

        cmake \

        mingw-w64-i686-qt5 \

        mingw-w64-x86_64-qwt-qt5 \

        mingw-w64-x86_64-gsl \

        git



Using a MinGW-w64 shell, execute the commands listed in [Building](#building).



## Building on OS X



Prior to building on OS X, install [homebrew](https://brew.sh/). Next install the dependencies:



    $> brew install qt gsl qwt cmake



Then compile:



    $> git clone https://github.com/arkottke/strata.git

    $> cd strata

    $> mkdir build

    $> cd build

    $> QWT_ROOT_DIR="/usr/local/Cellar/qwt/6.1.3_4"

    $> QWT_INCLUDE_DIR="/usr/local/Cellar/qwt/6.1.3_4/lib/qwt.framework/Versions/6/Headers"

    $> GSL_ROOT_DIR="/usr/local/Cellar/gsl/2.5"

    $> cmake .. \

        -DQWT_ROOT_DIR=$QWT_ROOT_DIR \

        -DQWT_INCLUDE_DIR=$QWT_INCLUDE_DIR \

        -DGSL_ROOT_DIR=$GSL_ROOT_DIR \

        -DCMAKE_BUILD_TYPE=Release \

        -DCMAKE_INSTALL_PREFIX:STRING=dist

    $> cmake --build . --target install



After building, the executable can be run by issuing the following command from the `build` directory:



    $> ./dist/usr/bin/strata



Right now (12/15/2019) on macOS Mojave homebrew installs qwt version 6.1.4 and gls version 2.6, so change the relative lines



    $> QWT_ROOT_DIR="/usr/local/Cellar/qwt/6.1.4"

    $> QWT_INCLUDE_DIR="/usr/local/Cellar/qwt/6.1.4/lib/qwt.framework/Versions/6/Headers"

    $> GSL_ROOT_DIR="/usr/local/Cellar/gsl/2.6"



or in case of error control the version in the directory: /usr/local/Cellar/



If you find a cleaner way to specific the library paths, please let me know.



## Testing



Examples for testing are located in the example/ directory.



[1]: https://launchpad.net/~beineri/+archive/ubuntu/opt-qt562-trusty