Versions Compared

Old Version 1

changes.mady.by.user Victoria Bruny

Saved on

compared with

New Version Current

changes.mady.by.user Maxime Josse

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

General

...

enableHyWorksApiExceptions():

...

Enable HyWorksApi to return HYPERSIM exceptions through Python

...

getProperty(key):

...

Get HYPERSIM property

Parameters:

key (str) – property key

Returns:

HYPERSIM property

Return type:

str

Raises:

AssertionError – raises exception on error

Examples:

  • HyWorksApi.getProperty(“hyworks.hysim.extraTimeout”)

...

...

Close HyperWorks

Examples:

  • HyWorksApi.closeHyperWorks()

...

connectToHyWorks(host=socket.gethostname(), register=getpass.getuser(), timeout=120000, index=1):

...

Connect HyJavaApi to HYPERSIM

Parameters:

  • host (str) – computer name

  • register (str) – user name

  • timeout (int) – timeout for function

  • id (int) – Hyworks index to register to

Returns:

error value

Return type:

int

Raises:

AssertionError – raises exception on error

...

disableHyWorksApiExceptions():

...

Disable HyWorksApi from returning ScopeView exceptions through Python

...

General

closeHyperWorks():

Anchor
HyWorksApiGRPC.getPropertiescloseHyperWorks
HyWorksApiGRPC.getPropertiescloseHyperWorks
HyWorksApiGRPC.getPropertiescloseHyperWorks()

Get current HYPERSIM general properties

Returns:

HYPERSIM general properties

Return type:

str

...

Close HyperWorks

Examples:

  • HyWorksApi.closeHyperWorks()

closeLibrary(libraryPath):

Anchor
HyWorksApiGRPC.setPropertycloseLibrary
HyWorksApiGRPC.setPropertycloseLibrary
HyWorksApiGRPC.setProperty(key, value, save=False)
Set HYPERSIM general property
closeLibrary(libraryPath)

close a CLF library located at the specified ‘libraryPath’.

Parameters:key

libraryPath (str) –

property key

  • value (str) – property value

  • save (bool) – save preferences for the next session

    • Returns:

    error value

    Return type:

    bool

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.setProperty(“hyworks.hysim.extraTimeout”, “1200000”)

    • HyWorksApi.setProperty(“hyworks.hysim.extraTimeout”, “1800000”, True)

    ...

    The path to the CLF library to be closed.

    Returns:

    True if the library was successfully closed; False otherwise.

    Return type:

    bool

    connectToHyWorks(host=socket.gethostname(), register=getpass.getuser(), timeout=120000, id=None):

    Anchor
    HyWorksApiGRPC.startHyperWorksconnectToHyWorks
    HyWorksApiGRPC.startHyperWorksconnectToHyWorks
    HyWorksApiGRPC.startHyperWorks(stdout=None, stderr=None)

    Start HYPERSIM

    Parameters:

    • stdout – standard output

    • stderr – standard error

    Examples:

    • HyWorksApi.startHyperWorks()

    ...

    AnchorHyWorksApiGRPC.startAndConnectHypersimHyWorksApiGRPC.startAndConnectHypersimHyWorksApiGRPC.startAndConnectHypersim(host=socket.gethostname(), register=getpass.getuser(), stdout=None, stderr=None, timeout=2500)Open and connect
    connectToHyWorks(host=socket.gethostname(), register=getpass.getuser(),

    ...

    timeout=120000, id=None)

    Connect HyJavaApi to HYPERSIM

    Parameters:

    • host (str) – computer name

    • register (str) – user name

    • stdout – standard output

    • stderr – standard error

    • timeout (int) – timeout for function

    • id (int) – Hyworks index to register to

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    Design

    ...

    disableHyWorksApiExceptions(

    ...

    ):

    Anchor
    HyWorksApiGRPC.closeDesigndisableHyWorksApiExceptions
    HyWorksApiGRPC.closeDesigndisableHyWorksApiExceptions
    HyWorksApiGRPC.closeDesigndisableHyWorksApiExceptions(designPath)

    Close design

    Parameters:

    designPath (str) – path to the HYPERSIM model (.ecf)

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    Disable HyWorksApi from returning ScopeView exceptions through Python

    enableHyWorksApiExceptions():

    ...

    Anchor
    HyWorksApiGRPC.enableHyWorksApiExceptions
    HyWorksApiGRPC.enableHyWorksApiExceptions
    HyWorksApiGRPC.enableHyWorksApiExceptions()

    Enable HyWorksApi to return HYPERSIM exceptions through Python

    ...

    getCurrentDesign():

    ...

    Anchor
    HyWorksApiGRPC.getCurrentDesign
    HyWorksApiGRPC.getCurrentDesign
    HyWorksApiGRPC.getCurrentDesign()

    ...

    getProperties():

    Anchor
    HyWorksApiGRPC.disconnectDesigngetProperties
    HyWorksApiGRPC.disconnectDesigngetProperties
    HyWorksApiGRPC.disconnectDesigngetProperties(designPath)

    Disconnect HyWorksApi from the HYPERSIM model

    Parameters:

    designPath (str) – path to the HYPERSIM model (.ecf)

    Returns:

    error value

    Get current HYPERSIM general properties

    Returns:

    HYPERSIM general properties

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    str

    getProperty(key):

    Anchor
    HyWorksApiGRPC.displayConnectionsgetProperty
    HyWorksApiGRPC.displayConnectionsgetProperty
    HyWorksApiGRPC.displayConnectionsgetProperty(key)

    Print specified component interconnections to STDOUTGet HYPERSIM property Refer to the following page of the documentation to find the properties names:

    Parameters:

    componentName key (str) – component nameproperty key

    Returns:

    error valueHYPERSIM property

    Return type:

    str

    Raises:

    AssertionError – raises exception on error

    ...

    Examples:

    • HyWorksApi.getProperty(“hyworks.hysim.extraTimeout”)

    getVersion(long=False) :

    Anchor
    HyWorksApiGRPC.getDesignPrefsgetVersion
    HyWorksApiGRPC.getDesignPrefsgetVersion
    HyWorksApiGRPC.getDesignPrefsgetVersion(long=False)

    Get current model preferencesthe current HYPERSIM version name

    Parameters:

    long (bool) – Add ‘’ prefix, which is necessary for certain compatibility usage

    Returns:

    model preferencesHYPERSIM version

    Return type:

    str

    ...

    openLibrary(

    ...

    libraryPath,

    ...

    visible=True):

    Anchor
    HyWorksApiGRPC.importEDDopenLibrary
    HyWorksApiGRPC.importEDDopenLibrary
    HyWorksApiGRPC.importEDDopenLibrary(eddFilePathlibraryPath, doConnections)
    Import EDD to current HYPERSIM model
    visible=True)

    opens a CLF library located at the specified ‘libraryPath’.

    Parameters:

    • eddFilePath libraryPath (str) – The path to EDD (.edd)doConnections the CLF library to be opened.

    • visible (bool) – connect imported devices(Optional) A boolean indicating whether the library should be opened in a visible state (default is True).

    Returns:

    error valueTrue if the library was successfully opened; False otherwise.

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    bool

    setProperty(key, value, save=False):

    Anchor
    HyWorksApiGRPC.newDesignsetProperty
    HyWorksApiGRPC.newDesignsetProperty
    HyWorksApiGRPC.newDesign(designFilePath=None)
    Create new HYPERSIM model
    setProperty(key, value, save=False)

    Set HYPERSIM general property Refer to the following page of the documentation to find the properties names:

    Parameters:designFilePath

    • key (str) –

    path to the HYPERSIM model (.ecf)

    • property key

    • value (str) – property value

    • save (bool) – save preferences for the next session

    Returns:

    error value

    Return type:

    intbool

    Raises:

    AssertionError – raises exception on error

    ...

    Examples:

    • HyWorksApi.setProperty(“hyworks.hysim.extraTimeout”, “1200000”)

    • HyWorksApi.setProperty(“hyworks.hysim.extraTimeout”, “1800000”, True)

    startAndConnectHypersim(host=socket.gethostname(), register=getpass.getuser(), stdout=None, stderr=None:

    startHyperWorks(stdout=None, stderr=None):

    Anchor
    HyWorksApiGRPC.openDesignstartHyperWorks
    HyWorksApiGRPC.openDesignstartHyperWorks
    HyWorksApiGRPC.openDesign(designPathstartHyperWorks(stdout=None, stderr=None)

    Open Start HYPERSIM model

    Parameters:

    • stdout – standard output

    • stderr – standard error

    Examples:

    • HyWorksApi.startHyperWorks()

    ...

    Design

    closeDesign(designPath):

    Anchor
    HyWorksApiGRPC.closeDesign
    HyWorksApiGRPC.closeDesign
    HyWorksApiGRPC.closeDesign(designPath)

    Close design

    Parameters:

    designPath (str) – path to the HYPERSIM model (.ecf)

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    disconnectDesign(designPath):

    Anchor
    HyWorksApiGRPC.recheckPortsdisconnectDesign
    HyWorksApiGRPC.recheckPortsdisconnectDesign
    HyWorksApiGRPC.recheckPortsdisconnectDesign(designPath)

    Check connections by page connectors Recommended after build circuits involving page connectors via APIDisconnect HyWorksApi from the HYPERSIM model

    Parameters:

    designPath (str) – path to the HYPERSIM model (.ecf)

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    findMinimalStepSize(

    ...

    timeout, overrunsThreshold: int, nCores=100, startingTimeStep=1e-6, jump=1e-6):

    Anchor
    HyWorksApiGRPC.saveDesignfindMinimalStepSize
    HyWorksApiGRPC.saveDesign
    HyWorksApiGRPC.saveDesign()

    Save current HYPERSIM model

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    findMinimalStepSize
    HyWorksApiGRPC.findMinimalStepSize(timeout, overrunsThreshold: int, nCores=100, startingTimeStep=1e-6, jump=1e-6)

    Determines the smallest possible time step that prevents exceeding a specified number of overruns. This function requires Dashboards to be enabled beforehand. It attempts to start and stop the simulation in each iteration while staying within the overrun limit, ensuring the number of overruns does not reach the threshold. If the simulation completes before reaching the specified timeout, the time step is incremented by the given jump value. The minimal time step is identified when the simulation completes without timing out.

    Parameters:

    • timeout (float) – Maximum allowed simulation iteration time in seconds.

    • overrunsThreshold – The maximum number of overruns per iteration that must not be reached, for example,

    setting it to 1 means the program will iterate if the current simulation iteration experiences at least one overrun. Note that the threshold must be greater than 0. :type overrunsThreshold: int :param nCores: Number of processor cores to use (Default: 100). If the specified number exceeds available hardware cores, all available cores will be used. A value of 0 enables automatic core assignment. :type nCores: int :param startingTimeStep: Initial time step in seconds (Default: 1 microsecond) :type startingTimeStep: float :param jump: Increment for the time step in seconds (Default: 1 microsecond) :type jump: float :return: The minimal time step in seconds, or None if unsuccessful :rtype: float :raises AssertionError: raises exception on error

    getAllComponentDescriptions():

    ...

    Anchor
    HyWorksApiGRPC.getAllComponentDescriptions
    HyWorksApiGRPC.getAllComponentDescriptions
    HyWorksApiGRPC.getAllComponentDescriptions()

    ...

    getAllComponentParameters(compName):

    ...

    Anchor
    HyWorksApiGRPC.getAllComponentParameters
    HyWorksApiGRPC.getAllComponentParameters
    HyWorksApiGRPC.getAllComponentParameters(compName)

    ...

    getAllComponentSensors(compName):

    ...

    Anchor
    HyWorksApiGRPC.getAllComponentSensors
    HyWorksApiGRPC.getAllComponentSensors
    HyWorksApiGRPC.getAllComponentSensors(compName)

    ...

    getAllDevicesNames():

    ...

    Anchor
    HyWorksApiGRPC.getAllDevicesNames
    HyWorksApiGRPC.getAllDevicesNames
    HyWorksApiGRPC.getAllDevicesNames()

    Gets the list of all devices names

    Returns:

    the list of all visible devices

    Return type:

    list

    Raises:

    AssertionError – raises exception on error

    Info

    This call requires an analyze call before to function properly

    ...

    getDesignPrefs():

    ...

    Anchor
    HyWorksApiGRPC.getDesignPrefs
    HyWorksApiGRPC.getDesignPrefs
    HyWorksApiGRPC.getDesignPrefs()

    Get current model preferences

    Returns:

    model preferences

    Return type:

    str

    ...

    importEDD(eddFilePath, doConnections):

    ...

    Anchor
    HyWorksApiGRPC.importEDD
    HyWorksApiGRPC.importEDD
    HyWorksApiGRPC.importEDD(eddFilePath, doConnections)

    Import EDD to current HYPERSIM model

    Parameters:

    • eddFilePath (str) – path to EDD (.edd)

    • doConnections (bool) – connect imported devices

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    importPSCAD(filePath, onlyDll, removeNotConnectedBuses=False):

    ...

    Anchor
    HyWorksApiGRPC.importPSCAD
    HyWorksApiGRPC.importPSCAD
    HyWorksApiGRPC.importPSCAD(filePath, onlyDll, removeNotConnectedBuses=False)

    ...

    importPSSE(filePath, replaceMachines=False, groupMachinesWithControls=True):

    ...

    Anchor
    HyWorksApiGRPC.importPSSE
    HyWorksApiGRPC.importPSSE
    HyWorksApiGRPC.importPSSE(filePath, replaceMachines=False, groupMachinesWithControls=True)

    ...

    importPowerFactory(filePath, mode=0):

    ...

    Anchor
    HyWorksApiGRPC.importPowerFactory
    HyWorksApiGRPC.importPowerFactory
    HyWorksApiGRPC.importPowerFactory(filePath, mode=0)

    Import PowerFactory

    Parameters:

    • filePath (str) – path to PowerFactory file (.xml)

    • mode (int) – select switch import mode (Default: 0): 0 (All switches are removed), 1 (All switches are added), 2 (Only switches with events are added)

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    newDesign(designFilePath=None):

    ...

    Anchor
    HyWorksApiGRPC.newDesign
    HyWorksApiGRPC.newDesign
    HyWorksApiGRPC.newDesign(designFilePath=None)

    Create new HYPERSIM model

    Parameters:

    designFilePath (str) – path to the HYPERSIM model (.ecf)

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    openDesign(designPath):

    ...

    Anchor
    HyWorksApiGRPC.openDesign
    HyWorksApiGRPC.openDesign
    HyWorksApiGRPC.openDesign(designPath)

    Open HYPERSIM model

    Parameters:

    designPath (str) – path to HYPERSIM model (.ecf)

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    recheckPorts():

    ...

    Anchor
    HyWorksApiGRPC.recheckPorts
    HyWorksApiGRPC.recheckPorts
    HyWorksApiGRPC.recheckPorts()

    Check connections by page connectors Recommended after build circuits involving page connectors via API

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    saveDesign():

    ...

    Anchor
    HyWorksApiGRPC.saveDesign
    HyWorksApiGRPC.saveDesign
    HyWorksApiGRPC.saveDesign()

    Save current HYPERSIM model

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    saveDesignAs(fileName):

    ...

    Anchor
    HyWorksApiGRPC.saveDesignAs
    HyWorksApiGRPC.saveDesignAs
    HyWorksApiGRPC.saveDesignAs(fileName)

    Save current HYPERSIM model

    Parameters:

    fileName (str) – desired model path

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    updateEDD(eddFilePath, doConnections):

    ...

    Anchor
    HyWorksApiGRPC.updateEDD
    HyWorksApiGRPC.updateEDD
    HyWorksApiGRPC.updateEDD(eddFilePath, doConnections)

    Update EDD

    Parameters:

    • eddFilePath (str) – path to EDD (.edd)

    • doConnections (bool) – connect imported devices

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    Device

    activateObservables(deviceName, observables):

    ...

    Anchor
    HyWorksApiGRPC.activateObservables
    HyWorksApiGRPC.activateObservables
    HyWorksApiGRPC.activateObservables(deviceName, observables)

    Activate a list of observable pins on the device

    Parameters:

    • deviceName (str) – name of the first device

    • observables (list[str]) – list of observable names. If list is empty, all observables are removed. Note that it does not append, but is the final list of observables

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.activateObservables(‘Imeas1’, [‘a’, ‘b’])

    • HyWorksApi.activateObservables(‘Imeas1’, [])

    ...

    addBus1ph(signalName, points, hitCheck=False, subcircuit=None):

    ...

    Anchor
    HyWorksApiGRPC.addBus1ph
    HyWorksApiGRPC.addBus1ph
    HyWorksApiGRPC.addBus1ph(signalName, points, hitCheck=False, subcircuit=None)

    Add a 1 phase bus to HYPERSIM model.

    Parameters:

    • signalName (str) – signal name

    • points (list[list[int]]) – list of points as X-Y coordinates

    • hitCheck (bool) – true to check for connections to other signals at both ends of the line

    • subcircuit (str) – subcircuit path

    Returns:

    unique signal name

    Return type:

    str

    Examples:

    • HyWorksApi.addBus1ph(‘myBus’, [[-700, 0], [700, 0]])

    Info

    until connected to a power pin, a 1 phase bus is considered a control signal

    ...

    addBus3ph(signalName, points, hitCheck=False, subcircuit=None):

    ...

    Anchor
    HyWorksApiGRPC.addBus3ph
    HyWorksApiGRPC.addBus3ph
    HyWorksApiGRPC.addBus3ph(signalName, points, hitCheck=False, subcircuit=None)

    Add a 3 phase bus to HYPERSIM model

    Parameters:

    • signalName (str) – signal name

    • points (list[list[int]]) – list of points as X-Y coordinates

    • hitCheck (bool) – true to check for connections to other signals at both ends of the line.

    • subcircuit (str) – subcircuit path

    Returns:

    unique signal name

    Return type:

    str

    Examples:

    • HyWorksApi.addBus3ph(‘myBus’, [[-700, 0], [700, 0]])

    ...

    addControlSignal(signalName, points, hitCheck=False, subcircuit=None):

    ...

    Anchor
    HyWorksApiGRPC.addControlSignal
    HyWorksApiGRPC.addControlSignal
    HyWorksApiGRPC.addControlSignal(signalName, points, hitCheck=False, subcircuit=None)

    Add a control signal to HYPERSIM model

    Parameters:

    • signalName (str) – signal name

    • points (list[list[int]]) – list of points as X-Y coordinates

    • hitCheck (bool) – true to check for connections to other signals at both ends of the line.

    • subcircuit (str) – subcircuit path

    Returns:

    unique signal name

    Return type:

    str

    Examples:

    • HyWorksApi.addControlSignal(‘signal1’, [[-700, 0], [700, 0], [700, 700])

    ...

    addDevice(libName, blocName, coordX=0, coordY=0, page=1, subcircuit=None, name=None):

    Anchor
    HyWorksApiGRPC.saveDesignAsaddDevice
    HyWorksApiGRPC.saveDesignAsaddDevice
    HyWorksApiGRPC.saveDesignAs(fileName)
    Save current
    addDevice(libName, blocName, coordX=0, coordY=0, page=1, subcircuit=None, name=None)

    Add device to HYPERSIM model

    Parameters:fileName

    • libName (str) –

    desired model path
    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    updateEDD(eddFilePath, doConnections):

    ...

    Update EDD

    Parameters:

    • eddFilePath (str) – path to EDD (.edd)

    • doConnections (bool) – connect imported devices

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    Device

    ...

    • device library name

    • blocName (str) – device name

    • coordX (int) – X coordinate

    • coordY (int) – Y coordinate

    • page (int) – page number

    • subcircuit (str) – subcircuit path

    • name (str) – Name to assign to the device. If non, a default name will be assigned

    Returns:

    unique device name, reusable in the other APIs

    Return type:

    str

    Examples:

    • HyWorksApi.addDevice(‘Network RLC.clf’, ‘R grounded’, 700, 700)

    • HyWorksApi.addDevice(‘Network RLC.clf’, ‘R grounded’, 700, 700, 1, “MySubCircuit”, “Resistor1”)

    Info

    The library name must include the .clf for this to work.

    addPinsToDevice(name, cardinalPoint, function, pins, redraw=False):

    Anchor
    HyWorksApiGRPC.activateObservablesaddPinsToDevice
    HyWorksApiGRPC.activateObservablesaddPinsToDevice
    HyWorksApiGRPC.activateObservables(deviceName, observables)
    Activate a list of observable pins on the
    addPinsToDevice(name, cardinalPoint, function, pins, redraw=False)

    Add pins, bundles, or pins inside bundles on a device

    Parameters:

    • deviceName name (str) – device name

    • cardinalPoint (str) – Location on the symbol of the first deviceobservables

    • function (str) – The function of the listed pins. Input, Output or Power

    • pins (list[str]) – list of observable names. If list is empty, all observables are removed. Note that it does not append, but is the final list of observablesList of pins

    • redraw (bool) – if True, the symbol will be redrawn with a default representation

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.activateObservables(‘Imeas1’addPinsToDevice(‘SubCircuit1’, ‘N’, ‘I’, [‘a’‘in1’], ‘b’]True)

    • HyWorksApi.activateObservables(‘Imeas1’addPinsToDevice(‘SubCircuit7’, ‘S’, ‘P’, [‘pow1’])

    addControlSignal(signalName, points, hitCheck = False, subcircuit=None):

    ...

    Add a control signal to HYPERSIM model

    Parameters:

    • signalName (str) – signal name

    • points (list[list[int]]) – list of points as X-Y coordinates

    • hitCheck (bool) – true to check for connections to other signals at both ends of the line.

    • subcircuit (str) – subcircuit path

    Returns:

    unique signal name

    Return type:

    str

    Examples:

    • HyWorksApi.addControlSignal(‘signal1’, [[-700, 0], [700, 0], [700, 700])

    ...

    • , True)

    • HyWorksApi.addPinsToDevice(‘SubCircuit1’, ‘W’, ‘O’, [‘Bundle1[o1]’, ‘Bundle1[o2]’, ‘Bundle1[o3]’], True)

    • And to make a sub circuit port connect with the sub circuit pins :

    • HyWorksApi.addPinsToDevice(‘SubCircuit1/SubCircuitPort’, ‘W’, ‘I’, [‘PORT[o1]’, ‘PORT[o2]’, ‘PORT[o3]’)

    connectBundleToBundle(blocA, signalListA, blocB, signalListB):

    Anchor
    HyWorksApiGRPC.addBus1phconnectBundleToBundle
    HyWorksApiGRPC.addBus1phconnectBundleToBundle
    HyWorksApiGRPC.addBus1phconnectBundleToBundle(signalNameblocA, points signalListA, hitCheck=False, subcircuit=None)
    Add a 1 phase bus to HYPERSIM model.
    blocB, signalListB)

    Connect two bundle pins together

    Parameters:unique signal name

    • signalName blocA (str) – signal name of the first device

    • points signalListA (list[list[int]str]) – list of points as X-Y coordinates

    • hitCheck (bool) – true to check for connections to other signals at both ends of the line

    • subcircuit (str) – subcircuit path

    		Returns:

    • first bundle signals. ex: [‘a’,’b’,’c’]

    • blocB (str) – name of the first pin

    • signalListB (list[str]) – list of second bundle signals. ex: [‘a’,’b’,’c’]

    Returns:

    error value

    Return type:

    strint

    Examples
    Raises:

    • HyWorksApi.addBus1ph(‘myBus’, [[-700, 0], [700, 0]])

    Info

    until connected to a power pin, a 1 phase bus is considered a control signal

    ...

    AssertionError – raises exception on error

    connectDeviceToBus1ph(deviceName, pinName, signalName):

    Anchor
    HyWorksApiGRPC.addBus3phconnectDeviceToBus1ph
    HyWorksApiGRPC.addBus3phconnectDeviceToBus1ph
    HyWorksApiGRPC.addBus3phconnectDeviceToBus1ph(signalNamedeviceName, points, hitCheck=False, subcircuit=None)
    Add a 3 phase bus to HYPERSIM model
    pinName, signalName)

    Connects a device onto 1 phase bus

    Parameters:Return type:str

    • signalName deviceName (str) – signal device name

    • points (list[list[int]]) – list of points as X-Y coordinates

    • hitCheck (bool) – true to check for connections to other signals at both ends of the line.

    • subcircuit (str) – subcircuit path

    Returns:

    unique signal name

    • pinName (str) – device pin name

    • signalName (str) – signal name

    Returns:

    error value

    Return type:

    bool

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.addBus3phconnectDeviceToBus1ph(‘myBus’, [[-700, 0], [700, 0]])

    ...

    • ‘R1’, ‘net_1’, ‘myBus’)

    • HyWorksApi.connectDeviceToBus1ph(‘SubCC1/SubSubCC1/R3’, ‘net_1’, ‘myBus’)

    connectDeviceToBus3ph(deviceName, pinName, signalName):

    Anchor
    HyWorksApiGRPC.addDeviceconnectDeviceToBus3ph
    HyWorksApiGRPC.addDeviceconnectDeviceToBus3ph
    HyWorksApiGRPC.addDeviceconnectDeviceToBus3ph(libNamedeviceName, blocName, coordX=0, coordY=0, page=1, subcircuit=None, name=None)
    Add device to HYPERSIM model
    pinName, signalName)

    Connects a device onto 3 phase bus

    Parameters:

    • libName (str) – device library name

    • blocName deviceName (str) – device name

    • coordX (int) – X coordinate

    • coordY (int) – Y coordinate

    • page (int) – page number

    • subcircuit

    • pinName (str) – subcircuit pathname device pin name

    • signalName (str) – Name to assign to the device. If non, a default name will be assignedsignal name

    Returns:

    unique device name, reusable in the other APIserror value

    Return type:

    bool

    Raises:

    strAssertionError – raises exception on error

    Examples:

    • HyWorksApi.addDevice(‘Network RLC.clf’, ‘R grounded’, 700, 700connectDeviceToBus3ph(‘R1’, ‘net_1’, ‘myBus’)

    • HyWorksApi.addDevice(‘Network RLC.clf’, ‘R grounded’, 700, 700, 1, “MySubCircuit”, “Resistor1”)

    Info

    The library name must include the .clf for this to work.

    ...

    • connectDeviceToBus3ph(‘SubCC1/SubSubCC1/R3’, ‘net_1’, ‘myBus’)

    connectDeviceToControlSignal(deviceName, pinName, signalName):

    Anchor
    HyWorksApiGRPC.addPinsToDeviceconnectDeviceToControlSignal
    HyWorksApiGRPC.addPinsToDeviceconnectDeviceToControlSignal
    HyWorksApiGRPC.addPinsToDeviceconnectDeviceToControlSignal(namedeviceName, cardinalPoint, function, pins, redraw=False)
    Add pins, bundles, or pins inside bundles on a device
    pinName, signalName)

    Connects a device onto a control signal

    Parameters:

    • name deviceName (str) – device name

    • cardinalPoint pinName (str) – Location on the symbol of the device

    • function (str) – The function of the listed pins. Input, Output or Power

    • pins (list[str]) – List of pins

    • redraw (bool) – if True, the symbol will be redrawn with a default representationdevice pin name

    • signalName (str) – signal name

    Returns:

    error value

    Return type:

    intbool

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.addPinsToDevice(‘SubCircuit1’, ‘N’, ‘I’, [‘in1’], True)

    • HyWorksApi.addPinsToDevice(‘SubCircuit7’, ‘S’, ‘P’, [‘pow1’], True)

    • HyWorksApi.addPinsToDevice(‘SubCircuit1’, ‘W’, ‘O’, [‘Bundle1[o1]’, ‘Bundle1[o2]’, ‘Bundle1[o3]’], True)

    • And to make a sub circuit port connect with the sub circuit pins :

    • HyWorksApi.addPinsToDevice(‘SubCircuit1/SubCircuitPort’, ‘W’, ‘I’, [‘PORT[o1]’, ‘PORT[o2]’, ‘PORT[o3]’)

    ...

    • connectDeviceToControlSignal(‘Const1’, ‘y’, ‘s1’)

    connectDevices(blocA, pinA, blocB, pinB, isThreePhaseAndPowerFlexible, signalName=None):

    Anchor
    HyWorksApiGRPC.connectBundleToBundleconnectDevices
    HyWorksApiGRPC.connectBundleToBundleconnectDevices
    HyWorksApiGRPC.connectBundleToBundleconnectDevices(blocA, signalListA pinA, blocB, signalListB pinB, isThreePhaseAndPowerFlexible, signalName=None)

    Connect two bundle device pins together

    Parameters:

    • blocA (str) – name of the first device

    • signalListA pinA (list[str]) – list name of first bundle signals. ex: [‘a’,’b’,’c’]blocB the first pin

    • blocB (str) – name of the second device

    • pinB (str) – name of the first pinsignalListB (list[str]) – list of second bundle signals. ex: [‘a’,’b’,’c’]second pin

    • isThreePhaseAndPowerFlexible (bool) – make the connection 3 phase, for components which can be both 1 phase or 3 phases

    • signalName (str) – new signal name on the connection

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.connectDevices(‘Max1’, ‘y’, ‘mySubCircuit’, ‘a1’, False)

    • HyWorksApi.connectDevices(‘mySubCircuit/B1’, ‘a1’, ‘mySubCircuit/Gain1’, ‘u’, False)

    ...

    connectPinToBundle(blocA, pinA, blocB,

    ...

    signalListB):

    Anchor
    HyWorksApiGRPC.connectDevicesconnectPinToBundle
    HyWorksApiGRPC.connectDevicesconnectPinToBundle
    HyWorksApiGRPC.connectDevicesconnectPinToBundle(blocA, pinA, blocB, pinB, isThreePhaseAndPowerFlexible, signalName=None signalListB)

    Connect two device pinsa pin to a bundle’s signal

    Parameters:

    • blocA (str) – name of the first device

    • pinA (str) – pin name of the first pin

    • blocB (str) – name of the second devicepinB (str) – name of the second pindevice

    • isThreePhaseAndPowerFlexible (bool) – make the connection 3 phase, for components which can be both 1 phase or 3 phases

    • signalName (signalListB (str) – new bundle signal name on the connection

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.connectDevices(‘Max1’, ‘y’, ‘mySubCircuit’, ‘a1’, False)

    • HyWorksApi.connectDevices(‘mySubCircuit/B1’, ‘a1’, ‘mySubCircuit/Gain1’, ‘u’, False)

    ...

    createSubCircuit(name, subType, coordX=0, coordY=0, page=1):

    Anchor
    HyWorksApiGRPC.connectDeviceToControlSignalcreateSubCircuit
    HyWorksApiGRPC.connectDeviceToControlSignalcreateSubCircuit
    HyWorksApiGRPC.connectDeviceToControlSignal(deviceName, pinName, signalName)
    Connects a device onto a control signal
    createSubCircuit(name, subType, coordX=0, coordY=0, page=1)

    Create a subcircuit with the specified ‘name’ and ‘subType’ at the given coordinates on the specified page.

    Parameters:

    • deviceName name (str) – device subcircuit definition namepinName

    • subType (str) – device pin namesignalName (str) – signal namesubcircuit type name. This name will show when redrawing the device

    • coordX (int) – X coordinate

    • coordY (int) – Y coordinate

    • page (int) – page number

    Returns:

    error valueunique device name

    Return type:

    boolstr

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.connectDeviceToControlSignal(‘Const1’, ‘y’, ‘s1’)

    ...

    Examples:

    • HyWorksApi.createSubCircuit(‘Subcircuit1’, 700, 700, 1)

    • HyWorksApi.createSubCircuit(‘Subcircuit1’, ‘THD’, 700, 700,1)

    • HyWorksApi.createSubCircuit(‘DEV1/Subsubcircuit1’)

    disconnectPin(deviceName, pinName,

    ...

    removeAllConnections=False):

    Anchor
    HyWorksApiGRPC.connectDeviceToBus1phdisconnectPin
    HyWorksApiGRPC.connectDeviceToBus1phdisconnectPin
    HyWorksApiGRPC.connectDeviceToBus1phdisconnectPin(deviceName, pinName, signalName removeAllConnections=False)

    Connects a device onto 1 phase busDisconnects the signal from a pin

    Parameters:

    • deviceName (str) – device name

    • pinName (str) – device pin namepinNamesignalName

    • removeAllConnections (str) – signal namebool) – if True, also disconnects the pins of the connected devices, effectively removing completely the line connection of the design

    Returns:

    error value

    Return type:

    bool

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.connectDeviceToBus1phdisconnectPin(‘R1’, ‘net_1’, ‘myBus’‘Cons1’, ‘y’)

    • HyWorksApi.connectDeviceToBus1ph(‘SubCC1/SubSubCC1/R3’disconnectPin(‘RC1’, ‘net_1’, ‘myBus’True)

    ...

    displayComponent(componentName, printAttributes=True, printSignals=True, printConnectors=True:

    displayConnections(componentName):

    Anchor
    HyWorksApiGRPC.connectDeviceToBus3phdisplayConnections
    HyWorksApiGRPC.connectDeviceToBus3phdisplayConnections
    HyWorksApiGRPC.connectDeviceToBus3ph(deviceName, pinName, signalName)
    Connects a device onto 3 phase bus
    displayConnections(componentName)

    Print specified component interconnections to STDOUT

    Parameters:deviceName

    componentName (str) –

    device

    component name

  • pinName (str) – device pin name

  • signalName (str) – signal name

    • Returns:

    error value

    Return type:

    boolstr

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.connectDeviceToBus3ph(‘R1’, ‘net_1’, ‘myBus’)

    • HyWorksApi.connectDeviceToBus3ph(‘SubCC1/SubSubCC1/R3’, ‘net_1’, ‘myBus’)

    ...

    on error

    flipHorizontallyDevice(deviceName, keepConnections=True):

    Anchor
    HyWorksApiGRPC.connectPinToBundleflipHorizontallyDevice
    HyWorksApiGRPC.connectPinToBundleflipHorizontallyDevice
    HyWorksApiGRPC.connectPinToBundleflipHorizontallyDevice(blocA, pinA, blocB, signalBdeviceName, keepConnections=True)

    Connect a pin to a bundle’s signalFlips a device horizontally

    Parameters:

    • blocA deviceName (str) – device name of the first devicepinA

    • keepConnections (strbool) – pin name

    • blocB (str) – name of the second device

    • signalListB (str) – bundle signal nametrue if pin connections should be kept

    Returns:

    error value

    Return type:

    intbool

    Raises:

    AssertionError – raises exception on error

    ...

    Examples:

    • HyWorksApi.flipHorizontallyDevice(‘R1’)

    flipVerticallyDevice(deviceName, keepConnections=True):

    Anchor
    HyWorksApiGRPC.createSubCircuitflipVerticallyDevice
    HyWorksApiGRPC.createSubCircuitflipVerticallyDevice
    HyWorksApiGRPC.createSubCircuitflipVerticallyDevice(namedeviceName, type=None, coordX=0, coordY=0, page=1)
    Create a subcircuit with the specified ‘name’ and ‘subType’ at the given coordinates on the specified page.
    keepConnections=True)

    Flips a device vertically

    Parameters:unique device name

    • name deviceName (str) – subcircuit definition device namesubType

    • keepConnections (str) – subcircuit type name. This name will show when redrawing the device

    • coordX (int) – X coordinate

    • coordY (int) – Y coordinate

    • page (int) – page number

    		Returns:

    • bool) – true if pin connections should be kept

    Returns:

    error value

    Return type:

    strbool

    Examples:

    • HyWorksApi.createSubCircuit(‘Subcircuit1’, 700, 700, 1)

    • HyWorksApi.createSubCircuit(‘Subcircuit1’, ‘THD’, 700, 700,1)

    • HyWorksApi.createSubCircuit(‘DEV1/Subsubcircuit1’)

    ...

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.flipVerticallyDevice(‘R1’)

    getComponentParameter(compName, compParam):

    Anchor
    HyWorksApiGRPC.disconnectPingetComponentParameter
    HyWorksApiGRPC.disconnectPingetComponentParameter
    HyWorksApiGRPC.disconnectPingetComponentParameter(deviceName, pinName, removeAllConnections=False)
    Disconnects the signal from a pin
    compName, compParam)

    Retrieve component parameter value

    Parameters:

    • deviceName compName (str) – device component name

    • pinName compParam (str) – pinNameremoveAllConnections (bool) – if True, also disconnects the pins of the connected devices, effectively removing completely the line connection of the design) – component parameter

    Returns:

    error valuea list of 2 str, the first one being the value and the second one being the unit

    Return type:

    bool

    Examples:

    • HyWorksApi.disconnectPin(‘Cons1’, ‘y’)

    • HyWorksApi.disconnectPin(‘RC1’, ‘net_1’, True)

    ...

    list[str]

    Raises:

    AssertionError – raises exception on error

    getCoordinates(deviceName, pinName=None):

    Parameters:

    • componentName (str) – component name

    • printSignals (bool) – print signals (optional)

    • printConnectors (bool) – print connectors (optional)

    • printAttributes (bool) – print attributes (optional)

    • printDefinition (bool) – print definition (optional)

    Returns:

    error value

    Return type:str
    Anchor
    HyWorksApiGRPC.displayComponentHyWorksApiGRPC.displayComponent
    HyWorksApiGRPC.displayComponent(componentName='')

    Print component information to STDOUT, including tunable parameter values, default values, parameter types and connectors.

    .getCoordinates
    HyWorksApiGRPC.getCoordinates
    HyWorksApiGRPC.getCoordinates(deviceName, pinName=None)

    Retrieve the X-Y coordinates of a device or its pin

    Parameters:

    • deviceName (str) – device name

    • pinName (str) – pin name, can be non if only the position of the device is required

    Returns:

    Returns a list of 2 int, representing the (X, Y) coordinates

    Return type:

    list[int]

    Raises:

    AssertionError – raises exception on error

    ...

    Examples:

    • HyWorksApi.getCoordinates(‘R1’)

    • HyWorksApi.getCoordinates(‘MTL’, ‘baseVolt’)

    getDeviceBundleChildPins(deviceName,

    ...

    pinName):

    Anchor
    HyWorksApiGRPC.flipHorizontallyDevicegetDeviceBundleChildPins
    HyWorksApiGRPC.flipHorizontallyDevicegetDeviceBundleChildPins
    HyWorksApiGRPC.flipHorizontallyDevicegetDeviceBundleChildPins(deviceName, keepConnections=True pinName)

    Flips Retrieve the list of all children pin names in a bundle pin of a device horizontally

    Parameters:

    • deviceName (str) – device name

    • keepConnections pinName (boolstr) – true if pin connections should be keptbundle pin name

    Returns:

    error valuethe list of the sub-pin names

    Return type:

    boollist[str]

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.flipHorizontallyDevice(‘R1’getDeviceBundleChildPins(‘AC1A_1’, ‘In’)

    ...

    getDeviceBundlePins(deviceName

    ...

    ):

    Anchor
    HyWorksApiGRPC.flipVerticallyDevicegetDeviceBundlePins
    HyWorksApiGRPC.flipVerticallyDevicegetDeviceBundlePins
    HyWorksApiGRPC.flipVerticallyDevicegetDeviceBundlePins(deviceName, keepConnections=True)

    Flips Retrieve the list of all pin names of type bundle on a device vertically

    Parameters:

    deviceName (str) – device name

  • keepConnections (bool) – true if pin connections should be kept

    • Returns:

    error valuelist of pins of type bundle on a device

    Return type:

    boollist[str]

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.flipVerticallyDevicegetDeviceBundlePins(‘R1’‘AC1A_1’)

    ...

    getDevicePinTypes(deviceName: str, pinNames: list):

    Anchor
    HyWorksApiGRPC.getAllDevicesNamesgetDevicePinTypes
    HyWorksApiGRPC.getAllDevicesNamesgetDevicePinTypes
    HyWorksApiGRPC.getAllDevicesNames(getDevicePinTypes(deviceName: str, pinNames: list)

    Gets the list of all devices Retrieve the type (function) of certain pins on a device

    Parameters:

    • deviceName (list<str>) – device name

    • pinNames – pin names

    Returns:the list of all visible devices

    list of types in the same order of pins requested. I = Input, O = Output, P = Power, S = Bundle

    Return type:

    list[str]

    Raises:

    AssertionError – raises exception on error

    Info

    This call requires an analyze call before to function properly

    ...

    Examples:

    • HyWorksApi.getDevicePinTypes(‘POW1’, [‘A’, ‘P’, ‘net_1’])

    importUCM(defFilePath):

    Anchor
    HyWorksApiGRPC.getCoordinatesimportUCM
    HyWorksApiGRPC.getCoordinatesimportUCM
    HyWorksApiGRPC.getCoordinates(deviceName, pinName=None)
    Retrieve the X-Y coordinates of a device or its pin
    importUCM(defFilePath)

    Import UCM to current HYPERSIM model

    Parameters:deviceName

    defFilePath (str) –

    device name

  • pinName (str) – pin name, can be non if only the position of the device is required

    		• Returns:

    Returns a list of 2 int, representing the (X, Y) coordinatespath to UCM (… py: function: : )

    Returns:

    error value

    Return type:

    list[int]

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.getCoordinates(‘R1’)

    • HyWorksApi.getCoordinates(‘MTL’, ‘baseVolt’)

    ...

    includeDevice(deviceName, include):

    Anchor
    HyWorksApiGRPC.getComponentParameterincludeDevice
    HyWorksApiGRPC.getComponentParameterincludeDevice
    HyWorksApiGRPC.getComponentParameterincludeDevice(compNamedeviceName, compParam include)

    Retrieve component parameter valueInclude or exclude a device in HYPERSIM model

    Parameters:

    • compName deviceName (str) – component device namecompParam

    • include (str) – component parameterbool) – true if device should be included, false if excluded

    Returns:

    a list of 2 str, the first one being the value and the second one being the uniterror value

    Return type:

    list[str]bool

    Raises:

    AssertionError – raises exception on error

    ...

    removeDevice(deviceName

    ...

    ):

    Anchor
    HyWorksApiGRPC.getDeviceBundleChildPinsremoveDevice
    HyWorksApiGRPC.getDeviceBundleChildPinsremoveDevice
    HyWorksApiGRPC.getDeviceBundleChildPinsremoveDevice(deviceName, pinName)

    Retrieve the list of all children pin names in a bundle pin of a deviceRemove device from model

    Parameters:

    deviceName (str) – device

    namepinName (str) – bundle pin

    name

    Returns:

    the list of the sub-pin nameserror value

    Return type:

    list[str]int

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.getDeviceBundleChildPins(‘AC1A_1’, ‘In’)

    ...

    renameDevice(oldDeviceName, newDeviceName):

    Anchor
    HyWorksApiGRPC.getDeviceBundlePinsrenameDevice
    HyWorksApiGRPC.getDeviceBundlePinsrenameDevice
    HyWorksApiGRPC.getDeviceBundlePinsrenameDevice(deviceNameoldDeviceName, newDeviceName)

    Retrieve the list of all pin names of type bundle on Rename a device inside the model

    Parameters:deviceName

    • oldDeviceName (str) – old device name

    • newDeviceName (str) – new device name

    Returns:

    error value

    Return type:

    list[str]int

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.renameDevice(‘DEV1’, ‘SubCircuit1’)

    • HyWorksApi.getDeviceBundlePins(‘AC1A_1’renameDevice(‘SubCircuit1/Gain1’, ‘SubCircuit1/factor’)

    ...

    renameSignal(oldName, newName, visible=True):

    Anchor
    HyWorksApiGRPC.importUCMrenameSignal
    HyWorksApiGRPC.importUCMrenameSignal
    HyWorksApiGRPC.importUCM(defFilePath)

    Import UCM to current HYPERSIM model

    Parameters:defFilePath (str) – path to UCM (… py: function: : )
    renameSignal(oldName, newName, visible=True)

    Rename all signals sharing a name inside the model

    Parameters:

    • oldName (str) – old signal name

    • newName (str) – new signal name

    • visible (bool) – if name should be visible on the design

    Returns:

    error value

    Return type:

    intbool

    Raises:

    AssertionError – raises exception on error

    ...

    rotateLeftDevice(deviceName,

    ...

    keepConnections=True):

    Anchor
    HyWorksApiGRPC.includeDevicerotateLeftDevice
    HyWorksApiGRPC.includeDevicerotateLeftDevice
    HyWorksApiGRPC.includeDevicerotateLeftDevice(deviceName, include keepConnections=True)

    Include or exclude Rotates a device in HYPERSIM modelto the left

    Parameters:

    • deviceName (str) – device name

    • include keepConnections (bool) – true if device pin connections should be included, false if excludedkept

    Returns:

    error value

    Return type:

    bool

    Raises:

    AssertionError – raises exception on error

    ...

    Examples:

    • HyWorksApi.rotateLeftDevice(‘R1’)

    rotateRightDevice(deviceName, keepConnections=True):

    Anchor
    HyWorksApiGRPC.removeDevicerotateRightDevice
    HyWorksApiGRPC.removeDevicerotateRightDevice
    HyWorksApiGRPC.removeDevicerotateRightDevice(deviceName, keepConnections=True)

    Remove device from modelRotates a device to the right

    Parameters:

    • deviceName (str) – device name

    • keepConnections (bool) – true if pin connections should be kept

    Returns:

    error value

    Return type:

    intbool

    Raises:

    AssertionError – raises exception on error

    ...

    Examples:

    • HyWorksApi.rotateRightDevice(‘R1’)

    setComponentParameter(compName, compParam, value):

    Anchor
    HyWorksApiGRPC.renameDevicesetComponentParameter
    HyWorksApiGRPC.renameDevicesetComponentParameter
    HyWorksApiGRPC.renameDevicesetComponentParameter(oldDeviceNamecompName, compParam, newDeviceName value)

    Rename a device inside the modelSet a component parameter to a certain value

    Parameters:

    • oldDeviceName compName (str) – old device namenewDeviceName component name

    • compParam (str) – component parameter

    • value (str) – new device namecomponent value

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.renameDevice(‘DEV1’, ‘SubCircuit1’)

    • HyWorksApi.renameDevice(‘SubCircuit1/Gain1’, ‘SubCircuit1/factor’)

    ...

    setComponentParameters(compNames, compParams, values):

    Anchor
    HyWorksApiGRPC.renameSignalsetComponentParameters
    HyWorksApiGRPC.renameSignalsetComponentParameters
    HyWorksApiGRPC.renameSignalsetComponentParameters(oldNamecompNames, newName compParams, visible=True)
    Rename all signals sharing a name inside the model
    values)

    Set multiple component parameters to specified values

    Parameters:

    • oldName compNames (list of str) – old signal namenewName (list of component names

    • compParams (list of str) – new signal namevisible (bool) – if name should be visible on the designlist of component parameters

    • values (list of str) – list of component values

    Returns:

    error value

    Return type:

    boolint

    Raises:

    AssertionError – raises exception on error

    ...

    exception on error

    Examples:

    • HyWorksApi.setComponentParameters([“comp1”, “comp2”], [“param1”, “param2”], [“value1”, “value2”])

    setDeviceFillColor(name, colorHexRGB):

    Anchor
    HyWorksApiGRPC.rotateLeftDevicesetDeviceFillColor
    HyWorksApiGRPC.rotateLeftDevicesetDeviceFillColor
    HyWorksApiGRPC.rotateLeftDevicesetDeviceFillColor(deviceNamename, keepConnections=True colorHexRGB)

    Rotates Set the fill color of the 2D shapes on a device to the leftsymbol

    Parameters:

    • deviceName name (str) – device namekeepConnections

    • colorHexRGB (boolstr) – true if pin connections should be keptRGB color in hex values

    Returns:

    error value

    Return type:

    boolint

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.rotateLeftDevicesetDeviceFillColor(‘R1’‘Tr2’, ‘ff0000’)

    ...

    setDeviceLineColor(

    ...

    name,

    ...

    colorHexRGB):

    Anchor
    HyWorksApiGRPC.rotateRightDevicesetDeviceLineColor
    HyWorksApiGRPC.rotateRightDevicesetDeviceLineColor
    HyWorksApiGRPC.rotateRightDevicesetDeviceLineColor(deviceNamename, keepConnections=True colorHexRGB)

    Rotates Set the color of the line segments on a device to the rightsymbol

    Parameters:

    • deviceName name (str) – device namekeepConnections

    • colorHexRGB (boolstr) – true if pin connections should be keptRGB color in hex values

    Returns:

    error value

    Return type:

    boolint

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.rotateRightDevicesetDeviceLineColor(‘R1’‘Tr2’, ‘ff0000’)

    ...

    setDevicesNameVisibility(

    ...

    deviceList,

    ...

    isVisible):

    Anchor
    HyWorksApiGRPC.setComponentParametersetDevicesNameVisibility
    HyWorksApiGRPC.setComponentParametersetDevicesNameVisibility
    HyWorksApiGRPC.setComponentParametersetDevicesNameVisibility(compNamedeviceList, compParam, value)
    Set a component parameter to a certain value
    isVisible)

    Hide/Show devices name in the model.

    Parameters:

    • compName deviceList (list[str]) – component list of devices name

    • compParam isVisible (str) – component parametervalue (str) – component valuevisibility

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    raises exception on error

    Examples:

    • HyWorksApi.setDevicesNameVisibility([‘F18/CB4’, ‘F19/CB4’, ‘Dec1’, ‘Dec2’, ‘F1’], False)

    setPinPhaseNumber(deviceName, pinName, value):

    Anchor
    HyWorksApiGRPC.setDeviceFillColorsetPinPhaseNumber
    HyWorksApiGRPC.setDeviceFillColorsetPinPhaseNumber
    HyWorksApiGRPC.setDeviceFillColorsetPinPhaseNumber(namedeviceName, pinName, colorHexRGB value)

    Set the fill color of the 2D shapes on a device symbolForces a power flexible pin to take a specific amount of phase. Normally, power flexible pins will use the same amount of phases for each power pin of the device. This call allows to disconnect this behavior.

    Parameters:

    • name deviceName (str) – device name

    • colorHexRGB pinName (str) – RGB color in hex values) – pin name

    • value (int) – 1 or 3

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.setDeviceFillColor(‘Tr2’, ‘ff0000’)

    ...

    exception on error

    setSignalLineColor(signalName, colorHexRGB):

    Anchor
    HyWorksApiGRPC.setDeviceLineColorsetSignalLineColor
    HyWorksApiGRPC.setDeviceLineColorsetSignalLineColor
    HyWorksApiGRPC.setDeviceLineColorsetSignalLineColor(namesignalName, colorHexRGB)

    Set the line color of the line segments on a device symbola signal

    Parameters:

    • name signalName (str) – device name

    • colorHexRGB (str) – RGB color in hex values

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.setDeviceLineColorsetSignalLineColor(‘Tr2’‘WED7’, ‘ff0000’)

    ...

    setSignalLineWidth(

    ...

    signalName,

    ...

    width):

    Anchor
    HyWorksApiGRPC.setSignalLineColorsetSignalLineWidth
    HyWorksApiGRPC.setSignalLineColorsetSignalLineWidth
    HyWorksApiGRPC.setSignalLineColorsetSignalLineWidth(namesignalName, colorHexRGB width)

    Set the line color width of a signal

    Parameters:

    • signalName (str) – device namecolorHexRGB

    • width (strint) – RGB color in hex valueswidth

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.setSignalLineColorsetSignalLineWidth(‘WED7’, ‘ff0000’4)

    ...

    setSubcircuitScripts(compName, initialValues, rules, variablesToTransmit, evaluateOnly=False):

    Anchor
    HyWorksApiGRPC.setSignalLineWidthsetSubcircuitScripts
    HyWorksApiGRPC.setSignalLineWidthsetSubcircuitScripts
    HyWorksApiGRPC.setSignalLineWidth(name, width)

    Set the line width of a signal

    Parameters:

    • signalName (str) – device name

    • width (int) – width

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.setSignalLineWidth(‘WED7’, 4)

    ...

    setSubcircuitScripts(compName, initialValues, rules, variablesToTransmit, evaluateOnly=False)

    unbindUCMFromLibrary(deviceName):

    ...

    Anchor
    HyWorksApiGRPC.unbindUCMFromLibrary
    HyWorksApiGRPC.unbindUCMFromLibrary
    HyWorksApiGRPC.unbindUCMFromLibrary(deviceName)

    ...

    updateUCM(deviceName, ucmPath=None):

    Anchor
    HyWorksApiGRPC.setDevicesNameVisibilityupdateUCM
    HyWorksApiGRPC.setDevicesNameVisibilityupdateUCM
    HyWorksApiGRPC.setDevicesNameVisibilityupdateUCM(deviceListdeviceName, isVisible ucmPath=None)

    Hide/Show devices name in the model.Update UCM

    Parameters:deviceList

    deviceName (

    list[

    str

    ]

    ) –

    list of devices

    UCM name

  • isVisible (str) – visibility

    • Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.setDevicesNameVisibility([‘F18/CB4’, ‘F19/CB4’, ‘Dec1’, ‘Dec2’, ‘F1’], False)

    ...

    Sensor

    editSensor(blocName, sensorName, IOType=None, IONumber=None, base=None, unit=None):

    Anchor
    HyWorksApiGRPC.setPinPhaseNumbereditSensor
    HyWorksApiGRPC.setPinPhaseNumbereditSensor
    HyWorksApiGRPC.setPinPhaseNumber(deviceName, pinName, value)
    Forces a power flexible pin to take a specific amount of phase. Normally, power flexible pins will use the same amount of phases for each power pin of the device. This call allows to disconnect this behaviour.
    editSensor(blocName, sensorName, IOType=None, IONumber=None, base=None, unit=None)

    Edit device sensor

    AnchorHyWorksApiGRPC.updateUCMHyWorksApiGRPC.updateUCMHyWorksApiGRPC.updateUCM(deviceName)

    Update UCM

    Parameters:

    • deviceName blocName (str) – device name

    • pinName sensorName (str) – pin sensor namevalue

    • IOType (intstr) – 1 or 3

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    updateUCM(deviceName):

    Parameters:deviceName (str) – UCM name

    • IO Type. ex: AD, DA, DI or DO

    • IONumber (int) – IO number

    • base (float) – base value

    • unit (str) – unit value

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    Sensor

    editSensor(blocName, sensorName, IOType=None, IONumber=None, base=None, unit=None):

    AnchorHyWorksApiGRPC.editSensorHyWorksApiGRPC.editSensorHyWorksApiGRPC.editSensor(blocName, sensorName, IOType=None, IONumber=None, base=None, unit=None)

    Edit device sensor

    Parameters:

    • blocName (str) – device name

    • sensorName (str) – sensor name

    • IOType (str) – IO Type. ex: AD, DA, DI or DO

    • IONumber (int) – IO number

    • base (float) – base value

    • unit (str) – unit value

    Returns:

    error value

    Return type:

    inton error

    Examples:

    • HyWorksApi.editSensor(‘R1’, ‘Ia’, 1.0, ‘pu’, ‘DA’, 1001)

    • HyWorksApi.editSensor(‘R1’, ‘Ia’, base = 1.0, unit = ‘pu’)

    • HyWorksApi.editSensor(‘R1’, ‘Ia’, IOType = ‘DA’, IONumber = 1001)

    getLastSensorValues(sensorNames):

    ...

    Anchor
    HyWorksApiGRPC.getLastSensorValues
    HyWorksApiGRPC.getLastSensorValues
    HyWorksApiGRPC.getLastSensorValues(sensorNames)

    Gets the last current value of a list of sensors while simulation is running

    Parameters:

    sensorNames (list[str]) – list of sensor names as string

    Returns:

    values in the same order as the sensor names

    Return type:

    list[float]

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.editSensor(‘R1’, ‘Ia’, 1.0, ‘pu’, ‘DA’, 1001)

    • HyWorksApi.editSensor(‘R1’, ‘Ia’, base = 1.0, unit = ‘pu’)

    • HyWorksApi.editSensor(‘R1’, ‘Ia’, IOType = ‘DA’, IONumber = 1001getLastSensorValues([‘Const1.y’, ‘Subcircuit1/Gain1.u’, “/Subcircuit1/R15.Ia”])

    getSensorInfo(blocName, sensorName, key):

    Anchor
    HyWorksApiGRPC.getSensorInfo
    HyWorksApiGRPC.getSensorInfo
    HyWorksApiGRPC.getSensorInfo(blocName, sensorName, key)

    Get value for the specified key on the specified sensor

    Parameters:

    • blocName (str) – device name

    • sensorName (str) – sensor name

    • key (str) – key in sensor inf.

    Supported keys:

    • ‘selected’

    • ‘userName’

    • ‘userUnit’

    • ‘iotype’

    • ‘ionum’

    • ‘iofactor’

    • ‘base’

    • ‘dataLoggerRecord’

    • ‘dataLoggerGroup’

    • ‘dataLoggerTrigger’

    • ‘exchangerTag’

    • ‘dataPointName’

    • ‘dataPointIndex’

    Returns:

    value of the specified key

    Return type:

    str

    getSensorsValues(sensorNames: List[str], timeLength, timeStart=0, acquisitionRate=Non:

    loadSensors(filePath):

    Anchor
    HyWorksApiGRPC.loadSensors
    HyWorksApiGRPC.loadSensors
    HyWorksApiGRPC.loadSensors(filePath)

    Load sensor file to current model

    Parameters:

    filePath (str) – path to sensor file (.sig, .csv)

    Returns:

    error value

    Return type:

    bool

    Raises:

    AssertionError – raises exception on error

    selectAllSensors(blocName):

    Anchor
    HyWorksApiGRPC.selectAllSensors
    HyWorksApiGRPC.selectAllSensors
    HyWorksApiGRPC.selectAllSensors(blocName)

    Select all sensors for devicefor device

    Parameters:

    blocName (str) – device name

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    selectSensor(blocName, sensorName, selected=True):

    ...

    Anchor
    HyWorksApiGRPC.selectSensor
    HyWorksApiGRPC.selectSensor
    HyWorksApiGRPC.selectSensor(blocName, sensorName, selected=True)

    Select device sensor

    Parameters:

    • blocName (str) – device name

    • sensorName (str) – sensor name

    • selected (bool) – selected

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    setSensorDataLogger(blocName, sensorName, record, groupName, trigger):

    Anchor
    HyWorksApiGRPC.setSensorDataLogger
    HyWorksApiGRPC.setSensorDataLogger
    HyWorksApiGRPC.setSensorDataLogger(blocName, sensorName, record, groupName, trigger)

    Set sensor parameter through datapoints

    Parameters:

    • blocName (str) – device name

    • sensorName (str) – sensor name

    • record (bool) – record signal

    • groupName (str) – signal group name

    • trigger (bool) – set signal as trigger for the group

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.setSensorDataLogger(‘sine1’, ‘y’, True, ‘SIGNAL_GROUP_1’, False)

    • HyWorksApi.setSensorDataLogger(‘sine2’, ‘y’, True, ‘SIGNAL_GROUP_2’, True)

    • HyWorksApi.setSensorDataLogger(‘sine3’, ‘y’, False, ‘SIGNAL_GROUP_3’, False)

    setSensorDataPoint(blocName, sensorName, exchangerTag, dataPointName, dataPointIdx):

    Anchor
    HyWorksApiGRPC.setSensorDataPoint
    HyWorksApiGRPC.setSensorDataPoint
    HyWorksApiGRPC.setSensorDataPoint(blocName, sensorName, exchangerTag, dataPointName, dataPointIdx)

    Set sensor parameter through datapoints

    Parameters:

    • blocName (str) – device name

    • sensorName (str) – sensor name

    • exchangerTag (str) – exchanger tag

    • dataPointName (str) – data point name

    • dataPointIdx (str) – data point index

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.setSensorDataPoint(‘Const_Amplitude’, ‘y’, ‘Signal Generator’, ‘Sine Waves/Sine Wave 1/Amplitude’, ‘0’)

    • HyWorksApi.setSensorDataPoint(‘Const_Frequency’, ‘y’, ‘Signal Generator’, ‘Sine Waves/Sine Wave 1/Frequency’, ‘0’)

    • HyWorksApi.setSensorDataPoint(‘Gain’, ‘u’, ‘Signal Generator’, ‘Sine Waves/Sine Wave 1/Output’, ‘0’)

    selectSensor(blocName, sensorName, selected=True):

    AnchorHyWorksApiGRPC.selectSensorHyWorksApiGRPC.selectSensorHyWorksApiGRPC.selectSensor(blocName, sensorName, selected=True)

    Select device sensor

    Parameters:

    • blocName (str) – device name

    • sensorName (str) – sensor name

    • selected (bool) – selected

    Returns:

    error value

    Return type:

    int

    Raises:AssertionError – raises exception on error

    • ‘0’)

    Settings

    analyze():

    Anchor
    HyWorksApiGRPC.analyze
    HyWorksApiGRPC.analyze
    HyWorksApiGRPC.analyze()

    Analyse

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    buildTopology():

    Anchor
    HyWorksApiGRPC.buildTopology
    HyWorksApiGRPC.buildTopology
    HyWorksApiGRPC.buildTopology()

    Build topology

    Returns:

    error value

    Return type:

    int

    clearCodeDir():

    Anchor
    HyWorksApiGRPC.clearCodeDir
    HyWorksApiGRPC.clearCodeDir
    HyWorksApiGRPC.clearCodeDir()

    Clear code directorycode directory

    Returns:

    error value

    Return type:

    int

    ...

    genCode():

    ...

    Anchor
    HyWorksApiGRPC.genCode
    HyWorksApiGRPC.genCode
    HyWorksApiGRPC.genCode()

    Generate code

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    ...

    getLoadFlowReport() :

    Anchor
    HyWorksApiGRPC.getLoadFlowReport
    HyWorksApiGRPC.getLoadFlowReport
    HyWorksApiGRPC.getLoadFlowReport()

    Get the load-flow report (BETA: this feature is subject to improvements in the upcoming versions)

    Returns:

    error valueHYPERSIM load-flow report

    Return type:

    intLoadflowReport

    ...

    getPreference(prefName):

    AnchorHyWorksApiGRPC.getPreferenceHyWorksApiGRPC.getPreferenceHyWorksApiGRPC.getPreference(prefName)

    Retrieve a model preference

    Anchor
    HyWorksApiGRPC.genCodegetPreference
    HyWorksApiGRPC.genCodegetPreference
    HyWorksApiGRPC.genCodegetPreference()

    Generate code

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    getPreference(prefName):

    prefName)

    Retrieve a model preference Refer to the following pages of the documentation to find the preference names:

    Parameters:

    prefName (str) – preference name

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    mapTask():

    Anchor
    HyWorksApiGRPC.mapTask
    HyWorksApiGRPC.mapTask
    HyWorksApiGRPC.mapTask()

    Map tasks

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    setPreference(prefName, value):

    Anchor
    HyWorksApiGRPC.setPreference
    HyWorksApiGRPC.setPreference
    HyWorksApiGRPC.setPreferenceHyWorksApiGRPC.setPreference(prefName, value)

    Set a model preference to a specific value

    (prefName, value)

    Set a model preference to a specific value Refer to the following pages of the documentation to find the preference names:

    Parameters:

    • prefName (str) – preference name

    • value (str) – preference value

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    setTarget(hostname, mode=None):

    Anchor
    HyWorksApiGRPC.setTarget
    HyWorksApiGRPC.setTarget
    HyWorksApiGRPC.setTarget(hostname, mode=None)

    Set simulation target

    Parameters:

    • hostname (str) – target IP

    • mode (str) – simulation mode. Options: - Offline (RTA): nrt_optimized - Offline (PMI) : nrt_mpi - Real-time : rt

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    startLoadFlow():

    Anchor
    HyWorksApiGRPC.startLoadFlow
    HyWorksApiGRPC.startLoadFlow
    HyWorksApiGRPC.startLoadFlow()

    Load flow

    AnchorHyWorksApiGRPC.getLoadFlowReportHyWorksApiGRPC.getLoadFlowReportHyWorksApiGRPC.getLoadFlowReport()

    Get the load-flow report (BETA: this feature is subject to improvements in the upcoming versions)

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    getLoadFlowReport():

    Returns:

    HYPERSIM load-flow report

    Return type:LoadflowReport

    int

    Raises:

    AssertionError – raises exception on error

    Simulation

    getMonitoringAllValues():

    Anchor
    HyWorksApiGRPC.getMonitoringAllValues
    HyWorksApiGRPC.getMonitoringAllValues
    HyWorksApiGRPC.getMonitoringAllValues()

    Get the current value of all monitors during simulation

    Returns:

    a dictionary where the key is the monitor name, and the value is the current value

    Return type:

    dict[str, str]

    Raises:

    AssertionError – raises exception on error

    getMonitoringValue(monitorName):

    Anchor
    HyWorksApiGRPC.getMonitoringValue
    HyWorksApiGRPC.getMonitoringValue
    HyWorksApiGRPC.getMonitoringValue(monitorName)

    Get the current value of a monitor during simulationGet the current value of a monitor during simulation

    Parameters:

    monitorName (str) – Name of the monitor

    Returns:

    value

    Return type:

    str

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.getMonitoringValue(‘MyMonitor1’)

    ...

    getPreparationTimings(modelPath: str = None) :

    Anchor
    HyWorksApiGRPC.getPreparationTimings
    HyWorksApiGRPC.getPreparationTimings
    HyWorksApiGRPC.getPreparationTimings(modelPath: str = None)

    Get the timings of the preparation phase of the current or provided model. The preparation phase includes the topology build, analysis, load flow, task mapping, code generation, simulation start and simulation stop.

    Parameters:

    monitorName modelPath (str) – Name of the monitorpath to the model file (Default: Currently opened model)

    Returns:

    valueAn object containing the performance information

    Return type:

    strSimulationPreparationTimingsInfo

    Raises:

    AssertionError – raises exception on error

    Examples:

    • HyWorksApi.getMonitoringValue(‘MyMonitor1’)

    ...

    getSimulationCoreTimings(modelPath: str = None) :

    Anchor
    HyWorksApiGRPC.getLastSensorValuesgetSimulationCoreTimings
    HyWorksApiGRPC.getLastSensorValuesgetSimulationCoreTimings
    HyWorksApiGRPC.getLastSensorValues(sensorNames)
    Gets the last current value of a list of sensors while simulation is running
    getSimulationCoreTimings(modelPath: str = None)

    Get the core timings of the current or provided model. This function gives the timings of the steps that occur during the simulation for each core.

    Parameters:

    sensorNames modelPath (list[str]) – list of sensor names as string) – path to the model file (Default: Currently opened model)

    Returns:

    values in the same order as the sensor namesA list of objects containing the core timings

    Return type:

    list[float]

    Raises:

    AssertionError – raises exception on error

    Examples:

    HyWorksApi.getLastSensorValues([‘Const1.y’, ‘Subcircuit1/Gain1.u’, “/Subcircuit1/R15.Ia”])

    [SimulationCoreTimingsInfo]

    ...

    getSimulationTime():

    Anchor
    HyWorksApiGRPC.getSimulationTime
    HyWorksApiGRPC.getSimulationTime
    HyWorksApiGRPC.getSimulationTime()

    Get the current simulation time, in the unit of the Point-On-Wave

    Returns:

    value

    Return type:

    float

    Raises:

    AssertionError – raises exception on error

    ...

    getSimulationTimings(modelPath: str = None) :

    ...

    Anchor
    HyWorksApiGRPC.getSimulationTimings
    HyWorksApiGRPC.getSimulationTimings
    HyWorksApiGRPC.getSimulationTimings(modelPath: str = None)

    Get the simulation timings of the current or provided model. This function provides the timings for the steps that occur at the start of the simulation and during each subsequent iteration.

    Parameters:

    modelPath (str) – path to the model file (Default: Currently opened model)

    Returns:

    An object containing the simulation timings

    Return type:

    SimulationTimings

    loadSnapshot():

    Anchor
    HyWorksApiGRPC.loadSnapshot
    HyWorksApiGRPC.loadSnapshot
    HyWorksApiGRPC.loadSnapshot()

    Loads a snapshot in the simulation

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    resetMonitoring(cpuList):

    Anchor
    HyWorksApiGRPC.resetMonitoring
    HyWorksApiGRPC.resetMonitoring
    HyWorksApiGRPC.resetMonitoring(cpuList)

    Reset performance indicators and timings for simulation

    Parameters:

    cpuList (list[int]) – list of cpu cores to reset. ex: [1, 2, 3, 4] Returns error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    resetPerfIndic(cpuList):

    Anchor
    HyWorksApiGRPC.resetPerfIndic
    HyWorksApiGRPC.resetPerfIndic
    HyWorksApiGRPC.resetPerfIndic(cpuList)

    Reset performance indicators for simulation

    Parameters:

    cpuList (list[int]) – list of cpu cores to reset. ex: [1, 2, 3, 4] Returns error value

    Raises:

    AssertionError – raises exception on error

    resetTiming(cpuList):

    Anchor
    HyWorksApiGRPC.resetTiming
    HyWorksApiGRPC.resetTiming
    HyWorksApiGRPC.resetTiming(cpuList)

    Reset performance timing for simulation

    Parameters:

    cpuList (list[int]) – list of cpu cores to reset. ex: [1, 2, 3, 4] Returns error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    simtrig(sync):

    Anchor
    HyWorksApiGRPC.simtrig
    HyWorksApiGRPC.simtrig
    HyWorksApiGRPC.simtrig(sync)

    Trig the programmable devices in the simulation

    Parameters:

    sync (bool) – synchronize with POW

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    startMonitoring():

    Anchor
    HyWorksApiGRPC.startMonitoring
    HyWorksApiGRPC.startMonitoring
    HyWorksApiGRPC.startMonitoring()

    Start monitoring

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    startSim():

    Anchor
    HyWorksApiGRPC.startSim
    HyWorksApiGRPC.startSim
    HyWorksApiGRPC.startSim()

    Start simulation

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    stopMonitoring():

    Anchor
    HyWorksApiGRPC.stopMonitoring
    HyWorksApiGRPC.stopMonitoring
    HyWorksApiGRPC.stopMonitoring()

    Stop monitoring

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    stopSim():

    Anchor
    HyWorksApiGRPC.stopSim
    HyWorksApiGRPC.stopSim
    HyWorksApiGRPC.stopSim()

    Stop simulation

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    takeSnapshot():

    Anchor
    HyWorksApiGRPC.takeSnapshot
    HyWorksApiGRPC.takeSnapshot
    HyWorksApiGRPC.takeSnapshot()

    Takes a snapshot of the simulation

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    Target

    addTargetToManager(targetHostName):

    Anchor
    HyWorksApiGRPC.addTargetToManager
    HyWorksApiGRPC.addTargetToManager
    HyWorksApiGRPC.addTargetToManager(targetHostName)

    Add target to HYPERSIM target manager

    Parameters:

    targetHostName (str) – target IP

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    diagnosticTarget(targetHostName):

    Anchor
    HyWorksApiGRPC.diagnosticTarget
    HyWorksApiGRPC.diagnosticTarget
    HyWorksApiGRPC.diagnosticTarget(targetHostName)

    Prints a diagnostic report of the target configuration.

    Parameters:

    targetHostName (str) – target IP

    Returns:

    diagnostic report on the target

    Return type:

    str

    getAllTargetsName():

    Anchor
    HyWorksApiGRPC.getAllTargetsName
    HyWorksApiGRPC.getAllTargetsName
    HyWorksApiGRPC.getAllTargetsName()

    Get all known targets by HYPERSIM target manager

    Returns:

    list of all known targets

    Return type:

    str

    getCurrentVersionOnTarget(targetHostName):

    Anchor
    HyWorksApiGRPC.getCurrentVersionOnTarget
    HyWorksApiGRPC.getCurrentVersionOnTarget
    HyWorksApiGRPC.getCurrentVersionOnTarget(targetHostName)

    Get current HYPERSIM version on target

    Parameters:

    targetHostName (str) – target IP

    Returns:

    HYPERSIM version

    Return type:

    str

    getInstalledVersionOnTarget(targetHostName):

    Anchor
    HyWorksApiGRPC.getInstalledVersionOnTarget
    HyWorksApiGRPC.getInstalledVersionOnTarget
    HyWorksApiGRPC.getInstalledVersionOnTarget(targetHostName)

    Get all HYPERSIM versions installed on target

    Parameters:

    targetHostName (str) – target IP

    Returns:

    list of all HYPERSIM versions

    Return type:

    str

    installHypersimOnTarget(targetHostName):

    Anchor
    HyWorksApiGRPC.installHypersimOnTarget
    HyWorksApiGRPC.installHypersimOnTarget
    HyWorksApiGRPC.installHypersimOnTarget(targetHostName)

    Install HYPERSIM version on target

    Parameters:

    targetHostName (str) – target IP

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    isTargetReady(targetHostName):

    Anchor
    HyWorksApiGRPC.isTargetReady
    HyWorksApiGRPC.isTargetReady
    HyWorksApiGRPC.isTargetReady(targetHostName)

    Determine if target is ready for simulation

    Parameters:

    targetHostName (str) – target IP

    Returns:

    ready status

    Return type:

    bool

    removeTargetFromManager(targetHostName):

    Anchor
    HyWorksApiGRPC.removeTargetFromManager
    HyWorksApiGRPC.removeTargetFromManager
    HyWorksApiGRPC.removeTargetFromManager(targetHostName)

    Remove target from HYPERSIM target manager

    Parameters:

    targetHostName (str) – target IP

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error

    switchVersionOnTarget(targetHostName, switchToVersion):

    Anchor
    HyWorksApiGRPC.switchVersionOnTarget
    HyWorksApiGRPC.switchVersionOnTarget
    HyWorksApiGRPC.switchVersionOnTarget(targetHostName, switchToVersion)

    Switch HYPERSIM versions on target

    Parameters:

    • targetHostName (str) – target IP

    • switchToVersion (str) – HYPERSIM version to switch to

    Returns:

    error value

    Return type:

    int

    Raises:

    AssertionError – raises exception on error