Skip to content

graph Command Group¤

List, import, export, delete, count, tree or open graphs.

Graphs are identified by an IRI.

Note

The get a list of existing graphs, execute the graph list command or use tab-completion.

graph count¤

Count triples in graph(s).

Usage
$ cmemc graph count [OPTIONS] [IRIS]...

This command lists graphs with their triple count. Counts do not include imported graphs.

Options
-a, --all        Count all graphs
-s, --summarize  Display only a sum of all counted graphs together

graph tree¤

Show graph tree(s) of the owl:imports hierarchy.

Usage
$ cmemc graph tree [OPTIONS] [IRIS]...

You can output one or more trees of the import hierarchy.

Imported graphs which do not exist are shown as [missing: IRI]. Imported graphs which will result in an import cycle are shown as [ignored: IRI]. Each graph is shown with label and IRI.

Options
-a, --all   Show tree of all (readable) graphs.
--raw       Outputs raw JSON of the graph importTree API response.
--id-only   Lists only graph identifier (IRIs) and no labels or other
            metadata. This is useful for piping the IRIs into other
            commands. The output with this option is a sorted, flat, de-
            duplicated list of existing graphs.

graph list¤

List accessible graphs.

Usage
$ cmemc graph list [OPTIONS]
Options
--raw                      Outputs raw JSON of the graphs list API response.
--id-only                  Lists only graph identifier (IRIs) and no labels
                           or other metadata. This is useful for piping the
                           IRIs into other commands.
--filter <CHOICE TEXT>...  Filter graphs based on effective access
                           conditions or import closure. First parameter
                           CHOICE can be 'access' or 'imported-by'. The
                           second parameter can be 'readonly' or 'writeable'
                           in case of 'access' or any readable graph in case
                           of 'imported-by'.

graph export¤

Export graph(s) as NTriples to stdout (-), file or directory.

Usage
$ cmemc graph export [OPTIONS] [IRIS]...

In case of file export, data from all selected graphs will be concatenated in one file. In case of directory export, .graph and .ttl files will be created for each graph.

Options
-a, --all                       Export all readable graphs.
--include-imports               Export selected graph(s) and all graphs
                                which are imported from these selected
                                graph(s).
--create-catalog                In addition to the .ttl and .graph files,
                                cmemc will create an XML catalog file
                                (catalog-v001.xml) which can be used by
                                applications such as Protégé.
--output-dir DIRECTORY          Export to this directory.
--output-file FILE              Export to this file.  [default: -]
-t, --filename-template TEXT    Template for the export file name(s). Used
                                together with --output-dir. Possible
                                placeholders are (Jinja2): {{hash}} - sha256
                                hash of the graph IRI, {{iriname}} - graph
                                IRI converted to filename, {{connection}} -
                                from the --connection option and {{date}} -
                                the current date as YYYY-MM-DD. The file
                                suffix will be appended. Needed directories
                                will be created.  [default: {{hash}}]
--mime-type [application/n-triples|text/turtle]
                                Define the requested mime type  [default:
                                application/n-triples]

graph delete¤

Delete graph(s) from the store.

Usage
$ cmemc graph delete [OPTIONS] [IRIS]...
Options
-a, --all          Delete all writeable graphs.
--include-imports  Delete selected graph(s) and all writeable graphs which
                   are imported from these selected graph(s).

graph import¤

Import graph(s) to the store.

Usage
$ cmemc graph import [OPTIONS] INPUT_PATH [IRI]

If input is a file, content will be uploaded to the graph identified with the IRI.

If input is a directory and NO IRI is given, it scans for file-pairs such as xyz.ttl and xyz.ttl.graph, where xyz.ttl is the actual triples file and xyz.ttl.graph contains the graph IRI in the first line: https://mygraph.de/xyz/.

If input is a directory AND a graph IRI is given, it scans for all *.ttl files in the directory and imports all content to the graph, ignoring the *.ttl.graph files.

If the --replace flag is set, the data in the graphs will be overwritten, if not, it will be added.

Note

Directories are scanned on the first level only (not recursively).

Options
--replace        Replace / overwrite the graph(s), instead of just adding
                 the triples to the graph.
--skip-existing  Skip importing a file if the target graph already exists in
                 the store. Note that the graph list is fetched once at the
                 beginning of the process, so that you can still add
                 multiple files to one single graph (if it does not exist).

graph open¤

Open / explore a graph in the browser.

Usage
$ cmemc graph open IRI

Comments