#------------------------------------------------------------
# utility functions below.
#------------------------------------------------------------
#------------------------------------------------------------
# utility functions below.
#------------------------------------------------------------