see notes in readme_farm.txt