Export¶

Export knowledge graphs and data to multiple formats with W3C-compliant serialization.

🎯 Overview¶

⚙️ Algorithms Used¶

Serialization Algorithms¶

RDF/XML Serialization: - Standard: W3C RDF/XML specification - Format: XML-based RDF representation - Use case: Interoperability with XML-based systems

Turtle Serialization: - Standard: W3C Turtle specification - Format: Compact RDF format with prefix compression - Use case: Human-readable RDF representation

JSON-LD Serialization: - Standard: W3C JSON-LD specification - Format: JSON-based linked data with context - Use case: Web APIs and JavaScript applications

GraphML Generation: - Format: XML-based graph format - Use case: Graph visualization tools (Gephi, Cytoscape)

Cypher Query Generation: - Format: Neo4j query language - Use case: Direct import into Neo4j graph database

Export Optimization¶

Streaming Export: - Purpose: Memory-efficient export for large graphs - How it works: Processes data in chunks without loading entire graph into memory - Use case: Exporting graphs with millions of nodes/edges

Batch Processing: - Purpose: Efficient large-scale data export - How it works: Chunked export with configurable batch sizes - Use case: Exporting multiple graphs or large datasets

Compression: - Purpose: Reduce file size for large exports - How it works: GZIP compression for large exports - Use case: Network transfer and storage optimization

Incremental Export: - Purpose: Export only changed data - How it works: Tracks changes and exports only modified entities/relationships - Use case: Regular updates and synchronization

Main Classes¶

RDFExporter¶

Export knowledge graphs to RDF formats (Turtle, RDF/XML, JSON-LD, N-Triples).

Methods:

RDFSerializer¶

RDF serialization engine for format conversion.

Methods:

RDFValidator¶

RDF validation engine for syntax and consistency checking.

Methods:

NamespaceManager¶

RDF namespace management and conflict resolution.

Methods:

Supported RDF Formats:

Example:

from semantica.export import RDFExporter

exporter = RDFExporter(
    base_uri="http://example.org/",
    namespaces={
        "ex": "http://example.org/",
        "foaf": "http://xmlns.com/foaf/0.1/"
    }
)

# Export to Turtle
exporter.export(
    graph=kg,
    filename="output.ttl",
    format="turtle"
)

# Export to JSON-LD
exporter.export(
    graph=kg,
    filename="output.jsonld",
    format="json-ld"
)

JSONExporter¶

Export knowledge graphs to JSON formats including JSON-LD, Cytoscape.js, and D3.js.

Methods:

JSON Formats:

• Standard JSON: Simple node/edge lists
• JSON-LD: Linked data with @context
• Cytoscape.js: For Cytoscape visualization
• D3.js: For D3 force-directed graphs
• Neo4j JSON: Neo4j-compatible format

Example:

from semantica.export import JSONExporter

exporter = JSONExporter()

# Standard JSON export
exporter.export(kg, "output.json", format="standard")

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

# Cytoscape format
exporter.export_cytoscape(kg, "cytoscape.json")

GraphExporter¶

Export to graph visualization formats (GraphML, GEXF, DOT, Pajek).

Methods:

Graph Formats:

Example:

from semantica.export import GraphExporter

exporter = GraphExporter()

# Export to GraphML
exporter.to_graphml(kg, "graph.graphml")

# Export to DOT for Graphviz
exporter.to_dot(kg, "graph.dot")

LPGExporter¶

Export to LPG (Labeled Property Graph) format for Neo4j, Memgraph, and similar databases.

Methods:

Cypher Generation:

// Node creation
CREATE (n:Person {name: "Steve Jobs", born: 1955})

// Relationship creation
MATCH (a:Person {name: "Steve Jobs"}), (b:Organization {name: "Apple Inc."})
CREATE (a)-[:FOUNDED]->(b)

Example:

from semantica.export import LPGExporter

exporter = LPGExporter(batch_size=1000, include_indexes=True)

# Export to Cypher file
exporter.export_knowledge_graph(kg, "graph.cypher")

# Generate Cypher queries
cypher_queries = exporter.generate_cypher(kg)
print(cypher_queries)

CSVExporter¶

Export to CSV format for spreadsheets and database imports.

Methods:

CSV Formats: - Nodes CSV: id, label, properties (flattened) - Edges CSV: source, target, type, properties - Neo4j Import Format: Neo4j-compatible CSV

Example:

from semantica.export import CSVExporter

exporter = CSVExporter()

# Export nodes and edges separately
exporter.export_nodes(kg, "nodes.csv")
exporter.export_edges(kg, "edges.csv")

# Or combined export
exporter.export_combined(kg, prefix="graph")
# Creates: graph_nodes.csv, graph_edges.csv

VectorExporter¶

Export vector embeddings to various formats.

Methods:

Example:

from semantica.export import VectorExporter

exporter = VectorExporter(format="json", include_metadata=True)
exporter.export(vectors, "vectors.json")

OWLExporter¶

Export ontologies to OWL format (OWL/XML, Turtle).

Methods:

Example:

from semantica.export import OWLExporter

exporter = OWLExporter(ontology_uri="http://example.org/ontology#")
exporter.export(ontology, "ontology.owl", format="owl-xml")

SemanticNetworkYAMLExporter¶

Export semantic networks to YAML format.

Methods:

Example:

from semantica.export import SemanticNetworkYAMLExporter

exporter = SemanticNetworkYAMLExporter()
exporter.export(semantic_network, "network.yaml")

YAMLSchemaExporter¶

Export ontology schemas to YAML format.

Methods:

Example:

from semantica.export import YAMLSchemaExporter

exporter = YAMLSchemaExporter()
exporter.export_ontology_schema(schema, "schema.yaml")

ReportGenerator¶

Generate reports in multiple formats (HTML, Markdown, JSON, Text).

Methods:

Example:

from semantica.export import ReportGenerator

generator = ReportGenerator(format="html", include_charts=True)
generator.generate_report(data, "report.html")

MethodRegistry¶

Registry for custom export methods.

Methods:

Global Instance: - method_registry: Global method registry instance

Example:

from semantica.export import method_registry

method_registry.register("json", "custom_method", custom_json_export)
method = method_registry.get("json", "custom_method")
all_methods = method_registry.list_all()

ExportConfig¶

Configuration manager for export module.

Methods:

Global Instance: - export_config: Global export configuration instance

Example:

from semantica.export.config import export_config, ExportConfig

# Using global instance
export_config.set("default_format", "json")
format = export_config.get("default_format", default="json")

# Create custom instance
config = ExportConfig(config_file="config.yaml")

Convenience Functions¶

Export Functions¶

Registry Functions¶

Example:

from semantica.export.methods import (
    export_rdf, export_json, export_csv, export_graph,
    export_yaml, export_owl, export_vector, export_lpg,
    generate_report, get_export_method, list_available_methods
)

# Export functions
export_rdf(kg, "output.ttl", format="turtle")
export_json(kg, "output.json", format="json")
export_lpg(kg, "graph.cypher", method="cypher")

# Registry functions
method = get_export_method("json", "custom_method")
all_methods = list_available_methods()

Configuration¶

# config.yaml - Export Configuration

export:
  rdf:
    default_format: turtle
    base_uri: "http://example.org/"
    include_provenance: true
    validate_output: true

  json:
    pretty_print: true
    indent: 2
    ensure_ascii: false

  graph:
    include_metadata: true
    export_properties: true

  neo4j:
    batch_size: 1000
    create_indexes: true
    create_constraints: true

  csv:
    delimiter: ","
    quote_char: "\""
    encoding: "utf-8"
    include_header: true

Performance Characteristics¶

Export Speed¶

Memory Usage¶

• Streaming Export: Constant memory usage
• Batch Export: Memory proportional to batch size
• Full Export: Memory proportional to graph size

See Also¶

• Knowledge Graph Module - Build graphs
• Visualization Module - Visualize exported graphs
• Core Module - Framework orchestration

Cookbook¶

Interactive tutorials to learn export capabilities:

• Export: Export knowledge graphs to various formats
• Topics: RDF, JSON, CSV, OWL export, format conversion
• Difficulty: Intermediate

• Use Cases: Data export, format conversion, interoperability

• Multi-Format Export: Exporting to RDF, OWL, JSON-LD, and NetworkX formats

• Topics: Serialization, interoperability, multiple formats, batch export
• Difficulty: Intermediate
• Use Cases: Multi-format export, data interoperability

Algorithms Used¶

Serialization Algorithms¶

• RDF/XML Serialization: W3C RDF/XML specification
• Turtle Serialization: Compact RDF format with prefix compression
• JSON-LD Serialization: JSON-based linked data with context
• GraphML Generation: XML-based graph format
• Cypher Query Generation: Neo4j query language generation

Export Optimization¶

• Streaming Export: Memory-efficient export for large graphs
• Batch Processing: Chunked export with configurable batch sizes
• Compression: GZIP compression for large exports
• Incremental Export: Export only changed data

Main Classes¶

RDFExporter¶

Methods:

Supported RDF Formats:

Example:

from semantica.export import RDFExporter

exporter = RDFExporter(
    base_uri="http://example.org/",
    namespaces={
        "ex": "http://example.org/",
        "foaf": "http://xmlns.com/foaf/0.1/"
    }
)

# Export to Turtle
exporter.export(
    graph=kg,
    filename="output.ttl",
    format="turtle"
)

# Export to JSON-LD
exporter.export(
    graph=kg,
    filename="output.jsonld",
    format="json-ld"
)

JSONExporter¶

Methods:

JSON Formats:

• Standard JSON: Simple node/edge lists
• JSON-LD: Linked data with @context
• Cytoscape.js: For Cytoscape visualization
• D3.js: For D3 force-directed graphs
• Neo4j JSON: Neo4j-compatible format

Example:

from semantica.export import JSONExporter

exporter = JSONExporter()

# Standard JSON export
exporter.export(kg, "output.json", format="standard")

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

# Cytoscape format
exporter.export_cytoscape(kg, "cytoscape.json")

GraphExporter¶

Methods:

Graph Formats:

Example:

from semantica.export import GraphExporter

exporter = GraphExporter()

# Export to GraphML
exporter.to_graphml(kg, "graph.graphml")

# Export to DOT for Graphviz
exporter.to_dot(kg, "graph.dot")

Neo4jExporter¶

Methods:

Cypher Generation:

// Node creation
CREATE (n:Person {name: "Steve Jobs", born: 1955})

// Relationship creation
MATCH (a:Person {name: "Steve Jobs"}), (b:Organization {name: "Apple Inc."})
CREATE (a)-[:FOUNDED]->(b)

Example:

from semantica.export import Neo4jExporter

exporter = Neo4jExporter()

# Direct export to Neo4j
exporter.export(
    graph=kg,
    uri="bolt://localhost:7687",
    username="neo4j",
    password="password"
)

# Generate Cypher queries
cypher_queries = exporter.generate_cypher(kg)
print(cypher_queries)

CSVExporter¶

Methods:

CSV Formats: - Nodes CSV: id, label, properties (flattened) - Edges CSV: source, target, type, properties - Neo4j Import Format: Neo4j-compatible CSV

Example:

from semantica.export import CSVExporter

exporter = CSVExporter()

# Export nodes and edges separately
exporter.export_nodes(kg, "nodes.csv")
exporter.export_edges(kg, "edges.csv")

# Or combined export
exporter.export_combined(kg, prefix="graph")
# Creates: graph_nodes.csv, graph_edges.csv

VectorExporter¶

Methods:

Configuration¶

# config.yaml - Export Configuration

export:
  rdf:
    default_format: turtle
    base_uri: "http://example.org/"
    include_provenance: true
    validate_output: true

  json:
    pretty_print: true
    indent: 2
    ensure_ascii: false

  graph:
    include_metadata: true
    export_properties: true

  neo4j:
    batch_size: 1000
    create_indexes: true
    create_constraints: true

  csv:
    delimiter: ","
    quote_char: "\""
    encoding: "utf-8"
    include_header: true

Performance Characteristics¶

Export Speed¶

Memory Usage¶

• Streaming Export: Constant memory usage
• Batch Export: Memory proportional to batch size
• Full Export: Memory proportional to graph size

See Also¶

• Knowledge Graph Module - Build graphs
• Visualization Module - Visualize exported graphs
• Core Module - Framework orchestration