improved documentation
function poly_db_ids