cognite-neat 0.85.9__py3-none-any.whl → 0.85.10__py3-none-any.whl

cognite/neat/_version.py

@@ -1 +1 @@
-__version__ = "0.85.9"
+__version__ = "0.85.10"

cognite/neat/graph/queries/_base.py

@@ -2,6 +2,7 @@ import warnings
 from typing import Literal, cast, overload
 
 from rdflib import RDF, Graph, URIRef
+from rdflib import Literal as RdfLiteral
 from rdflib.query import ResultRow
 
 from cognite.neat.rules.models.entities import ClassEntity
@@ -18,6 +19,24 @@ class Queries:
         self.graph = graph
         self.rules = rules
 
+    def summarize_instances(self) -> list[tuple]:
+        """Summarize instances in the graph store by class and count"""
+
+        query_statement = """ SELECT ?class (COUNT(?instance) AS ?instanceCount)
+                             WHERE {
+                             ?instance a ?class .
+                             }
+                             GROUP BY ?class
+                             ORDER BY DESC(?instanceCount) """
+
+        return [
+            (
+                remove_namespace_from_uri(cast(URIRef, cast(tuple, res)[0])),
+                cast(RdfLiteral, cast(tuple, res)[1]).value,
+            )
+            for res in list(self.graph.query(query_statement))
+        ]
+
     def list_instances_ids_of_class(self, class_uri: URIRef, limit: int = -1) -> list[URIRef]:
         """Get instances ids for a given class
 
@@ -68,7 +87,10 @@ class Queries:
             # We cannot include the RDF.type in case there is a neat:type property
             return [remove_namespace_from_uri(*triple) for triple in result if triple[1] != RDF.type]  # type: ignore[misc, index]
         else:
-            warnings.warn("No rules found for the graph store, returning empty list.", stacklevel=2)
+            warnings.warn(
+                "No rules found for the graph store, returning empty list.",
+                stacklevel=2,
+            )
             return []
 
     def construct_instances_of_class(self, class_: str, properties_optional: bool = True) -> list[tuple[str, str, str]]:
@@ -95,7 +117,10 @@ class Queries:
             # We cannot include the RDF.type in case there is a neat:type property
             return [remove_namespace_from_uri(*triple) for triple in result if triple[1] != RDF.type]  # type: ignore[misc, index]
         else:
-            warnings.warn("No rules found for the graph store, returning empty list.", stacklevel=2)
+            warnings.warn(
+                "No rules found for the graph store, returning empty list.",
+                stacklevel=2,
+            )
             return []
 
     def list_triples(self, limit: int = 25) -> list[ResultRow]:

cognite/neat/graph/stores/_base.py

@@ -5,6 +5,7 @@ from datetime import datetime, timezone
 from pathlib import Path
 from typing import cast
 
+import pandas as pd
 from rdflib import Graph, Namespace, URIRef
 from rdflib.plugins.stores.sparqlstore import SPARQLUpdateStore
 
@@ -283,12 +284,23 @@ class NeatGraphStore:
                 )
             )
 
+    @property
+    def summary(self) -> pd.DataFrame:
+        return pd.DataFrame(self.queries.summarize_instances(), columns=["Type", "Occurrence"])
+
     def _repr_html_(self) -> str:
         provenance = self.provenance._repr_html_()
+        summary: pd.DataFrame = self.summary
+        summary_text = (
+            "<br /><strong>Graph is empty</strong><br />"
+            if summary.empty
+            else f"<br /><strong>Graph content</strong><br />{cast(pd.DataFrame, summary)._repr_html_()}"  # type: ignore[operator]
+        )
 
         return (
             f"<strong>{type(self).__name__}</strong> A graph store is a container for storing triples. "
             "It can be queried and transformed to extract information.<br />"
             "<strong>Provenance</strong> Provenance is a record of changes that have occurred in the graph store.<br />"
             f"{provenance}"
+            f"{summary_text}"
         )

cognite/neat/graph/transformers/_classic_cdf.py

@@ -1,6 +1,6 @@
 from typing import cast
 
-from rdflib import Graph, Literal, URIRef
+from rdflib import RDF, Graph, Literal, URIRef
 
 from cognite.neat.constants import DEFAULT_NAMESPACE
 from cognite.neat.graph import extractors
@@ -21,11 +21,16 @@ class AddAssetDepth(BaseTransformer):
                              <{asset_id}> <{root_prop}> ?root .}}"""
 
     def __init__(
-        self, asset_type: URIRef | None = None, root_prop: URIRef | None = None, parent_prop: URIRef | None = None
+        self,
+        asset_type: URIRef | None = None,
+        root_prop: URIRef | None = None,
+        parent_prop: URIRef | None = None,
+        depth_typing: dict[int, str] | None = None,
     ):
         self.asset_type = asset_type or DEFAULT_NAMESPACE.Asset
         self.root_prop = root_prop or DEFAULT_NAMESPACE.root
         self.parent_prop = parent_prop or DEFAULT_NAMESPACE.parent
+        self.depth_typing = depth_typing
 
     def transform(self, graph: Graph) -> None:
         """Adds depth of asset in the asset hierarchy to the graph."""
@@ -34,6 +39,13 @@ class AddAssetDepth(BaseTransformer):
             if depth := self.get_depth(graph, asset_id, self.root_prop, self.parent_prop):
                 graph.add((asset_id, DEFAULT_NAMESPACE.depth, Literal(depth)))
 
+                if self.depth_typing and (type_ := self.depth_typing.get(depth, None)):
+                    # remove existing type
+                    graph.remove((asset_id, RDF.type, None))
+
+                    # add new type
+                    graph.add((asset_id, RDF.type, DEFAULT_NAMESPACE[type_]))
+
     @classmethod
     def get_depth(
         cls,
@@ -62,7 +74,12 @@ class AddAssetDepth(BaseTransformer):
 class AssetTimeSeriesConnector(BaseTransformer):
     description: str = "Connects assets to timeseries, thus forming bi-directional connection"
     _use_only_once: bool = True
-    _need_changes = frozenset({str(extractors.AssetsExtractor.__name__), str(extractors.TimeSeriesExtractor.__name__)})
+    _need_changes = frozenset(
+        {
+            str(extractors.AssetsExtractor.__name__),
+            str(extractors.TimeSeriesExtractor.__name__),
+        }
+    )
     _asset_template: str = """SELECT ?asset_id WHERE {{
                               <{timeseries_id}> <{asset_prop}> ?asset_id .
                               ?asset_id a <{asset_type}>}}"""
@@ -100,7 +117,12 @@ class AssetTimeSeriesConnector(BaseTransformer):
 class AssetSequenceConnector(BaseTransformer):
     description: str = "Connects assets to sequences, thus forming bi-directional connection"
     _use_only_once: bool = True
-    _need_changes = frozenset({str(extractors.AssetsExtractor.__name__), str(extractors.SequencesExtractor.__name__)})
+    _need_changes = frozenset(
+        {
+            str(extractors.AssetsExtractor.__name__),
+            str(extractors.SequencesExtractor.__name__),
+        }
+    )
     _asset_template: str = """SELECT ?asset_id WHERE {{
                               <{sequence_id}> <{asset_prop}> ?asset_id .
                               ?asset_id a <{asset_type}>}}"""
@@ -138,7 +160,12 @@ class AssetSequenceConnector(BaseTransformer):
 class AssetFileConnector(BaseTransformer):
     description: str = "Connects assets to files, thus forming bi-directional connection"
     _use_only_once: bool = True
-    _need_changes = frozenset({str(extractors.AssetsExtractor.__name__), str(extractors.FilesExtractor.__name__)})
+    _need_changes = frozenset(
+        {
+            str(extractors.AssetsExtractor.__name__),
+            str(extractors.FilesExtractor.__name__),
+        }
+    )
     _asset_template: str = """SELECT ?asset_id WHERE {{
                               <{file_id}> <{asset_prop}> ?asset_id .
                               ?asset_id a <{asset_type}>}}"""
@@ -174,7 +201,12 @@ class AssetFileConnector(BaseTransformer):
 class AssetEventConnector(BaseTransformer):
     description: str = "Connects assets to events, thus forming bi-directional connection"
     _use_only_once: bool = True
-    _need_changes = frozenset({str(extractors.AssetsExtractor.__name__), str(extractors.EventsExtractor.__name__)})
+    _need_changes = frozenset(
+        {
+            str(extractors.AssetsExtractor.__name__),
+            str(extractors.EventsExtractor.__name__),
+        }
+    )
     _asset_template: str = """SELECT ?asset_id WHERE {{
                               <{event_id}> <{asset_prop}> ?asset_id .
                               ?asset_id a <{asset_type}>}}"""
@@ -211,7 +243,10 @@ class AssetRelationshipConnector(BaseTransformer):
     description: str = "Connects assets via relationships"
     _use_only_once: bool = True
     _need_changes = frozenset(
-        {str(extractors.AssetsExtractor.__name__), str(extractors.RelationshipsExtractor.__name__)}
+        {
+            str(extractors.AssetsExtractor.__name__),
+            str(extractors.RelationshipsExtractor.__name__),
+        }
     )
     _asset_template: str = """SELECT ?source ?target WHERE {{
                               <{relationship_id}> <{relationship_source_xid_prop}> ?source_xid .
@@ -256,8 +291,20 @@ class AssetRelationshipConnector(BaseTransformer):
                 # files can be connected to multiple assets in the graph
                 for source_asset_id, target_asset_id in cast(list[tuple], assets_id_res):
                     # create a relationship between the two assets
-                    graph.add((source_asset_id, DEFAULT_NAMESPACE.relationship, relationship_id))
-                    graph.add((target_asset_id, DEFAULT_NAMESPACE.relationship, relationship_id))
+                    graph.add(
+                        (
+                            source_asset_id,
+                            DEFAULT_NAMESPACE.relationship,
+                            relationship_id,
+                        )
+                    )
+                    graph.add(
+                        (
+                            target_asset_id,
+                            DEFAULT_NAMESPACE.relationship,
+                            relationship_id,
+                        )
+                    )
 
                     # add source and target to the relationship
                     graph.add((relationship_id, DEFAULT_NAMESPACE.source, source_asset_id))

{cognite_neat-0.85.9.dist-info → cognite_neat-0.85.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: cognite-neat
-Version: 0.85.9
+Version: 0.85.10
 Summary: Knowledge graph transformation
 Home-page: https://cognite-neat.readthedocs-hosted.com/
 License: Apache-2.0

{cognite_neat-0.85.9.dist-info → cognite_neat-0.85.10.dist-info}/RECORD

@@ -1,6 +1,6 @@
 cognite/neat/__init__.py,sha256=AiexNcHdAHFbrrbo9c65gtil1dqx_SGraDH1PSsXjKE,126
 cognite/neat/_shared.py,sha256=RSaHm2eJceTlvb-hMMe4nHgoHdPYDfN3XcxDXo24k3A,1530
-cognite/neat/_version.py,sha256=JP9pWIPLDxMPiu0_QxO-aYb83pueDfD_SMEnM6AHb9Q,23
+cognite/neat/_version.py,sha256=r9a11H4Pc6Steq_whDR9D6B9Q8eBS2t0VVcst7vsaQA,24
 cognite/neat/app/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 cognite/neat/app/api/asgi/metrics.py,sha256=nxFy7L5cChTI0a-zkCiJ59Aq8yLuIJp5c9Dg0wRXtV0,152
 cognite/neat/app/api/configuration.py,sha256=2U5M6M252swvQPQyooA1EBzFUZNtcTmuSaywfJDgckM,4232
@@ -75,16 +75,16 @@ cognite/neat/graph/loaders/_rdf2asset.py,sha256=aFby7BwIrW253LEJ4XqGeUuf4jG9VUe8
 cognite/neat/graph/loaders/_rdf2dms.py,sha256=2PCL8De02xlEkTmgG299k5tiZcKPnoNzCQfI1AgS2Gg,14060
 cognite/neat/graph/models.py,sha256=AtLgZh2qyRP6NRetjQCy9qLMuTQB0CH52Zsev-qa2sk,149
 cognite/neat/graph/queries/__init__.py,sha256=BgDd-037kvtWwAoGAy8eORVNMiZ5-E9sIV0txIpeaN4,50
-cognite/neat/graph/queries/_base.py,sha256=RL6YQu4apWG-WM-b1TDu5IKqsvskE6Cvlmo8rr1Trhk,5199
+cognite/neat/graph/queries/_base.py,sha256=yO1i2HPA2RiXMehANImDPxSkL6QB6LwvD22HvfdFt70,6023
 cognite/neat/graph/queries/_construct.py,sha256=FxzSQqzCpo7lKVYerlLAY03oqCeFM5L6MozfBUblzr4,7341
 cognite/neat/graph/queries/_shared.py,sha256=1-cBnoqyHQazOdNc7J5kk-_GrlHSSnYsBdNJcRD5QyI,5061
 cognite/neat/graph/stores/__init__.py,sha256=G-VG_YwfRt1kuPao07PDJyZ3w_0-eguzLUM13n-Z_RA,64
-cognite/neat/graph/stores/_base.py,sha256=z69uhzBhzl1JQJU9U-h9zAyySn25ZQTJRXam4BavnoY,10586
+cognite/neat/graph/stores/_base.py,sha256=r6NShdYp7KZBQ9WBY1BUFZa5X0SPm509vZjnllmiSIo,11085
 cognite/neat/graph/stores/_oxrdflib.py,sha256=A5zeRm5_e8ui_ihGpgstRDg_N7qcLZ3QZBRGrOXSGI0,9569
 cognite/neat/graph/stores/_provenance.py,sha256=HIXa-p7yc2l3HFkQWMnGPhn-t_FROEG21thADGkgy0c,3590
 cognite/neat/graph/transformers/__init__.py,sha256=wXrNSyJNGnis3haaCKVPZ5y5kKSUsOUHnh-860ekatk,555
 cognite/neat/graph/transformers/_base.py,sha256=b37Ek-9njuM5pTR_3XhnxCMrg_ip_2BMwM7ZhKpAAlw,328
-cognite/neat/graph/transformers/_classic_cdf.py,sha256=ZHHJU-1-lXeufuZJSuDa2Zmu56PS9PcGeFYI91VZNI4,12214
+cognite/neat/graph/transformers/_classic_cdf.py,sha256=6xX-OBSJT5DAQrTJ-nuhCfGNaSk5Iktxn-WIMfzEIqo,13189
 cognite/neat/issues.py,sha256=pxQfqfBseMDE8JM0iqZnkLXngeyeFfT0TFtu1UuAd4c,4629
 cognite/neat/legacy/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 cognite/neat/legacy/graph/__init__.py,sha256=31uTeejWOSd-I8iUG8GOZFhHZcQCsBitJ6X8vu2r1nU,73
@@ -310,8 +310,8 @@ cognite/neat/workflows/steps_registry.py,sha256=fkTX14ZA7_gkUYfWIlx7A1XbCidvqR23
 cognite/neat/workflows/tasks.py,sha256=dqlJwKAb0jlkl7abbY8RRz3m7MT4SK8-7cntMWkOYjw,788
 cognite/neat/workflows/triggers.py,sha256=_BLNplzoz0iic367u1mhHMHiUrCwP-SLK6_CZzfODX0,7071
 cognite/neat/workflows/utils.py,sha256=gKdy3RLG7ctRhbCRwaDIWpL9Mi98zm56-d4jfHDqP1E,453
-cognite_neat-0.85.9.dist-info/LICENSE,sha256=W8VmvFia4WHa3Gqxq1Ygrq85McUNqIGDVgtdvzT-XqA,11351
-cognite_neat-0.85.9.dist-info/METADATA,sha256=5qSjm9GMnwHMFSr2a2ECKRoei-cwE8esuk529j16nYM,9493
-cognite_neat-0.85.9.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-cognite_neat-0.85.9.dist-info/entry_points.txt,sha256=61FPqiWb25vbqB0KI7znG8nsg_ibLHBvTjYnkPvNFso,50
-cognite_neat-0.85.9.dist-info/RECORD,,
+cognite_neat-0.85.10.dist-info/LICENSE,sha256=W8VmvFia4WHa3Gqxq1Ygrq85McUNqIGDVgtdvzT-XqA,11351
+cognite_neat-0.85.10.dist-info/METADATA,sha256=8UOfc9V1ro6ldjvcGGTZek0bLiddHUjhdm4pbAfNoFw,9494
+cognite_neat-0.85.10.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+cognite_neat-0.85.10.dist-info/entry_points.txt,sha256=61FPqiWb25vbqB0KI7znG8nsg_ibLHBvTjYnkPvNFso,50
+cognite_neat-0.85.10.dist-info/RECORD,,