<< return to Pixycam.com

User Tools

Site Tools


wiki:v2:ccc_pixymon

**This is an old revision of the document!**

Color connected components program

This program is a hue-based object detection algorithm. More information about the CCC program can be found here.

Color connected components Tuning tab

This tab contains all of the most effective parameters for “tuning” the accuracy of color signatures. To bring up this tab, you must be running the color_connected_components program by selecting it in the Program menu, and then bringing up the Configure Dialog (click on the gear icon or select File➜Configure). Now select the Tuning tab under Pixy Parameters (it should be the first pane you see when you bring up the Configure Dialog.)

  • Signature ranges: Signature range tuning is probably the most effective method to improve detection accuracy. Each color signature (1 through 7) has a slider to adjust the inclusiveness of the corresponding signature. Slide the slider to the left if you want the signature to be less inclusive (you're seeing false positives) or slide it to the right if you want the signature to be more inclusive (you're getting false negatives.) There is more information here.
  • Min brightness: sets a minimum brightness setting for all signatures. That is, if a pixel is below the minimum brightness setting, it won't be considered as part of any color signature. So if you are seeing false positives that are sufficiently dark, you can adjust the Min brightness setting higher to reduce the false positives. If you are not able to detect objects that are sufficiently dark, you can adjust the Min brightness setting lower to reduce the false negatives
2018/06/06 02:09 · pixycam
  • Camera brightness: This parameter is in all Tuning tabs regardless of the program that's being run. It sets the exposure setting of Pixy, which controls the brightness of the image. The Camera Brightness setting is important because the correct exposure setting will lead to the best detection accuracy.
2018/06/05 19:43 · pixycam
2018/06/05 16:55 · pixycam

Color connected components Expert tab

This tab contains more advanced parameters for adjusting various color connected components things. To bring up this tab, you must be running the color_connected_components program by selecting it in the Program menu, and then bringing up the Configure Dialog (click on the gear icon or select File➜Configure). Now select the Expert tab under Pixy Parameters.

  • Block filtering: Increasing this parameter increases the amount of filtering Pixy2 applies to the detection of each block. Increasing this parameter can reduce the false positive detections, but will also increase the amount of time it takes between the object appearing in the frame and it being reported by Pixy2.
  • Max tracking velocity: This parameter sets the maximum distance a detected object can travel between frames. In other words, objects that exceed this velocity will be considered invalid. Decreasing this parameter can reduce the false positive detections, especially if you don't expect your detected objects to move very much from frame to frame. The value is specified in pixels per frame period (16.7 milliseconds).
  • Max blocks: This parameter sets maximum total number of blocks (objects) Pixy2 will report per frame. For example, if you set this parameter to 2, Pixy2 will report a maximum of 2 objects (the 2 largest objects) regardless of which signature the blocks belong to, and all other detected objects will not be reported.
  • Max blocks per signature: This parameter sets the maximum number of blocks (objects) Pixy2 will report per signature, per frame. For example, if you set this parameter to 2, Pixy2 will report a maximum of 2 objects for each signature (the largest objects in the frame) and all other detected objects with that signature will not be reported.
  • Max merge dist: Pixy2 will combine objects that have the same signature and are sufficiently close together in the frame. This parameter adjusts this distance. Increasing this parameter will result in Pixy2 merging more detected blocks together into a single block.
  • * Min block area: sets the minimum area of reported blocks. If a detected block has a smaller area, it will not be reported. For this purpose, area of a block is calculated as width * height.
  • LED brightness: sets the brightness of Pixy2's RGB LED. Pixy2's LED is quite bright if you want it to be (too bright to look at!)
  • Signature teach threshold: This parameter applies when you are teaching Pixy2 a signature using the button-push method. It allows you to adjust how inclusive Pixy2 is when determining which pixels are part of the object you are trying to teach it. You can find more information here.
  • Color code mode: This parameter sets the behavior of color codes, including enabling/disabling. Options include:
    • Enabled: Color codes are enabled, normal mode.
    • Disabled: Color codes are disabled.
    • Color codes only: Only color codes are reported. Objects that match non-color-code signatures will not be reported.
    • Mixed: This is the same as normal color code mode, but Pixy2 will also report color-code signatures that aren't part of color codes. (Normally, Pixy2 only reports color-code signatures that are part of color codes – 2 or more color-code signatures that are close together.)
  • Default program: This parameter shows up in all Expert tabs regardless of the program that's currently running. It sets the program that gets executed upon power-up. The available programs are listed in the pulldown menu.
  • Program select on power-up: This parameter shows up in all Expert tabs regardless of the program that's currently running. Enabling this will enable the button program selection upon power-up.
  • Debug: This parameter shows up in all Expert tabs regardless of the program that's currently running. It sets the debug level within Pixy2. Setting the value to 0 means that no debugging information is displayed.
2018/06/05 18:56 · pixycam
2018/06/06 17:04 · pixycam
2018/06/05 17:55 · pixycam
wiki/v2/ccc_pixymon.1528309548.txt.gz · Last modified: 2018/06/06 18:25 by pixycam