ROI Configuration Guide
Version 1.1
Introduction
The Region of Interest (ROI) configuration is a critical component of the ALAS system that directly impacts the accuracy and relevance of your analysis results. This guide provides detailed instructions on how to properly configure ROIs for unprocessed videos, including best practices and troubleshooting tips.
Understanding ROIs in ALAS
What is a Region of Interest?
A Region of Interest (ROI) is a defined area within your video frame where you want the AI to detect and track specific activities. ROIs:
- Act as "virtual sensors" that detect when a person enters or exits the defined area
- Can be assigned to specific activities to track time spent on each task
- Allow the system to distinguish between different work areas in the same video
- Enable priority-based tracking when multiple activities occur simultaneously
How ROIs Work with Body Points
ALAS uses AI-powered pose detection to track specific points on the human body:
- The system tracks key body points (shoulders, hands, elbows, etc.)
- When a specified number of these points enter an ROI, the system registers activity in that area
- The minimum number of body points required can be adjusted for each ROI
- Higher point requirements increase detection precision but may miss some activity
Accessing the ROI Configuration Interface
- Navigate to the Videos section in the main menu
- Find your uploaded video in the Unprocessed Videos list
- Click on the video to open the configuration panel
- Select the ROI Configuration tab in the setup wizard
Creating Your First ROI
Step 1: Define Activities
Before creating ROIs, you need to define the activities you want to track:
- In the configuration panel, locate the Activities section
- Click Add Activity to create a new activity
- Enter a descriptive name (e.g., "Material Retrieval", "Assembly", "Inspection")
- Select a category for the activity (Value-Added, Non-Value-Added, etc.)
- Click Save
Step 2: Enter Drawing Mode
To create ROIs:
- Select an activity from your list that you want to create ROIs for
- Click the Enter Drawing Mode button
- The video preview will activate the ROI drawing interface
- A rectangular cursor will appear, indicating you're in drawing mode
Step 3: Draw the ROI
To draw a region:
- Click and hold at one corner of your desired region
- Drag the cursor to the opposite corner, forming a rectangle
- Release the mouse button to create the ROI
- The new ROI will appear highlighted on the video frame
- The ROI will be automatically assigned to the selected activity
Step 4: Configure ROI Properties
For each newly created ROI:
- In the ROI sidebar, find your new ROI in the list
- Click on it to access its properties
- Configure the following essential parameters:
- Name: Give the ROI a descriptive name (e.g., "Parts Bin", "Assembly Station")
- Min Body Points: Set the minimum number of body points (1-6) that must be in the ROI to trigger activity detection
- Priority: Assign a priority level (1-5) to handle overlapping ROIs
Advanced ROI Configuration
Setting Minimum Body Points
The "Min Body Points" setting determines how many body points must be detected within an ROI to register as activity:
- 1 Point: Most sensitive setting, may trigger with minimal presence
- 2-3 Points: Balanced setting for most applications
- 4-5 Points: Requires substantial body presence in the ROI
- 6 Points: Strictest setting, requires most of the tracked points to be in the ROI
Guidelines for choosing the right setting:
- For large work areas where the whole body is present: 3-4 points
- For smaller areas like parts bins where only hands reach: 1-2 points
- For precision work requiring sustained presence: 4-6 points
Understanding Priority Levels
Priority levels determine which activity takes precedence when a person is detected in multiple ROIs simultaneously:
- Priority ranges from 1 (lowest) to 5 (highest)
- If a person is detected in multiple ROIs, the system will credit time to the activity with the highest priority ROI
- If multiple ROIs with the same highest priority are active, time is credited to "Multiple Activities"
- When no ROIs are active, time is credited to "Indirect | Not at Workstation"
Example priority assignments:
- Core assembly tasks: Priority 5
- Material handling: Priority 3-4
- Documentation or secondary tasks: Priority 1-2
Creating Activity Rules
Activity rules allow you to define complex relationships between ROIs:
- Navigate to the Activity Rules tab
- Select an activity to create rules for
- Click Add Rule to create a new rule
- Configure the rule using the following components:
- ROI Selection: Choose which ROIs to include in the rule
- Operators: Use AND/OR operators to define relationships
- Target Activity: Select which activity to credit time to when the rule is satisfied
Rule Examples
- Simple OR Rule: "Credit time to 'Assembly' when operator is in 'Assembly Station 1' OR 'Assembly Station 2'"
- AND Rule: "Credit time to 'Material Preparation' when operator is in 'Material Storage' AND 'Cutting Tool'"
- Complex Rule: "Credit time to 'Quality Check' when operator is in 'Inspection Area' AND ('Test Equipment' OR 'Quality Documentation')"
Managing ROIs
Editing Existing ROIs
To modify an existing ROI:
- Select the activity containing the ROI
- Click the ROI from the list
- Use the properties panel to:
- Rename the ROI
- Adjust minimum body points requirement
- Change priority level
- Move the ROI to a different activity
Deleting ROIs
To remove an ROI that is no longer needed:
- Select the activity containing the ROI
- Click on the ROI from the list
- Click the Delete button (trash icon)
- Confirm deletion when prompted
Moving ROIs Between Activities
To reassign an ROI to a different activity:
- Select the activity containing the ROI
- Click on the ROI from the list
- In the properties panel, open the Activity dropdown
- Select the destination activity
- The ROI will be moved immediately
Best Practices for ROI Configuration
Optimal ROI Sizing and Placement
- Cover Complete Work Areas: Ensure ROIs completely cover the areas where activities take place
- Avoid Excessive Overlap: While some overlap is normal, excessive overlap can complicate analysis
- Consider Movement Patterns: Account for normal movement paths between stations
- Adjust for Camera Angle: Compensate for perspective distortion in your ROI placement
ROI Naming Conventions
Using consistent naming conventions improves clarity:
- Include the activity type in the name (e.g., "Assembly - Center Table")
- Use numbering for related areas (e.g., "Material Bin 1", "Material Bin 2")
- Include location references when relevant (e.g., "Assembly - Left Station")
Optimizing Detection Accuracy
- Test Different Priority Levels: Start with standard priorities and adjust based on results
- Calibrate Minimum Points: Begin with 2-3 points and increase if false positives occur
- Refine ROI Boundaries: Make small adjustments if activities are being missed
- Review First Analysis: Always review your first processed video to identify configuration issues
Troubleshooting ROI Configuration
Common Issues and Solutions
| Issue | Possible Cause | Solution |
|---|---|---|
| Activity not detected | ROI too small or poorly placed | Expand ROI size to cover the entire work area |
| False activity detection | Min body points set too low | Increase the minimum body points requirement |
| Incorrect activity attribution | Priority levels not set properly | Adjust priority levels based on importance |
Multiple activities counted simultaneously | Overlapping ROIs with same priority | Adjust priorities or create rules to handle overlap |
Activity detected but attributed incorrectly | Complex workflow not captured by ROIs | Create activity rules to define relationships |
Diagnosing ROI Problems
If your processed videos show inaccurate activity detection:
- View the processed video with ROI visualization enabled
- Note timestamps where activities are incorrectly detected or missed
- Review the ROI configuration for those areas
- Consider these common adjustments:
- Resize or reposition ROIs to better match actual work areas
- Adjust minimum body point requirements
- Refine priority levels
- Create more specific activity rules
Advanced Techniques
Activity Flow Mapping
For complex workflows, consider mapping the entire activity flow:
- Create a diagram of all work areas and movement paths
- Define logical groups of related activities
- Assign ROIs and priorities that reflect the natural workflow
- Create rules that capture transitions between activities
Working with Multiple Operators
When tracking multiple operators in the same video:
- Create separate ROIs for each operator's work area
- Use higher minimum body point settings to reduce false detections
- Consider using activity rules to handle areas shared by multiple operators
Handling Complex Workspaces
In densely packed workspaces:
- Use smaller, more precisely defined ROIs
- Implement higher priority differences between adjacent areas
- Create more complex rules to accurately capture activity relationships
- Consider using manual timestamps for highly complex scenarios
Conclusion
Proper ROI configuration is essential for accurate labor analysis results. Take the time to carefully design your ROIs, test and refine them based on results, and leverage the advanced features like priority levels and activity rules to capture the true complexity of your work environment.
For additional assistance with ROI configuration, contact our support team through the in-app support feature.
Remember: The goal of ROI configuration is to create a digital model that accurately reflects how work is performed in the physical space. Consider the natural workflow and activity relationships when designing your configuration.