fix: removed comments and added comments

particle-track-and-trace/src/CartographicTransformation.h

@@ -15,19 +15,20 @@
 vtkSmartPointer<vtkCamera> createNormalisedCamera();
 
 /**
- * Constructs a 4x4 projection matrix that maps homogenious (longitude, latitude, 0, 1) points
- * to the normalised space.
- * TODO: This transformation has room for improvement see:
- * https://github.com/MakeNEnjoy/interactive-track-and-trace/issues/12
- * @return pointer to 4x4 matrix
- */
-vtkSmartPointer<vtkMatrix4x4> getCartographicTransformMatrix(const std::shared_ptr<UVGrid> uvGrid);
-
-/**
- * Convenience function that converts the 4x4 projection matrix into a vtkTransformFilter
- * @return pointer to transform filter
+ *  Creates a mercator projection and then scales into normalised space.
+ *  @param uvGrid grid that contains latitudes and longitudes
+ *  @return pointer to transform filter
  */
 vtkSmartPointer<vtkTransformFilter> createCartographicTransformFilter(const std::shared_ptr<UVGrid> uvGrid);
 
+/**
+ * Creates an inverse mercator projection and then scales into normalised space.
+ *
+ * Note that it is not possible to call the Inverse() member function on the transform of the
+ * createCartographicTransformFilter. It produces the wrong output,
+ * I believe that this is a bug in VTK, I might make an issue about this sometime.
+ * @param uvGrid grid that contains latitudes and longitudes
+ * @return pointer to transform filter
+ */
 vtkSmartPointer<vtkTransformFilter> createInverseCartographicTransformFilter(const std::shared_ptr<UVGrid> uvGrid);
 #endif //NORMALISEDCARTOGRAPHICCAMERA_H