SOIL: A theoretical manual