可靠性，可用性，可维护性，安全性（RAMS）分析程序。
A ToolKit for Reliability, Availability, Maintainability, and
Safety (RAMS) analyses.
| Tests |    |
|---|---|
| Quality |    |
| Packages |   |
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.
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:
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.
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 \
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
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.
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
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 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.
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.
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.
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.