Processing math: 100%

ndgRootProv

Identify the root ancestors in a provenance structure

Description:

This function searches the supplied provenance structure for root ancestors, and returns information about them. An ancestor is a root ancestor if it does not itself have any ancestors.

Invocation

AstKeyMap ndgRootProv( NdgProvenance prov, int status )

Arguments

prov
An identifier for a structure holding the provenance information as returned by ndgReadProv or ndgReadVotProv.
status
The global status.

Returned Value

A pointer to an AST KeyMap containing an entry for each root ancestor. The key associated with each entry is the path to the NDF and the value of the entry is an integer that gives the position of the root ancestor within the list of all ancestors. This integer value can be supplied to ndgGetProv in order to get further information about the root ancestor. The first ancestor NDF has an index of one. An index of zero refers to the NDF from which the provenance information was read.