job_descendant¶

Check if A Job is a Descendant of Another¶

Prototype¶

# at_cascade.job_descendant
def job_descendant(job_table, ancestor_id, descendant_id) :
    assert type(job_table)   == list
    assert type(ancestor_id)   == int
    assert type(descendant_id) == int
    assert generation == None or type(generation) == int
    return generation

job_table¶

Is the job_table for this analysis.

ancestor_id¶

is the job_id for the ancestor job.

descendant_id¶

is the job_id for the descendant job.

generation¶

If the job descendant is a descendant of job ancestor_id , the return value generation is the number of generations between them. If the two job ids are the same, generation is zero. If the job descendant is not a descendant of job ancestor_id , the return value is None.

Node Depth Versus Job Depth¶

We use ancestor and descendant node to denote the nodes corresponding to:

job_table [ ancestor_id] [‘fit_node_id’]

job_table [ descendant] [‘fit_node_id’]

We use ancestor and descendant reference to denote the split reference values corresponding to:

job_table [ ancestor_id] [‘split_reference_id’]

job_table [ descendant] [‘split_reference_id’]

If the ancestor reference is equal to the descendant reference, or if refit_split is false, generation is equal to the number of nodes between the ancestor and descendant nodes. Otherwise, generation is one more than the number of nodes between the ancestor and descendant nodes. (There can be at most one split between any two nodes.