Skip to main content

The RAMS ToolKit (RAMSTK) is a suite of tools for performing and documenting reliability, availability, maintainability, and safety (RAMS) analyses

Project description

The RAMS ToolKit (RAMSTK)

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

Documentation Documentation Status
Tests GitHub Workflow Status Coverage Status
Quality CodeFactor Deep Code Quality Gate
Packages GitHub release (latest SemVer including pre-releases) PyPI

🚩 Table of Contents

🎨 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:

  • Function Module
    • Functional decomposition
    • Hazards analysis
  • Requirements Module
    • Stakeholder input prioritization
    • Requirement development
    • Analysis of requirement for clarity, completeness, consistency, and verifiability
  • Hardware Module
    • Reliability allocation
      • Equal apportionment
      • AGREE apportionment
      • ARINC apportionment
      • Feasibility of Objectives
    • Hardware reliability predictions using various methods
      • Similar items analysis
      • MIL-HDBK-217F parts count
      • MIL-HDBK-217F parts stress
    • FMEA/FMECA
      • RPN
      • MIL-STD-1629A, Task 102 Criticality Analysis
    • Physics of failure analysis
  • Validation Module
    • Task description
    • Task acceptance value(s)
    • Task time
    • Task cost
    • Overall validation plan time/cost estimates

💾 Installing

These instructions will get RAMSTK up and running on your local machine . Note that the Makefile contains all the commands needed to install or work with RAMSTK. You should consult the help output for more information.

Prerequisites

I use pip-tools to manage the dependencies for RAMSTK while I'm developing so the requirements.txt file is formated for use with the pip-sync command. However, it will also work with pip.

$ pip install -r requirements.txt

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

If you're planning to do some development work on RAMSTK, the following would be the better approach:

$ pip install pyenv
$ make mkvenv
$ make usevenv ramstk-venv
$ pip install pip-tools
$ make depends

This will install pyenv, create a virtual environment with the default name of ramstk-venv, activate that virtual environment, install pip-tools, and then install all the RAMSTK dependencies needed for testing, development, and runtime.

RAMSTK uses postgresql for it's database engine. You'll need to have a user with read/write access to a postgresql server to use RAMSTK.

Download

Install any missing RAMSTK dependencies using pip, your package manager, and /or build from source. Then download the of RAMSTK source from GitHub Releases you wish to install.

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

The install target recognizes PREFIX= so you can install RAMSTK in your $HOME or a virtual environment. Since RAMSTK is still a version 0 product, it's highly recommended that you install in a virtual environment.

$ wget https://github.com/ReliaQualAssociates/ramstk/archive/v<tag>.tar.gz
$ tar -xf v<tag>.tar.gz
$ cd ramstk-<tag>
$ make PREFIX=$VIRTUAL_ENV install

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

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

$ pytest -m integration tests/modules/test_allocation.py
$ pytest -m calculation 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 installs a *.desktop file and can be found where ever applications in the category Math or Science are listed.

Documentation

Documentation for RAMSTK can be found at Read the Docs You should check it out!

💬 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

  • Doyle 'weibullguy' Rowland - Initial work - weibullguy

📜 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.

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

RAMSTK-0.13.0.tar.gz (636.3 kB view hashes)

Uploaded Source

Built Distribution

RAMSTK-0.13.0-py3-none-any.whl (769.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page