pliers.transformers.GoogleVisionAPITransformer

class pliers.transformers.GoogleVisionAPITransformer(discovery_file=None, api_version='v1', max_results=100, num_retries=3, rate_limit=None, batch_size=None)

Bases: GoogleAPITransformer, BatchTransformerMixin

Base class for transformers using the Google Vision API.

Parameters

• discovery_file (str) – path to discovery file containing Google application credentials.

• api_version (str) – API version to use.

• max_results (int) – Max number of results per page.

• num_retries (int) – Number of times to retry query on failure.

• rate_limit (int) – The minimum number of seconds required between transform calls on this Transformer.

• batch_size (int) – Number of stims to send per batched API request.

__init__(discovery_file=None, api_version='v1', max_results=100, num_retries=3, rate_limit=None, batch_size=None)

transform(stims, validation='strict', *args, **kwargs)

Executes the transformation on the passed stim(s).

Parameters

• stims (str, Stim, list) –

  One or more stimuli to process. Must be one of:

  • A string giving the path to a file that can be read in as a Stim (e.g., a .txt file, .jpg image, etc.)

  • A Stim instance of any type.

  • An iterable of stims, where each element is either a string or a Stim.

• validation (str) –

  String specifying how validation errors should be handled. Must be one of:

  • ’strict’: Raise an exception on any validation error

  • ’warn’: Issue a warning for all validation errors

  • ’loose’: Silently ignore all validation errors

• args – Optional positional arguments to pass onto the internal _transform call.

• kwargs – Optional positional arguments to pass onto the internal _transform call.