              A dictionary stored in an alignments file containing the keys ``mask``,
              ``affine_matrix``, ``interpolator``, ``stored_size``
          """
          for key in ("mask", "affine_matrix", "interpolator", "stored_size"):
              setattr(self, self._attr_name(key), mask_dict[key])
              logger.trace("%s - %s", key, mask_dict[key] if key != "mask" else type(mask_dict[key]))
  
      @staticmethod
      def _attr_name(dict_key):
          """ The :class:`Mask` attribute name for the given dictionary key
  
 
</s> remove             Optionally the key ``hash`` will be provided, but not all use cases will know the
            face hash at this time.
 </s> add  </s> remove             filename as key and :class:`lib.faces.detected_face.AlignedFace` object as value.
 </s> add             filename as key and :class:`lib.align.AlignedFace` object as value. </s> remove         """ Iterate through the faces folder pulling out various information """
 </s> add         """ Iterate through the faces folder pulling out various information for each face.

        Yields
        ------
        dict
            A dictionary for each face found containing the keys returned from
            :class:`lib.image.read_image_meta_batch`
        """ </s> remove         """ Load the face names into dictionary """
 </s> add         """ Load the face names into dictionary.

        Returns
        -------
        dict
            The source filename as key with list of face indices for the frame as value
        """
            val = mask_dict[key]
            if key == "affine_matrix" and not isinstance(val, np.ndarray):
                val = np.array(val, dtype="float64")
            setattr(self, self._attr_name(key), val)
            logger.trace("%s - %s", key, val if key != "mask" else type(val))
              A dictionary stored in an alignments file containing the keys ``mask``,
              ``affine_matrix``, ``interpolator``, ``stored_size``
          """
          for key in ("mask", "affine_matrix", "interpolator", "stored_size"):
            val = mask_dict[key]
            if key == "affine_matrix" and not isinstance(val, np.ndarray):
                val = np.array(val, dtype="float64")
            setattr(self, self._attr_name(key), val)
            logger.trace("%s - %s", key, val if key != "mask" else type(val))
            val = mask_dict[key]
            if key == "affine_matrix" and not isinstance(val, np.ndarray):
                val = np.array(val, dtype="float64")
            setattr(self, self._attr_name(key), val)
            logger.trace("%s - %s", key, val if key != "mask" else type(val))
  
      @staticmethod
      def _attr_name(dict_key):
          """ The :class:`Mask` attribute name for the given dictionary key
  
keep keep keep keep replace replace keep keep keep keep keep
 Update extracted faces to use PNG EXIF data (#1123)

Documentation
  - Update Usage.md, align.rst and image.rst
lib.image.py
  - read_image - Remove hash return, add metadata return
  - Remove read_image_hash functions
  - Add read_image_meta functios
  - Replace encode_image_with_hash with encode_image (to store metadata)
  - Add png meta reading and writing functions
  - Update Image Loaders/Savers to handle metadata rather than hashes
lib.training_data
  - Naming updates to remove references to hashes
lib.align.Alignments
  - Add versioning notes
  - Increment alignments version to 2.1
  - Deprecate hashing lookup functions
  - Replace filter_hashes with filter_faces
lib.align.detected_face
  - DetectedFace
    - Remove hash property
    - Add png header data serializing/deserializing functions
  - Mask
    - Add png header data serializing/deserializing functions
  - add update_legacy_png_header function to update png meta data
lib.cli.args - Deprecate alignments files for training
- plugins.train.trainer
  - Update alignments/mask code to read png header data
- scripts.convert
  - Aligned images folder - read data from png headers
- scripts.extract
  - Write png header information and no longer store hash of face
- tools.alignments
  - remove leftover-faces, merge and update-hashes jobs
  - Update jobs to use png meta data rather than hashes
- tools.manual
  - Update extract code to output png meta data and don't store hashes
  - Perform check on launch that tool is not pointing at a faces folder
tools.mask
  - Update to use png meta data
tools.sort
  - Update to use png meta data 
lib/align/detected_face.py