Image Functions#

Here are some functions to help the manipulation of image data.

read_image(folder: Union[pathlib.Path, List[pathlib.Path]], resize: Optional[Tuple[int, int]] = None, handle_errors: str = 'ignore', id_pattern: Optional[str] = None, extensions: List = ['.png', '.jpg', '.jpeg'])#

Function to read images from folder and transform to a format compatible to jai.

Must pass the folder of the images or a list of paths for each image.

Parameters
  • folder (str or Path, optional) – Path for the images folder. The default is None.

  • new_size (Tuple of int, optional) – New shape to resize images. The default is None.

  • handle_errors (str, optional) – Whether to ignore errors and skipped files. If “ignore”, could probably result in a internal error later on. The default is “ignore”.

  • id_pattern (str, optional) – regex string to find id value. The default is None.

  • extensions (List, optional) – List of acceptable extensions. The default is [“.png”, “.jpg”, “.jpeg”].

Raises

ValueError – If not passed a image folder or list of images.

Returns

Pandas Dataframe with acceptable format for jai usage.

Return type

pd.Dataframe

Example

>>> from jai.utilities import read_image
...
>>> df = read_image(folder_path)