Versions Compared

Key

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

...

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter
opalone._internal.block_parameters.BlockParameter
class opalone._internal.block_parameters.BlockParameter(parameter_id, model_id, project_id, data_type, path)
Panel
bgColorunset

Bases: Parameter

A block parameter is a parameter that is owned by a Block.

Parameters:
  • parameter_id (str) – The ID of the parameter.

  • model_id (str) – The ID of the Model that contains the block that owns this parameter.

  • project_id (str) – The ID of the Project that owns the parameter.

  • data_type (Data) – A data value holder.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.connect_to
opalone._internal.block_parameters.BlockParameter.connect_to
connect_to(datapoint, is_enabled=True, force_enable=False)
Panel
bgColorunset

Connect the current datapoint to another datapoint.

If the connection to create is enabled, i.e. is_enabled=True, and any datapoint in this new connection is actively connected to another datapoint, then some connection rules will apply and the new connection might be declared invalid. If force_enable=True, conflicting connections will be disabled in favor of the new connection.

Some data types are incompatibles between one another, so that might result in an invalid connection. For example, a STRING data type cannot connect to a NUMERIC data type.

If the backend reports the connection to be invalid, this method will attempt to connect the other way around. For example, if A.connect_to(B) fails on the backend, this method will attempt the equivalent of B.connect_to(A). If this connection also fails, the first failure will be reported to the user.

Parameters:
  • datapoint (str | Datapoint) – The datapoint to connect to, either an ID or a datapoint object..

  • is_enabled (bool) – A flag to enable (True) or disable (False) the connection to create.

  • force_enable (bool) – A flag to drop (True) or not (False) any conflicting connections that already exist in the system.

Returns:

A new connection instance

Return type:
Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.delete
opalone._internal.block_parameters.BlockParameter.delete
delete()
Panel
bgColorunset

Delete the current parameter.

This function does nothing for now, since a parameter deletion is not supported. To delete a parameter, the user must delete the Block or Widget owning this parameter.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.reset_to_default_value
opalone._internal.block_parameters.BlockParameter.reset_to_default_value
reset_to_default_value()
Panel
bgColorunset

Reset a value to its default.

The default value is, generally, the value of the parameter as defined in the model containing this parameter. In particular, the default value is not a member of any ParameterSet.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.to_json
opalone._internal.block_parameters.BlockParameter.to_json
to_json(fields, values)
Panel
bgColorunset

Convert this resource to a serialized JSON representation.

Parameters:
  • fields (tuple[str] | list[str]) – Fields to include.

  • values (tuple[object] | list[object]) – The value of each field

Returns:

The serialized JSON representation.

Return type:

str

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.alias
opalone._internal.block_parameters.BlockParameter.alias
property alias: str
Panel
bgColorunset

Get the alias of the datapoint.

This property returns an AliasWrapper, which behaves like a string but also provides additional methods like generate(). If the alias is not set, it initializes with an empty AliasWrapper.

Returns:

The alias of the datapoint.

Return type:

AliasWrapper | None

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.connections
opalone._internal.block_parameters.BlockParameter.connections
property connections: tuple[Connection]
Panel
bgColorunset

The connections going to this datapoint.

A connection allows describing a transfer of data between two datapoints.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.data_type
opalone._internal.block_parameters.BlockParameter.data_type
property data_type: DataType
Panel
bgColorunset

The data type of the datapoint.

This property is read-only, it cannot be modified.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.default_value
opalone._internal.block_parameters.BlockParameter.default_value
property default_value: bool | str | float | dict
Panel
bgColorunset

The default value of this datapoint.

The default value’s type is determined at runtime and depends on the Data type of the datapoint.

This property is read-only, it cannot be modified.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.id
opalone._internal.block_parameters.BlockParameter.id
property id: str
Panel
bgColorunset

The ID of the resource.

This property is read-only, it cannot be modified.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.is_displayed_on_canvas
opalone._internal.block_parameters.BlockParameter.is_displayed_on_canvas
property is_displayed_on_canvas: bool
Panel
bgColorunset

Indicates if this datapoint is displayed on canvas (True) or not (False). If True, the datapoint and its value are displayed on the UI next to the block.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.is_equal_mode
opalone._internal.block_parameters.BlockParameter.is_equal_mode
property is_equal_mode: bool
Panel
bgColorunset

Indicates in this parameter has equal mode enabled (True) or not (False). The equal mode applies only on non-scalar values. When active, all indices of the non-scalar value are forced equal. A change for any index will also update all other indices to the same value.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.is_favorite
opalone._internal.block_parameters.BlockParameter.is_favorite
property is_favorite: bool
Panel
bgColorunset

Indicates if this datapoint is a favorite (True) or not (False). If True, the datapoint is displayed in the favorite section in the UI.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.is_read_only
opalone._internal.block_parameters.BlockParameter.is_read_only
property is_read_only: bool
Panel
bgColorunset

Indicates if this parameter is read-only (True) or not (False). A read-only parameter is a parameter for which its value cannot be modified.

This property itself is read-only, it cannot be modified.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.is_tunable
opalone._internal.block_parameters.BlockParameter.is_tunable
property is_tunable: bool
Panel
bgColorunset

Indicates if this parameter is tunable (True) or not (False). A tunable parameter is a parameter for which its value can be modified while a simulation is running.

This property is read-only, it cannot be modified.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.is_visible
opalone._internal.block_parameters.BlockParameter.is_visible
property is_visible: bool
Panel
bgColorunset

Indicates if this datapoint is visible (True) or not (False).

This property is read-only, it cannot be modified.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.name
opalone._internal.block_parameters.BlockParameter.name
property name: str
Panel
bgColorunset

The name of the datapoint.

This property is read-only, it cannot be modified.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.path
opalone._internal.block_parameters.BlockParameter.path
property path: str
Panel
bgColorunset

Path of a Datapoint in the model, seperated with “/”

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.ref_id
opalone._internal.block_parameters.BlockParameter.ref_id
property ref_id: str
Panel
bgColorunset

The reference ID of the datapoint.

This ID is only useful to lookup the datapoint’s library data.

This property is read-only, it cannot be modified.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.size
opalone._internal.block_parameters.BlockParameter.size
property size: tuple[int]
Panel
bgColorunset

Array of values describing the size of multidimensional datapoints. Equals to (1) for scalars, (1, N) for row vectors, (M, 1) for column vectors, (M, N) for matrices and (D1, D2…, Dn) more generally.

This property is read-only, it cannot be modified.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.type
opalone._internal.block_parameters.BlockParameter.type
property type: DatapointType
Panel
bgColorunset

The type of the datapoint.

This property is read-only, it cannot be modified.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.unit
opalone._internal.block_parameters.BlockParameter.unit
property unit: str
Panel
bgColorunset

The units of the datapoint.

Example units: Volts, Amperes, seconds, etc.

This property is read-only, it cannot be modified.

Panel
bgColorunset
Anchor
opalone._internal.block_parameters.BlockParameter.value
opalone._internal.block_parameters.BlockParameter.value
property value: object
Panel
bgColorunset

The current value for this parameter.

The value’s type is determined at runtime and depends on the Data type of the datapoint.