pmltq [--server <URL_or_server_ID> ] [ <options> ] [ --stdin | --query-file <filename> | --query <query> | <query> ] pmltq --btred [ <options> ] [ --stdin | --query-file <filename> | --query <query> ] [ -l <filelist> | <file(s)> ] pmltq --ntred [ <options> ] [ --stdin | --query-file <filename> | --query <query> ] [ -l <filelist> | <file(s)> ] pmltq --jtred [ <options> ] [ --stdin | --query-file <filename> | --query <query> ] [ -l <filelist> | <file(s)> ]
or
pmltq [options] [ --print-servers|-P | --node-types | --relations ]
pmltq -P for a list of configured connections pmltq -u for usage pmltq -h for help pmltq --man for the manual page pmltq --version for version
pmltq is a command-line interface to PML-TQ. It can use either a SQL-based query engine, btred, ntred, or jtred (btred over a SGE cluster) to evaluate the query. The results are printed to the standard output.
Use SQL-based query engine (default).
Query given files or filelist using btred.
Query given files or filelist using ntred (ntred servers must be already up and running).
Run query query over given files/filelist using jtred (multiple btred instances distributed over an SGE cluster).
If used with SQL-based engine, this option can be used to specify a URL (http://hostname:port) to a pmltq http server, or an ID of a pre-configured SQL or HTTP server (use --print-servers to get a list).
If used with btred or jtred, it can be used to specify a server to run btred/jtred on using SSH.
If used with ntred, it can be used to specify a hostname and port (hostname:port) for the ntred hub.
Read query from the standard input.
Specify PML-TQ query on the command-line.
Read PML-TQ query from a given (utf-8 encoded text) file
Read PML-TQ query from a given PML file
Use query with a given ID. If the input is a text file, it can contain more than one query. In that case, each query must start with a line of the following form:
# == query: ID ==
where ID is a unique identifier of the query. This option can be used to select a single query from the input.
If the input is a PML file, then the ID is just the id of the query tree.
This flag can be used with --btred, --ntred, or --jtred to spedify a file containing a list of files to search, each on a separate line.
Note that for --ntred, the files must be already loaded on the ntred servers and this flag simply allows you to specify a subcorpus.
Use username/password stored in the configuration for a given service (spcified by URL or config-file ID) on the serice specified using --server.
Username for a HTTP or SQL PML-TQ service.
Password for a HTTP or SQL PML-TQ service.
Only applicable to SQL-based engine. Specify maximum number of results (i.e. rows printed by pmltq).
Only applicable to SQL-based engine. Specify a timeout for the query. If the query evaluation takes longer than a given number of seconds, pmltq terminates the connection with the server and returns with a message "Evaluation of query timed out" and exit code 2.
Specify a configuration file. The configuration file is a XML file (in fact, a PML instance conforming to the treebase_conf_schema.xml) that lists available SQL engine configurations. If this option is not provided, pmltq attempts to find a file named treebase.conf in the resource paths (namely in ~/.tred.d).
List available node types and exit.
Print list of configured query server connections and exit. If a HTTP service is specified using the --server option, the service is contacted to provide a list of all other public PML-TQ services running on the same server for which the user is authorized.
Assume the query is in NetGraph syntax and translate it to PMLTQ, using a given node type as the default type.
Print some extended information (e.g. evaluation benchmarks).
Print a brief help message on usage and exits.
Prints the help page and exits.
Displays the help as manual page.
Print program version.
To install PMLTQ, copy and paste the appropriate command in to your terminal.
cpanm
cpanm PMLTQ
CPAN shell
perl -MCPAN -e shell install PMLTQ
For more information on module installation, please visit the detailed CPAN module installation guide.