              help="R|Sort by method. Choose how images are sorted. "
                   "\nL|'blur': Sort faces by blurriness."
                   "\nL|'face': Use VGG Face to sort by face similarity. This uses a pairwise "
                   "clustering algorithm to check the distances between 512 features on every face "
                   "in your set and order them appropriately. NB: You should provide an alignments "
                   "file if using this method. Not doing so will lead to vastly inferior results."
                   "\nL|'face-cnn': Sort faces by their landmarks. You can adjust the threshold "
                   "with the '-t' (--ref_threshold) option."
                   "\nL|'face-cnn-dissim': Like 'face-cnn' but sorts by dissimilarity."
                   "\nL|'face-yaw': Sort faces by Yaw (rotation left to right)."
                   "\nL|'hist': Sort faces by their color histogram. You can adjust the threshold "
 
</s> remove 
        if no_hash:
            logger.warning("%s image(s) were not found in the alignments file. This will likely "
                           "result in sub-par sorting results, so you should check the output "
                           "carefully", no_hash)

 </s> add  </s> remove     """ Sort alignments' index by the order they appear in an image """
 </s> add     """ Sort alignments' index by the order they appear in an image in left to right order.

    Parameters
    ----------
    alignments: :class:`tools.lib_alignments.media.AlignmentData`
        The alignments data loaded from an alignments file for this rename job
    arguments: :class:`argparse.Namespace`
        The :mod:`argparse` arguments as passed in from :mod:`tools.py`
    """ </s> remove                  "multiple faces this will ensure that the left-most face is at index 0 "
                 "Optionally pass in a faces folder (-fc) to also rename extracted faces."
 </s> add                  "multiple faces this will ensure that the left-most face is at index 0." </s> remove     def _get_alignments(self):
        """ Obtain the alignments data and validate for methods which require it.

        Returns
        -------
        :class:`lib.align.Alignments`
            The alignments object pertaining to the data to be sorted. Returns ``None`` if an
            alignments file can't be found or is not required.
        """
        required_methods = ["face"]
        if self._args.sort_method not in required_methods:
            return None
        if self._args.alignments_path is None:
            path = os.path.join(self._args.input_dir, "alignments.fsa")
        else:
            path = self._args.alignments_path

        if not os.path.isfile(path):
            logger.warning("Alignments file not found at '%s'. Not using an alignments file will "
                           "lead to vastly inferior results.", path)
            logger.warning("It is highly recommended that you use an alignments file for sorting "
                           "by '%s'.", self._args.sort_method)
            return None

        return Alignments(*os.path.split(path))

 </s> add 
                 "in your set and order them appropriately."
              help="R|Sort by method. Choose how images are sorted. "
                   "\nL|'blur': Sort faces by blurriness."
                   "\nL|'face': Use VGG Face to sort by face similarity. This uses a pairwise "
                   "clustering algorithm to check the distances between 512 features on every face "
                 "in your set and order them appropriately."
                 "in your set and order them appropriately."
                   "\nL|'face-cnn': Sort faces by their landmarks. You can adjust the threshold "
                   "with the '-t' (--ref_threshold) option."
                   "\nL|'face-cnn-dissim': Like 'face-cnn' but sorts by dissimilarity."
                   "\nL|'face-yaw': Sort faces by Yaw (rotation left to right)."
                   "\nL|'hist': Sort faces by their color histogram. You can adjust the threshold "
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 
tools/sort/cli.py