LatestDateTimeView

Bases: object

A lazy view over LatestDateTime values for each node.

__eq__(value)

Return self==value.

__ge__(value)

Return self>=value.

__getitem__(key)

Return self[key].

__gt__(value)

Return self>value.

__iter__()

Implement iter(self).

__le__(value)

Return self<=value.

__len__()

Return len(self).

__lt__(value)

Return self<value.

__ne__(value)

Return self!=value.

__repr__()

Return repr(self).

bottom_k(k)

Compute the k smallest values

Parameters:

Name	Type	Description	Default
k	int	The number of values to return	required

Returns:

Type	Description
NodeStateOptionDateTime	The k smallest values as a node state

collect()

Compute all DateTime values and return the result as a list

Returns:

Type	Description
list[Optional[datetime]]	all values as a list

collect_valid()

Compute all DateTime values and return the valid results as a list. Conversion errors and empty values are ignored

Returns:

Type	Description
list[datetime]	all values as a list

compute()

Compute all DateTime values and return the result as a NodeState. Fails if any DateTime error is encountered.

Returns:

Type	Description
NodeStateOptionDateTime	the computed NodeState

compute_valid()

Compute all DateTime values and only return the valid results as a NodeState. DateTime errors are ignored.

Returns:

Type	Description
NodeStateOptionDateTime	the computed NodeState

get(node, default=None)

Get value for node

Parameters:

Name	Type	Description	Default
node	NodeInput	the node	required
default	Optional[datetime]	the default value. Defaults to None.	None

Returns:

Type	Description
Optional[datetime]	the value for the node or the default value

groups()

Group by value

Returns:

Type	Description
NodeGroups	The grouped nodes

items()

Iterate over items

Returns:

Type	Description
Iterator[Tuple[Node, Optional[datetime]]]	Iterator over items

items_valid()

Iterate over valid DateTime items only. Ignore error and None values.

Returns:

Type	Description
Iterator[Tuple[Node, datetime]]	Iterator over items

iter_valid()

Returns an iterator over all valid DateTime values. Conversion errors and empty values are ignored

Returns:

Type	Description
Iterator[datetime]	Valid DateTime values.

max()

Return the maximum value

Returns:

Type	Description
Optional[datetime]	The maximum value or None if empty

max_item()

Return largest value and corresponding node

Returns:

Type	Description
Optional[Tuple[Node, datetime]]	The Node and maximum value or None if empty

median()

Return the median value

Returns:

Type	Description
Optional[datetime]	The median value or None if empty

median_item()

Return median value and corresponding node

Returns:

Type	Description
Optional[Tuple[Node, datetime]]	The median value or None if empty

min()

Return the minimum value

Returns:

Type	Description
Optional[datetime]	The minimum value or None if empty

min_item()

Return smallest value and corresponding node

Returns:

Type	Description
Optional[Tuple[Node, datetime]]	The Node and minimum value or None if empty

nodes()

Iterate over nodes

Returns:

Type	Description
Nodes	The nodes

sorted(reverse=False)

Sort by value. Note that 'None' values will always come after valid DateTime values

Parameters:

Name	Type	Description	Default
reverse	bool	If True, sort in descending order, otherwise ascending. Defaults to False.	False

Returns:

Type	Description
NodeStateOptionDateTime	Sorted node state

sorted_by_id()

Sort results by node id. Fails if any DateTime error is encountered.

Returns:

Type	Description
NodeStateOptionDateTime	The sorted node state

sorted_by_id_valid()

Sort only non-error DateTimes by node id. DateTime errors are ignored.

Returns:

Type	Description
NodeStateOptionDateTime	The sorted node state

to_df()

Convert results to pandas DataFrame

The DataFrame has two columns, "node" with the node ids and "value" with the corresponding values.

Returns:

Type	Description
DataFrame	A Pandas DataFrame.

top_k(k)

Compute the k largest values

Parameters:

Name	Type	Description	Default
k	int	The number of values to return	required

Returns:

Type	Description
NodeStateOptionDateTime	The k largest values as a node state

values()

Iterate over DateTime values

Returns:

Type	Description
Iterator[Optional[datetime]]	Iterator over values

values_valid()

Iterate over valid DateTime values only. Ignore error and None values.

Returns:

Type	Description
Iterator[datetime]	Iterator over values