Note that roottree is only present in a SpecTcl instances that have loaded the rootinterface package loaded. See the SpecTcl command reference for this command
The URLs's for this part of the REST interface allow you to create Root output trees. These are objects that create CERN ROOT output files with trees that have some subsset of parameters of some subset of events.
Note that writing root trees significantly impacts the performance of SpecTcl owing to the poor performance of ROOT file output. Use with caution.
To create a new root tree you can use the following URL
http://host:port/spectcl/roottree/create?tree=treename¶meter=pattern1[&gate=gatename¶meter=pattern2...]
The query parameters are as follows:
Name of the new root tree object. This must be unique.
Each of these parameters specifies a pattern that can have glob wildcard characters. The parameters that will be booked into the tree is set of parameters whose names match any of the patterns.
At least one pattern is required.
If provided, the value of this parameter is the name of an existing gate that will determine which events are placed in the tree. Only those events that satisfy the gate will be bookeed into the tree.
If this parameter is not provided, the built-in -TRUE- gate is used which books all events.
To delete a tree that's already been created:
Where tree is the name of the tree to delete.
To learn which trees have been created and their properties:
Provides a return value who's detail lists all of the root tree objects whith names that match the optional pattern query parameter value. This pattern can contain glob pattern wild card characters. The detail attribute will be an array of objects. Each object describes one root tree and will have the following attributes
Name of the tree to create.
Array of parameter name patterns that define the parameers to book into the tree.
Name of the gate that must be satisfied to add an event to the tree. Note that if there is not one the pre-defined name -TRUE- will appear here.