semantica/docs/reference/export.md

title, description, icon

title	description	icon
Export Module	Export knowledge graphs to RDF, Parquet, LPG, ArangoDB AQL, CSV, GraphML, OWL, JSON-LD, and vector formats.	file-export

Export knowledge graphs and embeddings to 12+ formats with W3C-compliant serialization.

---

Overview

The Export Module serializes knowledge graphs to every downstream format — semantic web standards, analytics pipelines, graph databases, and vector stores.

Turtle, JSON-LD, N-Triples, RDF/XML with namespace management. Columnar storage for Spark, BigQuery, Databricks, Snowflake. Labeled Property Graph — Cypher CREATE statements for Neo4j and Memgraph. ArangoDB AQL INSERT statements for multi-model graph databases. GraphML, GEXF, DOT formats for visualization tools like Gephi. OWL 2.0 ontology export in Turtle, XML, and JSON-LD.

---

RDFExporter

from semantica.export import RDFExporter

exporter = RDFExporter()

# Turtle
rdf = exporter.export_to_rdf(graph, format="turtle")
exporter.export_to_file(graph, "output.ttl", format="turtle")

# JSON-LD
exporter.export_to_file(graph, "output.jsonld", format="json-ld")

# N-Triples
exporter.export_to_file(graph, "output.nt", format="nt")

# RDF/XML
exporter.export_to_file(graph, "output.xml", format="xml")

Namespace management:

from semantica.export import NamespaceManager, RDFSerializer

ns_manager = NamespaceManager()
ns_manager.register("ex", "http://example.org/")
ns_manager.register("schema", "https://schema.org/")

exporter = RDFExporter(namespace_manager=ns_manager)

---

ParquetExporter

For Spark, BigQuery, Databricks, and Snowflake analytics pipelines:

from semantica.export import ParquetExporter

exporter = ParquetExporter(compression="snappy")  # snappy | gzip | brotli | zstd | lz4

# Export nodes and edges separately
exporter.export_nodes(graph, "nodes.parquet")
exporter.export_edges(graph, "edges.parquet")

# Export full graph (partitioned)
exporter.export(graph, output_dir="graph_parquet/", partition_by="node_type")

Parquet schema is explicitly typed with PyArrow for clean Spark/BigQuery ingestion.

---

LPGExporter

Labeled Property Graph — Cypher CREATE statements for Neo4j and Memgraph:

from semantica.export import LPGExporter

exporter = LPGExporter()

# Generate Cypher
cypher = exporter.to_cypher(graph)
exporter.export(graph, "import.cypher", format="cypher")

# Generate MERGE statements (idempotent)
cypher_merge = exporter.to_cypher(graph, use_merge=True)

---

ArangoAQLExporter

ArangoDB AQL INSERT statements for vertex and edge collections:

from semantica.export import ArangoAQLExporter

exporter = ArangoAQLExporter(
    vertex_collection="entities",
    edge_collection="relationships"
)

aql = exporter.export(graph)               # returns AQL string
exporter.export_to_file(graph, "import.aql")

---

GraphExporter

GraphML, GEXF, and DOT formats for visualization tools:

from semantica.export import GraphExporter

exporter = GraphExporter()

exporter.export(graph, "graph.graphml", format="graphml")  # Gephi, yEd
exporter.export(graph, "graph.gexf",    format="gexf")     # Gephi streaming
exporter.export(graph, "graph.dot",     format="dot")      # Graphviz

---

OWLExporter

OWL 2.0 ontology export:

from semantica.export import OWLExporter

exporter = OWLExporter()
exporter.export(ontology, path="ontology.ttl", format="turtle")
exporter.export(ontology, path="ontology.owl", format="xml")
exporter.export(ontology, path="ontology.json", format="json-ld")

---

CSVExporter

from semantica.export import CSVExporter

exporter = CSVExporter(delimiter=",")
exporter.export_nodes(graph, "nodes.csv")
exporter.export_edges(graph, "edges.csv")

---

VectorExporter

Export embedding vectors for external vector stores:

from semantica.export import VectorExporter

exporter = VectorExporter()
exporter.export(embeddings, metadata, "vectors.json", format="json")
exporter.export(embeddings, metadata, "vectors.npy",  format="numpy")

# FAISS-compatible binary format
exporter.export(embeddings, metadata, "vectors.faiss", format="faiss")

---

ArrowExporter

Apache Arrow IPC format for zero-copy inter-process transfer:

from semantica.export import ArrowExporter

exporter = ArrowExporter()
exporter.export(graph, "graph.arrow")

Requires pyarrow. Falls back gracefully if not installed.

---

DistanceExporter

Export semantic distance matrices from Distance Intelligence:

from semantica.export import DistanceExporter

exporter = DistanceExporter()
exporter.export_matrix(distance_matrix, node_labels, "distances.csv")
exporter.export_ego(ego_neighborhood, center_node="Apple Inc.", path="ego.json")

---

ReportGenerator

Generate human-readable reports from graph analytics:

from semantica.export import ReportGenerator

generator = ReportGenerator()

# HTML report
generator.generate(graph, analytics_result, "report.html", format="html")

# Markdown
generator.generate(graph, analytics_result, "report.md", format="markdown")

# JSON
generator.generate(graph, analytics_result, "report.json", format="json")

---

Convenience Functions

from semantica.export import (
    export_rdf, export_parquet, export_csv, export_lpg,
    export_arango, export_graph, export_owl, export_vector,
    export_arrow, generate_report
)

export_rdf(graph,     "output.ttl",   format="turtle")
export_parquet(graph, "output/",       compression="snappy")
export_csv(graph,     "nodes.csv",    target="nodes")
export_lpg(graph,     "import.cypher", method="cypher")
export_arango(graph,  "import.aql")
export_graph(graph,   "graph.graphml", format="graphml")

---

Selective Export

# Export a subgraph
subgraph = graph.subgraph(node_ids=["apple_inc", "steve_jobs"])
export_rdf(subgraph, "subgraph.ttl", format="turtle")

# Export nodes by type
org_nodes = graph.filter(node_type="Organization")
export_parquet(org_nodes, "organizations.parquet")

---

See Also

Store RDF exports in a SPARQL-queryable backend. Export OWL ontologies. Include provenance in RDF exports. Add export as a pipeline step.