3.1 `cgp`: parsing trees

The cgp is the parse tree tool. It parses a ADF file, using pyADF, and prints a text representation of the ADF tree. The tool is not written as a programming example for the package, but it is good for a first level look at an ADF tree. The options we have are:

x Output format is ADF XML
t Output format is free text
p Shows all the paths of the tree (CGNS)
P Shows all the paths of the tree (ADF)
z Display the contents of arrays
l Follow links

The following command displays an XML ouput of the tree, but without displaying the float/integer data arrays:

cgp -x "naca0012.cgns"

You obtain this kind of output example (truncated):

  <NODE name='ADF MotherNode' label='Root Node of ADF File'>
   <DATA type='MT' />
   <DIMENSIONS total='0'>
   </DIMENSIONS>
   <VALUES>
   </VALUES>
   <NODE name='top' label='Base'>
    <DATA type='MT' />
    <DIMENSIONS total='0'>
    </DIMENSIONS>
   ...

The default behavior is to produce a textual tree, with information about types, labels, dimensions...

Some options of the tool allow to have some more compact display of the tree. The following command simply displays the name tree, or path tree, for the same database as in the previous example:

>parseTree.py -p "myData.cgns"
/ADF MotherNode
/ADF MotherNode/top
/ADF MotherNode/top/coordinates
/ADF MotherNode/top/coordinates/x
/ADF MotherNode/top/coordinates/y
/ADF MotherNode/top/description
/ADF MotherNode/top/dimensions
/ADF MotherNode/top/dimensions/i
/ADF MotherNode/top/dimensions/j

You can also tell the parser to follow links. In the case of the path display, the link doesn't appear. You have a list of all possibles paths without any distinction between real or link nodes.

But if you use the text or XML ouput, the link appears as a node, the label contains the destination file and destination node.

3.1 cgp: parsing trees

3.1 `cgp`: parsing trees