Update Random Vibration Properties

This example demonstrates how to connect to the Sherlock gRPC service, import a project, and update random vibration properties.

Description

Sherlock allows you to configure random vibration properties for specific PCBs. This script performs the following steps: - Connect to the Sherlock service. - Import a project. - Update random vibration properties.

For further details, refer to the official documentation on random vibration properties in Sherlock.

import os

from examples.examples_globals import get_sherlock_tutorial_path

from ansys.sherlock.core import launcher
from ansys.sherlock.core.errors import (
    SherlockImportProjectZipArchiveError,
    SherlockUpdateRandomVibePropsError,
)

Connect to Sherlock

Connect to the Sherlock service and ensure proper initialization.

sherlock = launcher.connect(port=9092, timeout=10)

Delete Project

Delete the project if it already exists.

try:
    sherlock.project.delete_project("Test")
    print("Project deleted successfully.")
except Exception:
    pass

Import Tutorial Project

Import the tutorial project zip archive from the Sherlock tutorial directory.

try:
    sherlock.project.import_project_zip_archive(
        project="Test",
        category="Demos",
        archive_file=os.path.join(get_sherlock_tutorial_path(), "Auto Relay Project.zip"),
    )
    print("Tutorial project imported successfully.")
except SherlockImportProjectZipArchiveError as e:
    print(f"Error importing project zip archive: {e}")

Update Random Vibration Properties

Configure random vibration properties for the PCB.

try:
    sherlock.analysis.update_random_vibe_props(
        project="Test",
        cca_name="Auto Relay",
        random_vibe_damping="0.01, 0.03",
        part_validation_enabled=False,
        require_material_assignment_enabled=False,
        model_source="GENERATED",
    )
    print("Random vibration properties updated successfully.")
except SherlockUpdateRandomVibePropsError as e:
    print(f"Error updating random vibration properties: {e}")