add default value for ratio to the api docs