More refraction and additional documentation