openvino.runtime.opset2.prior_box

openvino.runtime.opset2.prior_box(layer_shape: openvino._pyopenvino.Node, image_shape: Union[openvino._pyopenvino.Node, int, float, numpy.ndarray], attrs: dict, name: Optional[str] = None) → openvino._pyopenvino.Node

Generate prior boxes of specified sizes and aspect ratios across all dimensions.

Parameters

• layer_shape – Shape of layer for which prior boxes are computed.

• image_shape – Shape of image to which prior boxes are scaled.

• attrs – The dictionary containing key, value pairs for attributes.

• name – Optional name for the output node.

Returns

Node representing prior box operation.

Available attributes are:

• min_size The minimum box size (in pixels).

  Range of values: positive floating point numbers Default value: [] Required: no

• max_size The maximum box size (in pixels).

  Range of values: positive floating point numbers Default value: [] Required: no

• aspect_ratio Aspect ratios of prior boxes.

  Range of values: set of positive floating point numbers Default value: [] Required: no

• flip The flag that denotes that each aspect_ratio is duplicated and flipped.

  Range of values: {True, False} Default value: False Required: no

• clip The flag that denotes if each value in the output tensor should be clipped

  to [0,1] interval. Range of values: {True, False} Default value: False Required: no

• step The distance between box centers.

  Range of values: floating point non-negative number Default value: 0 Required: no

• offset This is a shift of box respectively to top left corner.

  Range of values: floating point non-negative number Default value: None Required: yes

• variance The variance denotes a variance of adjusting bounding boxes. The attribute

  could contain 0, 1 or 4 elements. Range of values: floating point positive numbers Default value: [] Required: no

• scale_all_sizes The flag that denotes type of inference.

  Range of values: False - max_size is ignored

  True - max_size is used

  Default value: True Required: no

• fixed_ratio This is an aspect ratio of a box.

  Range of values: a list of positive floating-point numbers Default value: None Required: no

• fixed_size This is an initial box size (in pixels).

  Range of values: a list of positive floating-point numbers Default value: None Required: no

• density This is the square root of the number of boxes of each type.

  Range of values: a list of positive floating-point numbers Default value: None Required: no

Example of attribute dictionary:

# just required ones
attrs = {
    'offset': 85,
}

attrs = {
    'offset': 85,
    'flip': True,
    'clip': True,
    'fixed_size': [32, 64, 128]
}

Optional attributes which are absent from dictionary will be set with corresponding default.