关于 progress-monitoring-cv
面向施工团队的计算机视觉技能,可分析现场图像并跟踪工程进度与计划的差异,涵盖安全、质量、BIM 对比及连续图像分析。
主要功能
- 01识别施工阶段
- 02估算工程完成比例
- 03检查 PPE 与防护栏
- 04检测质量问题
- 05对比竣工实况与 BIM
- 06分析延时图像进度
适用场景
- 01根据现场照片估算完成度
- 02检查 PPE 与防护栏合规性
- 03将已建结构与 BIM 对比
- 04跟踪不同日期图像的变化
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ datadrivenconstruction/ ddc_skills_for_ai_agents_in_construction --skill progress-monitoring-cv安装后在 Claude Code 中输入/progress-monitoring-cv确认已加载。
附带文件claw.jsoninstructions.md
详细介绍
使用计算机视觉监测进度
概述
此技能运用计算机视觉监测施工进度。自动分析现场图像,以跟踪完工情况、检测危险并将实际进度与计划工作进行比较。
应用场景:
- 估算进度百分比
- 检测安全合规情况(PPE、防护栏)
- 对比竣工情况与 BIM
- 跟踪材料和设备
- 检测质量缺陷
快速入门
import cv2
import numpy as np
from PIL import Image
import torch
from torchvision import models, transforms
# Load pre-trained model for construction scene analysis
model = models.resnet50(pretrained=True)
model.eval()
# Preprocess image
transform = transforms.Compose([
transforms.Resize(256),
transforms.CenterCrop(224),
transforms.ToTensor(),
transforms.Normalize(mean=[0.485, 0.456, 0.406],
std=[0.229, 0.224, 0.225])
])
# Load site photo
img = Image.open("site_photo.jpg")
input_tensor = transform(img).unsqueeze(0)
# Analyze
with torch.no_grad():
output = model(input_tensor)
print("Image analyzed successfully")
进度检测系统
核心进度分析器
import cv2
import numpy as np
from PIL import Image
from typing import Dict, List, Tuple, Optional
from dataclasses import dataclass
from enum import Enum
import torch
from torchvision import models, transforms
from torchvision.models.detection import fasterrcnn_resnet50_fpn
class ConstructionPhase(Enum):
EXCAVATION = "excavation"
FOUNDATION = "foundation"
STRUCTURE = "structure"
ENCLOSURE = "enclosure"
MEP_ROUGH = "mep_rough"
FINISHES = "finishes"
COMPLETE = "complete"
@dataclass
class ProgressReport:
timestamp: str
image_path: str
detected_phase: ConstructionPhase
estimated_progress: float
detected_elements: List[Dict]
safety_observations: List[Dict]
quality_issues: List[Dict]
comparison_to_plan: Optional[float]
class ConstructionProgressAnalyzer:
"""Analyze construction progress from images"""
def __init__(self, use_gpu: bool = True):
self.device = torch.device('cuda' if use_gpu and torch.cuda.is_available() else 'cpu')
# Load detection model
self.detector = fasterrcnn_resnet50_fpn(pretrained=True)
self.detector.to(self.device)
self.detector.eval()
# Image transform
self.transform = transforms.Compose([
transforms.ToTensor()
])
# Construction element labels (would need fine-tuned model in production)
self.construction_labels = {
'column': ['column', 'pillar', 'post'],
'beam': ['beam', 'girder'],
'slab': ['floor', 'slab', 'deck'],
'wall': ['wall', 'partition'],
'scaffold': ['scaffold', 'scaffolding'],
'crane': ['crane', 'tower crane'],
'equipment': ['excavator', 'loader', 'truck'],
'worker': ['person', 'worker']
}
def analyze_image(self, image_path: str) -> ProgressReport:
"""Analyze a single construction site image"""
# Load image
img = Image.open(image_path).convert('RGB')
img_tensor = self.transform(img).to(self.device)
# Run detection
with torch.no_grad():
predictions = self.detector([img_tensor])
# Process detections
detected_elements = self._process_detections(predictions[0])
# Estimate phase and progress
phase = self._estimate_phase(detected_elements, img)
progress = self._estimate_progress(phase, detected_elements)
# Safety analysis
safety_obs = self._analyze_safety(img, detected_elements)
# Quality check (simplified)
quality_issues = self._check_quality(img)
return ProgressReport(
timestamp=self._get_timestamp(),
image_path=image_path,
detected_phase=phase,
estimated_progress=progress,
detected_elements=detected_elements,
safety_observations=safety_obs,
quality_issues=quality_issues,
comparison_to_plan=None
)
def _process_detections(self, predictions: Dict) -> List[Dict]:
"""Process model predictions into detected elements"""
elements = []
boxes = predictions['boxes'].cpu().numpy()
labels = predictions['labels'].cpu().numpy()
scores = predictions['scores'].cpu().numpy()
for box, label, score in zip(boxes, labels, scores):
if score > 0.5: # Confidence threshold
elements.append({
'box': box.tolist(),
'label': label,
'score': float(score),
'area': (box[2] - box[0]) * (box[3] - box[1])
})
return elements
def _estimate_phase(self, elements: List[Dict], img: Image) -> ConstructionPhase:
"""Estimate construction phase from detected elements"""
# Convert to numpy for color analysis
img_array = np.array(img)
# Color-based phase estimation (simplified)
hsv = cv2.cvtColor(img_array, cv2.COLOR_RGB2HSV)
# Brown/earth tones indicate excavation
earth_mask = cv2.inRange(hsv, (10, 50, 50), (30, 255, 255))
earth_ratio = np.sum(earth_mask > 0) / earth_mask.size
# Gray tones indicate concrete
gray_mask = cv2.inRange(hsv, (0, 0, 50), (180, 50, 200))
gray_ratio = np.sum(gray_mask > 0) / gray_mask.size
# Steel colors
steel_mask = cv2.inRange(hsv, (0, 0, 100), (180, 30, 255))
steel_ratio = np.sum(steel_mask > 0) / steel_mask.size
# Simple phase logic
if earth_ratio > 0.3:
return ConstructionPhase.EXCAVATION
elif gray_ratio > 0.2 and steel_ratio < 0.1:
return ConstructionPhase.FOUNDATION
elif steel_ratio > 0.1:
return ConstructionPhase.STRUCTURE
else:
return ConstructionPhase.ENCLOSURE
def _estimate_progress(self, phase: ConstructionPhase,
elements: List[Dict]) -> float:
"""Estimate progress percentage within phase"""
phase_base_progress = {
ConstructionPhase.EXCAVATION: 5,
ConstructionPhase.FOUNDATION: 15,
ConstructionPhase.STRUCTURE: 35,
ConstructionPhase.ENCLOSURE: 60,
ConstructionPhase.MEP_ROUGH: 75,
ConstructionPhase.FINISHES: 90,
ConstructionPhase.COMPLETE: 100
}
base = phase_base_progress.get(phase, 0)
# Adjust based on detected elements
element_count = len(elements)
adjustment = min(element_count * 0.5, 10)
return min(base + adjustment, 100)
def _analyze_safety(self, img: Image, elements: List[Dict]) -> List[Dict]:
"""Analyze safety compliance"""
observations = []
img_array = np.array(img)
# Check for safety vest colors (orange, yellow, green)
hsv = cv2.cvtColor(img_array, cv2.COLOR_RGB2HSV)
# Orange vest detection
orange_mask = cv2.inRange(hsv, (10, 100, 100), (25, 255, 255))
orange_pixels = np.sum(orange_mask > 0)
# Yellow vest detection
yellow_mask = cv2.inRange(hsv, (25, 100, 100), (35, 255, 255))
yellow_pixels = np.sum(yellow_mask > 0)
if orange_pixels + yellow_pixels < 100: # Threshold
observations.append({
'type': 'PPE_VISIBILITY',
'severity': 'Medium',
'message': 'Limited high-visibility clothing detected'
})
# Check for workers detected
worker_count = sum(1 for e in elements if e.get('label') == 1)
if worker_count > 0:
observations.append({
'type': 'WORKER_COUNT',
'severity': 'Info',
'message': f'{worker_count} workers detected on site'
})
return observations
def _check_quality(self, img: Image) -> List[Dict]:
"""Check for visible quality issues"""
issues = []
img_array = np.array(img)
# Edge detection for irregularities
gray = cv2.cvtColor(img_array, cv2.COLOR_RGB2GRAY)
edges = cv2.Canny(gray, 50, 150)
# High edge density might indicate messy work or issues
edge_density = np.sum(edges > 0) / edges.size
if edge_density > 0.3:
issues.append({
'type': 'VISUAL_COMPLEXITY',
'severity': 'Low',
'message': 'High visual complexity - manual review recommended'
})
return issues
def _get_timestamp(self) -> str:
from datetime import datetime
return datetime.now().isoformat()
def compare_to_bim(self, image_path: str, bim_render_path: str) -> float:
"""Compare site photo to BIM rendering"""
site_img = cv2.imread(image_path)
bim_img = cv2.imread(bim_render_path)
# Resize to same dimensions
target_size = (800, 600)
site_img = cv2.resize(site_img, target_size)
bim_img = cv2.resize(bim_img, target_size)
# Convert to grayscale
site_gray = cv2.cvtColor(site_img, cv2.COLOR_BGR2GRAY)
bim_gray = cv2.cvtColor(bim_img, cv2.COLOR_BGR2GRAY)
# Calculate structural similarity
from skimage.metrics import structural_similarity
similarity, _ = structural_similarity(site_gray, bim_gray, full=True)
return similarity
def batch_analyze(self, image_paths: List[str]) -> List[ProgressReport]:
"""Analyze multiple images"""
return [self.analyze_image(path) for path in image_paths]
延时摄影分析
class TimeLapseAnalyzer:
"""Analyze construction progress over time from image series"""
def __init__(self, analyzer: ConstructionProgressAnalyzer):
self.analyzer = analyzer
self.reports: List[ProgressReport] = []
def add_image(self, image_path: str, date: str):
"""Add image to time series"""
report = self.analyzer.analyze_image(image_path)
report.timestamp = date
self.reports.append(report)
def get_progress_curve(self) -> pd.DataFrame:
"""Generate progress curve from analyzed images"""
data = [{
'date': r.timestamp,
'phase': r.detected_phase.value,
'progress': r.estimated_progress,
'element_count': len(r.detected_elements)
} for r in self.reports]
return pd.DataFrame(data).sort_values('date')
def detect_delays(self, planned_progress: pd.DataFrame) -> List[Dict]:
"""Compare actual vs planned progress"""
actual = self.get_progress_curve()
delays = []
for _, row in actual.iterrows():
planned_row = planned_progress[
planned_progress['date'] == row['date']
]
if not planned_row.empty:
planned_pct = planned_row.iloc[0]['progress']
actual_pct = row['progress']
if actual_pct < planned_pct - 5: # 5% tolerance
delays.append({
'date': row['date'],
'planned': planned_pct,
'actual': actual_pct,
'delay_pct': planned_pct - actual_pct
})
return delays
def generate_report(self, output_path: str):
"""Generate progress monitoring report"""
progress_df = self.get_progress_curve()
with pd.ExcelWriter(output_path, engine='openpyxl') as writer:
progress_df.to_excel(writer, sheet_name='Progress', index=False)
# Safety observations
safety_data = []
for r in self.reports:
for obs in r.safety_observations:
safety_data.append({
'Date': r.timestamp,
'Type': obs['type'],
'Severity': obs['severity'],
'Message': obs['message']
})
if safety_data:
pd.DataFrame(safety_data).to_excel(
writer, sheet_name='Safety', index=False
)
return output_path
快速参考
| 分析类型 | 方法 | 输出 |
|---|---|---|
| 阶段检测 | 颜色分析 + 目标检测 | 施工阶段 |
| 进度百分比 | 构件计数 + 阶段基准 | 完工百分比 |
| 安全检查 | 颜色检测(PPE)+ 工人计数 | 安全观察结果 |
| 质量检查 | 边缘检测 + 异常检测 | 质量问题 |
| BIM 对比 | 结构相似性 | 相似度评分 |
资源
- OpenCV:https://opencv.org
- PyTorch:https://pytorch.org
- YOLO:https://ultralytics.com/yolov8
- DDC Website:https://datadrivenconstruction.io
后续步骤
- 参阅
4d-simulation了解进度计划对比 - 参阅
data-visualization了解进度仪表板 - 参阅
risk-assessment-ml了解延期预测
评论
支持 Markdown