add possibility to define known origins
update documentation