knowledgecomplex 0.1.0__py3-none-any.whl

knowledgecomplex/__init__.py

@@ -0,0 +1,91 @@
+# knowledgecomplex — typed simplicial complexes backed by OWL, SHACL, and SPARQL.
+# Internal dependencies: rdflib, pyshacl, owlrl
+# These are never re-exported. The public API is schema.py and graph.py only.
+
+from knowledgecomplex.schema import SchemaBuilder, vocab, text, TextDescriptor, Codec
+from knowledgecomplex.graph import KnowledgeComplex, Element
+from knowledgecomplex.filtration import Filtration
+from knowledgecomplex.exceptions import ValidationError, SchemaError, UnknownQueryError
+from knowledgecomplex.audit import AuditReport, AuditViolation, audit_file
+from knowledgecomplex.io import save_graph, load_graph, dump_graph
+from knowledgecomplex.clique import find_cliques, infer_faces, fill_cliques
+from knowledgecomplex.diff import ComplexDiff, ComplexSequence
+from knowledgecomplex.codecs import MarkdownCodec, verify_documents
+from knowledgecomplex.viz import (
+    to_networkx, verify_networkx, type_color_map,
+    plot_hasse, plot_hasse_star, plot_hasse_skeleton,
+    plot_geometric, plot_geometric_interactive,
+    plot_complex, plot_star, plot_skeleton,  # deprecated aliases
+)
+
+try:
+    from knowledgecomplex.analysis import (
+        boundary_matrices,
+        betti_numbers,
+        euler_characteristic,
+        hodge_laplacian,
+        edge_pagerank,
+        edge_pagerank_all,
+        hodge_decomposition,
+        edge_influence,
+        hodge_analysis,
+        graph_laplacian,
+        approximate_pagerank,
+        heat_kernel_pagerank,
+        sweep_cut,
+        local_partition,
+        edge_sweep_cut,
+        edge_local_partition,
+        BoundaryMatrices,
+        HodgeDecomposition,
+        EdgeInfluence,
+        HodgeAnalysisResults,
+        SweepCut,
+        EdgeSweepCut,
+    )
+    _HAS_ANALYSIS = True
+except ImportError:
+    _HAS_ANALYSIS = False
+
+__all__ = [
+    # Schema authoring
+    "SchemaBuilder", "vocab", "text", "TextDescriptor", "Codec",
+    # Instance management
+    "KnowledgeComplex", "Element",
+    # Filtrations
+    "Filtration",
+    # Exceptions
+    "ValidationError", "SchemaError", "UnknownQueryError",
+    # File I/O
+    "save_graph", "load_graph", "dump_graph",
+    # Visualization — Hasse diagrams
+    "to_networkx", "verify_networkx", "type_color_map",
+    "plot_hasse", "plot_hasse_star", "plot_hasse_skeleton",
+    # Visualization — geometric realization
+    "plot_geometric", "plot_geometric_interactive",
+    # Visualization — deprecated aliases
+    "plot_complex", "plot_star", "plot_skeleton",
+    # Clique inference
+    "find_cliques", "infer_faces", "fill_cliques",
+    # Diffs and sequences
+    "ComplexDiff", "ComplexSequence",
+    # Codecs
+    "MarkdownCodec", "verify_documents",
+    # Audit
+    "AuditReport", "AuditViolation", "audit_file",
+]
+
+if _HAS_ANALYSIS:
+    __all__ += [
+        # Algebraic topology
+        "boundary_matrices", "betti_numbers", "euler_characteristic",
+        "hodge_laplacian", "edge_pagerank", "edge_pagerank_all",
+        "hodge_decomposition", "edge_influence", "hodge_analysis",
+        "BoundaryMatrices", "HodgeDecomposition", "EdgeInfluence",
+        "HodgeAnalysisResults",
+        # Graph analysis
+        "graph_laplacian", "approximate_pagerank", "heat_kernel_pagerank",
+        "sweep_cut", "local_partition",
+        "edge_sweep_cut", "edge_local_partition",
+        "SweepCut", "EdgeSweepCut",
+    ]