NAME¶

trist - command-line RDF statistics

SYNOPSIS¶

  trist [options] INPUT-URI [INPUT-BASE-URI]
  Options:
    --input F, -i F        Set the input format to F
    --input-uri U, -I U    Alternative to INPUT-BASE-URI
    --summary, --nosummary Show/hide summary info
    --vocabs, --novocabs   Show/hide vocabulary info
    --nodes=X              Show ABox node info
    --quiet, -q            No extra information messages
    --help, -h             Show this help
    --version, -v          Show module versions
  
  Input formats: rdfxml, n3, turtle, rdfa, rdfjson, nquads, trig, atom, xrd.

OPTIONS¶

--input, -i

Specify the input format. The synopsis of this manual page shows a list of input formats. Using media types should work too. In summary, it accepts any type that the "rdf_parse" function from RDF::TrineShortcuts accepts.

 

If an input type is not specified, trist will try to guess the input type (and will almost always get it right).

--input-uri, -I, INPUT-BASE-URI

Any of these three methods can be used to specify a base URI for the parser to resolve relative URI references.

--summary, --nosummary

Show (or not) a summary of the RDF data. Shown by default. Includes counts of the number of unique values in subject, predicate and object positions, along with the most popular subject, predicate and object; etc.

 

In this summary, "Type" is defined as any node that is the object of a triple where the predicate is rdf:type; "Vocabulary" is calculated from splitting predicate URIs and type URIs into vocabulary and term using QName rules.

--vocabs, --novocabs

Vocabularies calculated as above. This shows all vocabularies used in the source RDF data; not just the single most popular one.

--nodes=X

Show the X most popular "ABox" nodes. RDF doesn't actually distinguish between so called TBox and ABox terms, but this tool treats any predicates or rdf:type objects as TBox, everything else as ABox.

 

One-off literals are ignored.

--quiet, -q

Hides useless debugging messages.

--help, -h

Shows a short help message.

--version, -v

Shows the version of various Perl modules used by trist. trist itself doesn't have a version number, but is distributed along with RDF::TrineShortcuts, so could be considered to have the same version number as that.

NOTE¶

Trist is a tool that generates a set of statistics about some input RDF data. Its output is in Turtle, designed to be as human-readable as possible. Trist is an archaic spelling of 'tryst' which is a secret meeting.

AUTHOR¶

Toby Inkster, <tobyink@cpan.org>

COPYRIGHT AND LICENCE¶

Copyright (C) 2010 by Toby Inkster This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8 or, at your option, any later version of Perl 5 you may have available.