modify comments

face3d/morphable_model/fit.py

@@ -1,10 +1,9 @@
 '''
-Estimating parameters about vertices: shape para, exp para
+Estimating parameters about vertices: shape para, exp para, pose para(s, R, t)
 '''
 import numpy as np
 from .. import mesh
 
-
 ''' TODO: a clear document. 
 Given: image_points, 3D Model, Camera Matrix(s, R, t2d)
 Estimate: shape parameters, expression parameters
@@ -83,7 +82,7 @@ def estimate_shape(x, shapeMU, shapePC, shapeEV, expression, s, R, t2d, lamb = 3
 
  # --- calc pc
  pc_3d = np.resize(shapePC.T, [dof, n, 3]) # 199 x n x 3
- pc_3d = np.reshape(pc_3d, [dof*n, 3]) ## !it still works without this line, but Adding this will let the next line run faster than without reshape, I don't know why. ##ToDo: learn more about numpy dot mul 
+ pc_3d = np.reshape(pc_3d, [dof*n, 3]) 
  pc_2d = pc_3d.dot(A.T.copy()) # 199 x n x 2
 
  pc = np.reshape(pc_2d, [dof, -1]).T # 2n x 199
@@ -212,7 +211,7 @@ def fit_points(x, X_ind, model, n_sp, n_ep, max_iter = 4):
  return sp, ep, s, R, t
 
 
-# ---------------- fit 
+# ---------------- fitting process
 def fit_points_for_show(x, X_ind, model, n_sp, n_ep, max_iter = 4):
  '''
  Args:

face3d/morphable_model/morphabel_model.py

@@ -94,7 +94,7 @@ def generate_colors(self, tex_para):
  return colors
 
 
- # ------------------------------------------- transform
+ # ------------------------------------------- transformation
  # ------------- transform
  def rotate(self, vertices, angles):
  ''' rotate face
@@ -116,6 +116,7 @@ def transform(self, vertices, s, angles, t3d):
  def transform_3ddfa(self, vertices, s, angles, t3d): # only used for processing 300W_LP data
  R = mesh.transform.angle2matrix_3ddfa(angles)
  return mesh.transform.similarity_transform(vertices, s, R, t3d)
+
  # --------------------------------------------------- fitting
  def fit(self, x, X_ind, max_iter = 4, isShow = False):
  ''' fit 3dmm & pose parameters