search

ReliaQualAssociates / ramstk

Reliability, Availability, Maintainability, Safety (RAMS) analysis program.
https://www.reliaqual.com/rtk/
BSD 3-Clause "New" or "Revised" License
46 stars 15 forks source link
analyses analysis fmea ram rams reliability safety

readme

The RAMS ToolKit (RAMSTK)

A ToolKit for Reliability, Availability, Maintainability, and Safety (RAMS) analyses.

Tests GitHub Workflow Status Coverage Status
Quality CodeFactor Quality Gate All lints status
Packages GitHub release (latest SemVer including pre-releases) PyPI

🚩 Table of Contents

Disclaimer

RAMSTK attempts to use Semantic Versioning 2.0.0. Per spec item 4, major version 0 is for initial development and anything may change at any time. That is certainly the case for RAMSTK! Because RAMSTK is a one developer show, there is no active develop branch at the moment. This may change after release of 1.0.0. Until then, tagged releases can be used, but the latest tag may not work and may not be backwards-compatible. While major version is at 0, breaking changes will be reflected in bumps to the minor version number. That is, version 0.15.0 is not compatible with version 0.14.0.

🎨  Features

RAMSTK is built on the concept of modules where a module is a collection of related information and/or analyses pertinent to system development. The modules currently included in RAMSTK are:

💾  Installing

RAMSTK uses postgresql for its database engine. You'll need to have a user with read/write access to a postgresql server to use RAMSTK. Instructions for setting up the postgresql servers and creating users with the appropriate permissions can be found in the project Wiki.

Download and Install

Since RAMSTK is still a version 0 product, it's highly recommended that you install in a virtual environment. The instructions below presume you will be installing in a virtual environment and system-wide Python packages that RAMSTK depends on will be unavailable. That being the case, you will need various system development packages available via your operating system's package manager to install RAMSTK.

Once you have installed any missing development file packages using your operating system's package manager, download the \ of RAMSTK source from GitHub you wish to install.

$ wget https://github.com/ReliaQualAssociates/ramstk/archive/v<version>.tar.gz
$ tar -xf v<version>.tar.gz
$ cd ramstk-<version>

The other option for obtaining the RAMSTK source code is to clone the repository.

$ git clone https://github.com/ReliaQualAssociates/ramstk.git ramstk.git
$ cd ramstk.git

Create and activate a virtual environment however you are acustomed to. One approach is to use pyenv and poetry. Using pyenv isn't necessary unless you want to install and use a Python version other than that provided by your operating system.

$ pyenv install 3.8.7
$ poetry env use ~/.pyenv/shims/python3.8
$ poetry shell

This will install Python-3.8.7 and tell poetry to use the Python interpreter you just installed. Finally, poetry will create, if needed, and activate the virtual environment using Python-3.8.7 as the interpreter.

Now that the virtual environment is activated, you can install the necessary RAMSTK dependencies and RAMSTK itself. Omitting the PREFIX variable will cause RAMSTK to install to /usr/local by default.

$ make depends
$ make PREFIX=$VIRTUAL_ENV install

When upgrading RAMSTK, you can simply:

$ pip install -U ramstk

This will only install the latest RAMSTK version from PyPi and will leave configuration, data, and icon files untouched. If you cloned the RAMSTK repository, you can also use the Makefile:

$ git switch master
$ git pull
$ make install.dev

Development Dependencies

We use poetry to manage the dependencies for developing RAMSTK. Using the Makefile, install as follows:

$ make depends

This should get all the needed development and runtime requirements installed if they're not already.

Running the Tests

To run the entire test suite for RAMSTK after installing, simply execute:

$ make test

To run the test suite with coverage, execute:

$ make coverage
$ make coverage.report

To run specific tests or groups of tests, use pytest:

$ pytest -m integration tests/modules/test_allocation.py
$ pytest -m unit tests/analyses/prediction

🔨  Usage

After installing RAMSTK, it can be launched from a terminal emulator:

$ ramstk

This is a good option if you need to file an issue as the output should be included in your report. RAMSTK also installs a .desktop file and can be found where ever applications in the category Math or Science are listed. If you've installed in a virtual environment or other non-standard location, this .desktop file may not be found.

See the User Guide for the latest usage instructions.

Documentation

Documentation for RAMSTK is built and included as release assets. For each release, you will find a pdf and html implementation of the User Guide. For each minor and major version release, you will also find a pdf and html implementation of the Developer's Guide.

💬  Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Also read DEVELOPMENT_ENV.md for instructions on setting up a development environment to work on and test RAMSTK.

🍞  Authors

📜  License

This project is licensed under the BSD-3-Clause License - see the LICENSE file for details.

RAMSTK is also registered with the United States Copyright Office under registration number TXu 1-896-035 because I have an attorney and attorneys like to file paperwork for $300/hour.

Similar Products

The following are commercially available products that perform RAMS analyses. We are not endorsing any of them; they are all fine products and may be a better fit for you or your organization depending on your needs and budget. Obviously, we would prefer you use RAMSTK.