---------------------------------------------------
lines 6-40 of file: at_cascade/csv/covariate_avg.py
---------------------------------------------------

{xrst_begin csv.covariate_avg}

Compute Covariate Averages for One Node
#######################################

Prototype
*********
{xrst_literal ,
    # BEGIN_DEF, # END_DEF
    # BEGIN_RETURN, # END_RETURN
}

covariate_table
***************
Is a ``list`` of ``dict`` representation of a
:ref:`csv.simulate@Input Files@covariate.csv` file.
All of the columns in this table have been converted to ``float``
except for *node_name* and *sex* which have type ``str`` .
In addition, *sex* equal to ``both`` may have been added; see
:ref:`csv.covariate_both-name` .

node_name
*********
is a str contain the name of the node that we are computing the average for.

covariate_average
*****************
This return is a dict where the keys are the covariates in covariate.csv
and the values are the average of the corresponding covariate.

sex
***
is the sex that this average is for.

{xrst_end csv.covariate_avg}