Update Part Locations

This example demonstrates how to connect to the Sherlock gRPC service, import a project, and update part locations.

Description

Sherlock’s gRPC API allows users to automate workflows such as updating part locations for CCAs. This script shows how to: - Connect to the Sherlock service. - Import a project. - Update part locations.

The updated part locations can be used for accurate placement validation and optimization.

import os

from examples.examples_globals import get_sherlock_tutorial_path

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

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(), "Tutorial Project.zip"),
    )
    print("Tutorial project imported successfully.")
except SherlockImportProjectZipArchiveError as e:
    print(f"Error importing project zip archive: {e}")

Update Part Locations

Update the part locations for the “Card” of the “Test” project.

try:
    part_locations = [
        ("C1", "-2.7", "-1.65", "0", "in", "TOP", "False"),
        ("J1", "-3.55", "-2.220446049250313E-16", "90", "in", "TOP", "False"),
    ]
    sherlock.parts.update_parts_locations(
        project="Test",
        cca_name="Main Board",
        part_loc=part_locations,
    )
    print("Part locations updated successfully.")
except SherlockUpdatePartsLocationsError as e:
    print(f"Error updating part locations: {e}")