Skip to main content

D-Geo Stability

VIKTOR's D-Geo Stability integration requires a specific D-Geo Stability worker which can be downloaded here.

Analyzing a D-Geo Stability model in VIKTOR can be done using the DGeoStabilityAnalysis class (worker required). No binding is provided by VIKTOR for this module, which means that the input file has to be generated manually:

import viktor as vkt

# Generate the input STI file.
input_file = ...

# Run the analysis and obtain the output file.
analysis = vkt.dgeostability.DGeoStabilityAnalysis(input_file)
analysis.execute(timeout=10)
output_file = analysis.get_output_file()

Testing

New in v13.5.0

mock_DGeoStabilityAnalysis decorator for easier testing of DGeoStabilityAnalysis

DGeoStabilityAnalysis.execute needs to be mocked within the context of (automated) testing.

The viktor.testing module provides the mock_DGeoStabilityAnalysis decorator that facilitate mocking of workers:

import unittest

from viktor import File
from viktor.testing import mock_DGeoStabilityAnalysis

from app.my_entity_type.controller import MyEntityTypeController

class TestMyEntityTypeController(unittest.TestCase):

@mock_DGeoStabilityAnalysis(get_output_file={
'.sto': File.from_path('test_output.sto'),
})
def test_dgeostability_analysis(self):
MyEntityTypeController().dgeostability_analysis()

For the decorator's input parameters the following holds:

  • If a Sequence type is provided, the next entry is returned for each corresponding method call. When a call is performed on a depleted iterable, an Exception is raised.
  • If a single object is provided, the object is returned each time the corresponding method is called (endlessly).
  • If None is provided (default), a default File/BytesIO object (with empty content) is returned each time the corresponding method is called (endlessly).