{ "__type": "IngestedDoc", "__tag": 4010, "_content": { "Notes": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "When extracting those features in parallel, be aware that the choice of the backend (i.e., multiprocessing vs threading) will have an impact on the performance. The rule of thumb is as follows: use multiprocessing when extracting features for all possible ROI in an image; use threading when extracting the feature at specific location for a limited number of ROIs. Refer to the example " }, { "__type": "InlineRole", "__tag": 4003, "value": "sphx_glr_auto_examples_applications_plot_haar_extraction_selection_classification.py", "domain": null, "role": "ref", "inventory": null }, { "__type": "Text", "__tag": 4046, "value": " for more insights." } ] } ], "title": [], "level": 0, "target": null }, "Warns": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Raises": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Yields": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Methods": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Returns": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Parameters", "__tag": 4026, "children": [ { "__type": "DocParam", "__tag": 4016, "name": "haar_features", "annotation": "ndarray of shape (n_features,) and dtype (int or float)", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Resulting Haar-like features. Each value is equal to the subtraction of sums of the positive and negative rectangles. The data type depends of the data type of " }, { "__type": "ParamRef", "__tag": 4071, "name": "int_image" }, { "__type": "Text", "__tag": 4046, "value": ": " }, { "__type": "InlineRole", "__tag": 4003, "value": "int", "domain": null, "role": null, "inventory": null }, { "__type": "Text", "__tag": 4046, "value": " when the data type of " }, { "__type": "ParamRef", "__tag": 4071, "name": "int_image" }, { "__type": "Text", "__tag": 4046, "value": " is " }, { "__type": "InlineRole", "__tag": 4003, "value": "uint", "domain": null, "role": null, "inventory": null }, { "__type": "Text", "__tag": 4046, "value": " or " }, { "__type": "InlineRole", "__tag": 4003, "value": "int", "domain": null, "role": null, "inventory": null }, { "__type": "Text", "__tag": 4046, "value": " and " }, { "__type": "InlineRole", "__tag": 4003, "value": "float", "domain": null, "role": null, "inventory": null }, { "__type": "Text", "__tag": 4046, "value": " when the data type of " }, { "__type": "ParamRef", "__tag": 4071, "name": "int_image" }, { "__type": "Text", "__tag": 4046, "value": " is " }, { "__type": "InlineRole", "__tag": 4003, "value": "float", "domain": null, "role": null, "inventory": null }, { "__type": "Text", "__tag": 4046, "value": "." } ] } ] } ] } ], "title": [], "level": 0, "target": null }, "Summary": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Compute the Haar-like features for a region of interest (ROI) of an integral image." } ] } ], "title": [], "level": 0, "target": null }, "Receives": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Warnings": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Attributes": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null }, "Parameters": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Parameters", "__tag": 4026, "children": [ { "__type": "DocParam", "__tag": 4016, "name": "int_image", "annotation": "ndarray of shape (M, N)", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Integral image for which the features need to be computed." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "r", "annotation": "int", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Row-coordinate of top left corner of the detection window." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "c", "annotation": "int", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Column-coordinate of top left corner of the detection window." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "width", "annotation": "int", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Width of the detection window." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "height", "annotation": "int", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Height of the detection window." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "feature_type", "annotation": "str or list of str or None, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The type of feature to consider:" } ] }, { "__type": "BulletList", "__tag": 4053, "ordered": false, "start": 1, "children": [ { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "'type-2-x': 2 rectangles varying along the x axis;" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "'type-2-y': 2 rectangles varying along the y axis;" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "'type-3-x': 3 rectangles varying along the x axis;" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "'type-3-y': 3 rectangles varying along the y axis;" } ] } ] }, { "__type": "ListItem", "__tag": 4054, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "'type-4': 4 rectangles varying along x and y axis." } ] } ] } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "By default all features are extracted." } ] }, { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "If using with " }, { "__type": "ParamRef", "__tag": 4071, "name": "feature_coord" }, { "__type": "Text", "__tag": 4046, "value": ", it should correspond to the feature type of each associated coordinate feature." } ] } ] }, { "__type": "DocParam", "__tag": 4016, "name": "feature_coord", "annotation": "ndarray of list of tuples or None, optional", "desc": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "The array of coordinates to be extracted. This is useful when you want to recompute only a subset of features. In this case " }, { "__type": "ParamRef", "__tag": 4071, "name": "feature_type" }, { "__type": "Text", "__tag": 4046, "value": " needs to be an array containing the type of each feature, as returned by " }, { "__type": "CrossRef", "__tag": 4002, "value": "haar_like_feature_coord", "reference": { "__type": "LocalRef", "__tag": 4022, "kind": "module", "path": "skimage.feature.haar:haar_like_feature_coord" }, "kind": "module" }, { "__type": "Text", "__tag": 4046, "value": ". By default, all coordinates are computed." } ] } ] } ] } ], "title": [], "level": 0, "target": null }, "Extended Summary": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Paragraph", "__tag": 4045, "children": [ { "__type": "Text", "__tag": 4046, "value": "Haar-like features have been successfully used for image classification and object detection " }, { "__type": "FootnoteReference", "__tag": 4066, "label": "1" }, { "__type": "Text", "__tag": 4046, "value": ". It has been used for real-time face detection algorithm proposed in " }, { "__type": "FootnoteReference", "__tag": 4066, "label": "2" }, { "__type": "Text", "__tag": 4046, "value": "." } ] } ], "title": [], "level": 0, "target": null }, "Other Parameters": { "__type": "Section", "__tag": 4015, "children": [], "title": [], "level": 0, "target": null } }, "_ordered_sections": [ "Summary", "Extended Summary", "Parameters", "Returns", "Yields", "Receives", "Raises", "Warns", "Other Parameters", "Attributes", "Methods", "Notes", "Warnings" ], "item_file": "/dev/scikit-image/src/skimage/feature/haar.py", "item_line": 86, "item_type": "function", "aliases": [ "skimage.feature.haar_like_feature" ], "example_section_data": { "__type": "Section", "__tag": 4015, "children": [ { "__type": "Code", "__tag": 4050, "value": "import numpy as np\nfrom skimage.transform import integral_image\nfrom skimage.feature import haar_like_feature\nimg = np.ones((5, 5), dtype=np.uint8)\nimg_ii = integral_image(img)\nfeature = haar_like_feature(img_ii, 0, 0, 5, 5, 'type-3-x')\nfeature\n", "execution_status": "success" }, { "__type": "Text", "__tag": 4046, "value": "\nYou can compute the feature for some pre-computed coordinates.\n\n" }, { "__type": "Code", "__tag": 4050, "value": "from skimage.feature import haar_like_feature_coord\nfeature_coord, feature_type = zip(\n *[haar_like_feature_coord(5, 5, feat_t)\n for feat_t in ('type-2-x', 'type-3-x')])\nfeature_coord = np.concatenate([x[::2] for x in feature_coord])\nfeature_type = np.concatenate([x[::2] for x in feature_type])\nfeature = haar_like_feature(img_ii, 0, 0, 5, 5,\n feature_type=feature_type,\n feature_coord=feature_coord)\nfeature\n", "execution_status": "success" } ], "title": [], "level": 0, "target": null }, "see_also": [], "signature": { "__type": "SignatureNode", "__tag": 4029, "kind": "function", "parameters": [ { "__type": "SigParam", "__tag": 4030, "name": "int_image", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "r", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "c", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "width", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "height", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": { "__type": "Empty", "__tag": 4031 } }, { "__type": "SigParam", "__tag": 4030, "name": "feature_type", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": "None" }, { "__type": "SigParam", "__tag": 4030, "name": "feature_coord", "annotation": { "__type": "Empty", "__tag": 4031 }, "kind": "POSITIONAL_OR_KEYWORD", "default": "None" } ], "return_annotation": { "__type": "Empty", "__tag": 4031 }, "target_name": "haar_like_feature" }, "references": [ ".. [1] https://en.wikipedia.org/wiki/Haar-like_feature", ".. [2] Oren, M., Papageorgiou, C., Sinha, P., Osuna, E., & Poggio, T.", " (1997, June). Pedestrian detection using wavelet templates.", " In Computer Vision and Pattern Recognition, 1997. Proceedings.,", " 1997 IEEE Computer Society Conference on (pp. 193-199). IEEE.", " http://tinyurl.com/y6ulxfta", " :DOI:`10.1109/CVPR.1997.609319`", ".. [3] Viola, Paul, and Michael J. Jones. \"Robust real-time face", " detection.\" International journal of computer vision 57.2", " (2004): 137-154.", " https://www.merl.com/publications/docs/TR2004-043.pdf", " :DOI:`10.1109/CVPR.2001.990517`" ], "qa": "skimage.feature.haar:haar_like_feature", "arbitrary": [], "local_refs": [ "c", "feature_coord", "feature_type", "haar_features", "height", "int_image", "r", "width" ] }