TiffTagRegistry

final class tifffile.TiffTagRegistry(arg, /)

Registry of TIFF tag codes and names.

Map tag codes and names to names and codes respectively. One tag code may be registered with several names, for example, 34853 is used for GPSTag or OlympusSIS2. Different tag codes may be registered with the same name, for example, 37387 and 41483 are both named FlashEnergy.

Parameters:

arg (TiffTagRegistry | dict[int, str] | Sequence[tuple[int, str]]) – Mapping of codes to names.

Examples

>>> tags = TiffTagRegistry([(34853, 'GPSTag'), (34853, 'OlympusSIS2')])
>>> tags.add(37387, 'FlashEnergy')
>>> tags.add(41483, 'FlashEnergy')
>>> tags['GPSTag']
34853
>>> tags[34853]
'GPSTag'
>>> tags.getall(34853)
['GPSTag', 'OlympusSIS2']
>>> tags.getall('FlashEnergy')
[37387, 41483]
>>> len(tags)
4
update(arg, /)

Add mapping of codes to names to registry.

Parameters:

arg (TiffTagRegistry | dict[int, str] | Sequence[tuple[int, str]]) – Mapping of codes to names.

Return type:

None

add(code, name, /)

Add code and name to registry.

Parameters:
  • code (int)

  • name (str)

Return type:

None

items()

Return all registry items as (code, name).

Return type:

list[tuple[int, str]]

get(key: int, /, default: None) str | None
get(key: str, /, default: None) int | None
get(key: int, /, default: str) str

Return first code or name if exists, else default.

Parameters:
  • key – tag code or name to lookup.

  • default – value to return if key is not found.

getall(key: int, /, default: None) list[str] | None
getall(key: str, /, default: None) list[int] | None
getall(key: int, /, default: list[str]) list[str]

Return list of all codes or names if exists, else default.

Parameters:
  • key – tag code or name to lookup.

  • default – value to return if key is not found.