document --use-cache-lock
handle threshold_res higher than first resolution