Package timeside :: Module core :: Class Processor
[hide private]
[frames] | no frames]

Class Processor

source code

         object --+    
                  |    
component.Component --+
                      |
                     Processor
Known Subclasses:

Base component class of all processors


Attributes:
          parents :  List of parent Processors that must be processed
                     before the current Processor
          pipe :     The current ProcessPipe in which the Processor will run
    

Nested Classes [hide private]
  __metaclass__
Metaclass of the Processor class, used mainly for ensuring that processor id's are wellformed and unique
Instance Methods [hide private]
 
__init__(self)
x.__init__(...) initializes x; see help(type(x)) for signature
source code
 
setup(self, channels=None, samplerate=None, blocksize=None, totalframes=None)
Allocate internal resources and reset state, so that this processor is ready for a new run.
source code
 
channels(self)
Number of channels in the data returned by process().
source code
 
samplerate(self)
Samplerate of the data returned by process().
source code
 
blocksize(self)
The total number of frames that this processor can output for each step in the pipeline, or None if the number is unknown.
source code
 
totalframes(self)
The total number of frames that this processor will output, or None if the number is unknown.
source code
 
process(self, frames, eod)
Process input frames and return a (output_frames, eod) tuple.
source code
 
post_process(self)
Post-Process data after processign the input frames with process()
source code
 
release(self)
Release resources owned by this processor.
source code
 
mediainfo(self)
Information about the media object uri start duration
source code
 
uuid(self)
Return the UUID of the processor
source code
 
__del__(self) source code
 
__or__(self, other) source code

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __repr__, __setattr__, __sizeof__, __str__, __subclasshook__

Properties [hide private]

Inherited from object: __class__

Method Details [hide private]

__init__(self)
(Constructor)

source code 

x.__init__(...) initializes x; see help(type(x)) for signature

Overrides: object.__init__
(inherited documentation)

setup(self, channels=None, samplerate=None, blocksize=None, totalframes=None)

source code 

Allocate internal resources and reset state, so that this processor is ready for a new run.

The channels, samplerate and/or blocksize and/or totalframes arguments may be required by processors which accept input. An error will occur if any of these arguments is passed to an output-only processor such as a decoder.

Decorators:
  • @interfacedoc

channels(self)

source code 

Number of channels in the data returned by process(). May be different from the number of channels passed to setup()

Decorators:
  • @interfacedoc

samplerate(self)

source code 

Samplerate of the data returned by process(). May be different from the samplerate passed to setup()

Decorators:
  • @interfacedoc

blocksize(self)

source code 

The total number of frames that this processor can output for each step in the pipeline, or None if the number is unknown.

Decorators:
  • @interfacedoc

totalframes(self)

source code 

The total number of frames that this processor will output, or None if the number is unknown.

Decorators:
  • @interfacedoc

process(self, frames, eod)

source code 

Process input frames and return a (output_frames, eod) tuple. Both input and output frames are 2D numpy arrays, where columns are channels, and containing an undetermined number of frames. eod=True means that the end-of-data has been reached.

Output-only processors (such as decoders) will raise an exception if the frames argument is not None. All processors (even encoders) return data, even if that means returning the input unchanged.

Warning: it is required to call setup() before this method.

Decorators:
  • @interfacedoc

post_process(self)

source code 

Post-Process data after processign the input frames with process()

Processors such as analyzers will produce Results during the Post-Process

Decorators:
  • @interfacedoc

release(self)

source code 

Release resources owned by this processor. The processor cannot be used anymore after calling this method.

Decorators:
  • @interfacedoc

mediainfo(self)

source code 

Information about the media object uri start duration

Decorators:
  • @interfacedoc

uuid(self)

source code 

Return the UUID of the processor

Decorators:
  • @interfacedoc