TrendHubView

trendminer_interface.objects.TrendHubView

Bases: SavedItemBase

Trend hub view work organizer object

Attributes:

Name	Type	Description
definition	TrendHubViewDefinition	Definition of the trend hub view, containing all configuration details.

name class-attribute instance-attribute

name: str = name

description class-attribute instance-attribute

description: str = description

folder class-attribute instance-attribute

folder: Folder | None = folder

identifier property

identifier: str

UUID of the saved object

created_at property

created_at: Timestamp | None

Timestamp the object was created at

Can be None for items created before item creation date tracking was implemented in TrendMiner.

last_modified property

last_modified: Timestamp

Timestamp the object was last modified

last_used property

last_used: Timestamp

Timestamp the object was last used

last_modified_by property

last_modified_by: User

User that last modified the object

owner property

owner: User

User that owns the object

shared property

shared: bool

Whether the object is shared with other users

favorite property

favorite: bool

Whether the object is marked as a favorite by the owner

version property

version: int

Version number of the object, incremented on each modification

definition instance-attribute

definition: TrendHubViewDefinition

url property

url: str

Direct link to the saved view

update

update() -> Self

Update the saved item in TrendMiner to match the current instance state

delete

delete() -> None

Permanently delete the saved item in TrendMiner

move

move(folder: Folder) -> None

Move the item to a folder

Parameters:

Name	Type	Description	Default
folder	Folder	The folder to move the item to	required

Notes

Moving an item to another user's folder will not transfer the ownership and may lead to unexpected behavior. Use the client.work.transfer method instead.

get_folder_path

get_folder_path(include_home=False) -> list[Folder]

Get the location in the work organizer

Starts from, but does not include, the user's home folder. Does not include the object itself.

Parameters:

Name	Type	Description	Default
include_home	bool	Whether to include the user's home folder as the first element of the returned list. If False (default), the list starts from the first folder after the home folder.	False

Returns:

Type	Description
list[Folder]	List of folders leading up to this item

get_permissions

get_permissions() -> list[
    tuple[User | UserGroup, WorkSharePermission]
]

Get the sharing settings of the object

Returns:

Name	Type	Description
sharing	list[tuple[User | UserGroup, WorkSharePermission]]	A list of tuples, each containing a user or user group that the object is shared with and the corresponding permission ("read", "write", or "manage").

add_permission

add_permission(
    subject: User | UserGroup,
    permission: WorkSharePermission,
) -> Self

Share the object with a user or user group

Parameters:

Name	Type	Description	Default
subject	User or UserGroup	The user or user group to share the object with	required
permission	str	The permission to share with. Can be "read", "write", or "manage"	required

Returns:

Name	Type	Description
self	SavedItemBase	The object itself, after being shared with the user or user group. Practically, only the shared property may have changed.

remove_permission

remove_permission(subject: User | UserGroup) -> Self

Remove sharing of the object with a user or user group

Parameters:

Name	Type	Description	Default
subject	User or UserGroup	The user or user group to remove sharing with	required

Returns:

Name	Type	Description
self	SavedItemBase	The object itself, after removing sharing with the user or user group. Practically, only the shared property may have changed.

get_data

get_data(freq: Timedelta) -> list[DataFrame]

Retrieve interpolated timeseries data for underlying tags

Parameters:

Name	Type	Description	Default
freq	Timedelta	Data resolution.	required

Returns:

Type	Description
list[DataFrame]	A dataframe with DatetimeIndex and tag names as columns for every layer

Notes

• Any tag time shift will be taken into account: the returned data will be for the shifted tag.
• A call to get TrendMiner data does not automatically trigger indexing of the tag. It is up to the user to ensure the tag is indexed for the required period prior to requesting the data (cfr. Tag.index).