some common utilities for voyager project