`csle-system-identification`

A library with system identification algorithms for learning system models in CSLE based on traces and data collected from emulated infrastructures.

PyPI - Downloads

Requirements

Python 3.8+
csle-base
csle-common
csle-collector
csle-attacker
csle-defender
csle-cluster
gpytorch (For system identification algorithms based on Gaussian processes)
pymc (For Markov-Chain Monte Carlo and Bayesian modeling)
pytensor (For numerical computations)
scikit-learn (For statistical computations)

Development Requirements

Python 3.8+
flake8 (for linting)
flake8-rst-docstrings (for linting docstrings)
tox (for automated testing)
pytest (for unit tests)
pytest-cov (for unit test coverage)
mypy (for static typing)
mypy-extensions (for static typing)
mypy-protobuf (for static typing)
types-PyYaml (for static typing)
types-paramiko (for static typing)
types-protobuf (for static typing)
types-requests (for static typing)
types-urllib3 (for static typing)
sphinx (for API documentation)
sphinxcontrib-napoleon (for API documentation)
sphinx-rtd-theme (for API documentation)
pytest-mock (for mocking tests)
pytest-grpc (for grpc tests)

Installation

# install from pip
pip install csle-system-identification==<version>
# local install from source
$ pip install -e csle-system-identification
# or (equivalently):
make install
# force upgrade deps
$ pip install -e csle-system-identification --upgrade
# git clone and install from source
git clone https://github.com/Kim-Hammar/csle
cd csle/simulation-system/libs/csle-system-identification
pip3 install -e .
# Install development dependencies
$ pip install -r requirements_dev.txt

Development tools

Install all development tools at once:

make install_dev

pip install -r requirements_dev.txt

API documentation

This section contains instructions for generating API documentation using sphinx.

Latest Documentation

The latest documentation is available at https://kim-hammar.github.io/csle//docs/csle-system-identification

Generate API Documentation

First make sure that the CSLE_HOME environment variable is set:

echo $CSLE_HOME

Then generate the documentation with the commands:

cd docs
sphinx-apidoc -f -o source/ ../src/csle_system_identification/
make html

To update the official documentation at https://kim-hammar.github.io/csle/, copy the generated HTML files to the documentation folder:

cp -r build/html ../../../../docs/_docs/csle-system-identification

To run all documentation commands at once, use the command:

make docs

Static code analysis

To run the Python linter, execute the following command:

flake8 .
# or (equivalently):
make lint

To run the mypy type checker, execute the following command:

mypy .
# or (equivalently):
make types

Unit tests

To run the unit tests, execute the following command:

pytest
# or (equivalently):
make unit_tests

To run tests of a specific test suite, execute the following command:

pytest -k "ClassName"

To generate a coverage report, execute the following command:

pytest --cov=csle_system_identification

Run tests and code analysis in different python environments

To run tests and code analysis in different python environemnts, execute the following command:

tox
# or (equivalently):
make tests

Create a new release and publish to PyPi

First build the package by executing:

python3 -m build
# or (equivalently)
make build

After running the command above, the built package is available at ./dist.

Push the built package to PyPi by running:

python3 -m twine upload dist/*
# or (equivalently)
make push

To run all commands for the release at once, execute:

make release

Author & Maintainer

Kim Hammar kimham@kth.se

Copyright and license

LICENSE

Creative Commons

Metadata

Release files for csle-system-identification 0.10.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for csle-system-identification 0.10.1
File	Size	Uploaded
csle_system_identification-0.10.1.tar.gz	32.8 kB	Sep 14, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for csle-system-identification 0.10.1
File	Interpreter	ABI	Platform	Reset
csle_system_identification-0.10.1-py3-none-any.whl 28.8 kB Sep 14, 2026	Python 3	none	any	Details

Total release size: 61.7 kB

Release files / csle_system_identification-0.10.1.tar.gz

Download URL	csle_system_identification-0.10.1.tar.gz
Size	32.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`ad2ec787f677b42ea9607f0d2f9b53cec29e7149f4f28380f2850a1a5598b571`
BLAKE2b-256 checksum How to use checksums	`9b8daf9f03c066845e9bd1aaad438b44466f934fa6ead68693b99d73ba0189b5`
Upload date	Sep 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.11.11`

Release files / csle_system_identification-0.10.1-py3-none-any.whl

Download URL	csle_system_identification-0.10.1-py3-none-any.whl
Size	28.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`c129f11e90a70f0a79a004929b9a5152304be6163ca3449f6463beb565b29665`
BLAKE2b-256 checksum How to use checksums	`c882ee0ae1689cdabb4690b72a13840d87df8f6951e84e682cdcb34bb010b6c4`
Upload date	Sep 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.1.0 CPython/3.11.11`