documented poscar based functions