Release notes

0.0.12

• 2026-01-12
  • 난공사 과제 (cctv_height)
    • [기능 수정]
      • torch depth 모델도 사용 가능하도록 변경
        • onnx depth 모델은 800x800 이미지만 입력받을 수 있어서 실거리측정 데이터셋 사용이 불가능
        • torch depth 모델은 이미지 크기 상관없이 사용 가능. torch depth 모델은 아래 경로 사용
        • /NFS/database_personal/ktt/release/resource/cctv_height/2_0_0/2_0_0.saigedepth
    • [버그 수정]
      • infer API에서 부적합 결과일 때 compliance_violation_detected 필드 값이 None이 아닌 boolean이 되도록 수정

0.0.11

• 2026-01-08
  • 난공사 과제 (cctv_height)
    • [버그 수정]
      • ladder_box 타입 불일치 문제 해결
    • [기타]
      • 엔진 빌드 시, depth_checkpoint_path=None일 경우 다운로드한 사전학습 모델 사용

0.0.10

• 2026-01-07
  • 난공사 과제 (cctv_height)
    • [모델 배포]
      • 모델 개선
        • saige detection : /NFS/database_personal/ktt/release/resource/cctv_height/2_0_2/2_0_2.saigedet
    • [기능 수정]
      • infer API output에 compliance_violation_detected boolean 필드 추가
        • 부적합 여부 판단 결과. True=부적합, False=적합
        • 부적합 사유에 INCOMPLETE_LADDER_VISIBILITY만 존재하는 경우, 적합으로 판단하되 부적합 사유는 그대로 표기 필요
        • 자세한 내용은 API reference 참고
      • detection 모델 inference option 수정
    • [기능 개선]
      • 속도 최적화
        • Depth 모델에 ONNX 최적화 적용 (최초실행시 최적화 과정 수행)
        • Postprocess 최적화 적용 (GPU 연산 증가)
      • 지면 탐지 개선
        • 기존: 사다리 bbox 하단 중심점만 사용
        • 변경: 사다리 bbox 하단 일부 영역(하단 20% 등)을 활용하여 지면 탐지
      • CCTV-지면 거리 계산 방식 개선
        • 기존: CCTV와 추론 지면을 잇는 수선을 이용해 거리 계산
        • 변경: 윗방향 surface normal의 평균을 활용한 거리 계산 방식으로 개선
    • [기타]
      • 사용하지 않는 grounding detection, safety detection 관련 코드 및 리소스 제거
  • 시방준수 과제 (install_compliance)
    • [모델 배포]
      • 모델 개선
        • saige detection : /NFS/database_personal/ktt/release/resource/install_compliance/0_0_1/0_0_1.saigedet
        • multi-label classification : /NFS/database_personal/ktt/release/resource/install_compliance/0_0_1/0_0_1.saigecls
    • [기능 추가]
      • compliance_inferencer의 params.area_threshold inference option 추가
        • detection의 params.object_area_threshold이 1차 필터링 수행 (기본값 100)
        • 이후 compliance_inferencer의 params.area_threshold로 각 bbox마다 connector_too_small 판단 (기본값 1000)
      • connector_too_small status 추가
        • bbox의 크기가 일정 수준 이하(현재 1000 pixel)인 경우, compliance_status_list에 connector_too_small status를 추가
        • 모든 bbox의 크기가 일정 수준 이하인 경우에만 compliance_violation_detected == True가 되어 부적합으로 처리
        • connector_too_small인 bbox는 테스트 UI에서 별도의 색상으로 표기 필요

0.0.9

• 2025-12-11
  • 난공사 과제 (cctv_height)
    • [모델 배포]
      • Detection 모델 개선
        • saige detection : /NFS/database_personal/ktt/release/resource/cctv_height/2_0_1/2_0_1.saigedet
    • [버그 수정]
      • 후처리 파라미터 수정
        • 이미지 좌우 외곽 사다리 무시 영역 확장
        • 이미지 하단 외곽 사다리 무시 영역 축소 (하단 4픽셀 기준으로 변경)
      • infer 메소드 사용시 발생하는 onnx runtime 경고 수정
      • saige detection 사용시 inference option 적용 되지 않던 버그 수정
      • saige detection, safety detection 사용시 검출 결과 없을 때 부적합 사유 표시되지 않던 버그 수정
  • 시방준수 과제 (install_compliance)
    • [모델 배포]
      • 모델 개선
        • saige detection : /NFS/database_personal/ktt/release/resource/install_compliance/0_0_0/0_0_0.saigedet
        • multi-label classification : /NFS/database_personal/ktt/release/resource/install_compliance/0_0_0/0_0_0.saigecls
      • 파라미터 수정
        • MLC defect threshold 기존 50에서 10으로 하향
  • 침입관제 과제 (intrusion_monitoring)
    • [모델 배포]
      • 모델 정식 배포
        • safety detection : /NFS/database_personal/ktt/release/resource/intrusion_monitoring/0_0_2/0_0_2.kttdet
    • [버그 수정]
      • infer 메소드 사용시 발생하는 onnx runtime 경고 수정
  • 감성보고서 과제 (image_validation)
    • [모델 배포]
      • 모델 정식 배포 (이전에 사용하던 것과 동일합니다.)
        • report type classification : /NFS/database_personal/ktt/release/resource/image_validation/0_0_0/report_type_0_0_0.saigecls
        • general report classification : /NFS/database_personal/ktt/release/resource/image_validation/0_0_0/general_report_0_0_0.saigecls
        • financial report classification : /NFS/database_personal/ktt/release/resource/image_validation/0_0_0/financial_report_0_0_0.saigecls

0.0.8

• 2025-12-09
  • 시방준수 과제 (install_compliance)
    • [버그 수정]
      • infer 메소드 사용시 발생하는 Bounding box 타입 불일치 에러 수정

0.0.7

• 2025-12-08
  • 난공사 과제 (cctv_height)
    • [기능 수정]
      • Detection 모델 선택 기능 추가
        • API build 시 detection 체크포인트 경로 입력이 필요하도록 수정
        • 아래 경로 중 선택 가능. 기본값은 grounding detection 사용 권장. 모델 성능 상황에 따라 권장 경로는 추후 별도 안내 예정
          • grounding detection : /NFS/database_personal/ktt/release/resource/cctv_height/2_0_0/2_0_0.saigegrddet
          • safety detection : /NFS/database_personal/ktt/release/resource/cctv_height/2_0_0/2_0_0.safetydet
          • saige detection : /NFS/database_personal/ktt/release/resource/cctv_height/2_0_0/2_0_0.saigedet
      • 부적합 타입 ladder_not_centered 추가
        • cctv_not_centered와 동일기준
        • 사다리가 이미지 좌우 외곽 영역에 위치할 경우 발생
      • 부적합 타입 incomplete_ladder_visibility 기준 수정
        • 기존: 사다리 box가 이미지 하단에 맞닿아 있을 때 발생
        • 변경: 사다리 box가 이미지 하단 5% 영역에 포함되는 경우 발생
      • inference option 구조 변경
        • 모델 별로 옵션을 관리하도록 수정
        • 자세한 내용은 API reference 참고. (cctv_height.Inferencer)
      • inference option 파라미터 명칭 변경
        • params.cctv_side_ignore_ratio -> params.side_ignore_ratio
  • 시방준수 과제 (install_compliance)
    • [기능 수정]
      • 부적합 케이스에 connector_at_image_edge 추가
        • 커넥터가 이미지 외곽 5% 영역 내에만 존재할 경우에 판단.
      • inference option 구조 변경
        • 모델 별로 옵션을 관리하도록 수정
        • 자세한 내용은 API reference 참고. (install_compliance.Inferencer)
    • [버그 수정]
      • 이미지 단위 부적합 판정 로직 수정
        • 기존: 하나라도 device에 연결되지 않은 커넥터가 있으면 부적합 판단
        • 변경: 모든 커넥터가 연결되지 않은 경우에만 no_connector_inserted로 판단
  • 침입관제 과제 (intrusion_monitoring)
    • [기능 수정]
      • inference option 구조 변경
        • 모델 별로 옵션을 관리하도록 수정
        • 자세한 내용은 API reference 참고. (intrusion_monitoring.Inferencer)

0.0.6

• 2025-12-02
• [기능 추가]
  • 침입관제 과제 surveillance_mode(경계 모드) 기능 추가
    • Inferencer.infer() 메서드에 surveillance_mode 매개변수 추가 (bool 타입)
    • surveillance_mode=True: 침입감지 + 화재감지 모두 활성화
    • surveillance_mode=False: 화재감지만 활성화, 침입감지 비활성화
    • 추론 결과에 alarm_info 필드 추가
      • surveillance_mode: 경계모드 설정값 (bool)
      • intrusion_detected: 침입 감지 여부 (bool)
      • fire_detected: 화재 감지 여부 (bool)

0.0.5

• 2025-11-26
• [기능 추가]
  • 침입관제 과제 Detection 기능 추가
    • Detection threshold 조절 기능 추가 set_inference_option
• [기능 수정]
  • 침입관제 과제 infer API key 수정
    • 기존 best_frame_index 에서 best_frame_timestamp로 변경. 초 단위의 시간을 반환
  • 침입관제 과제 infer API value 수정
    • best_frame_overlay가 영상의 원본 해상도 크기를 가지도록 변경

0.0.4

• 2025-11-24
• [기능 추가]
  • 침입관제 과제 임시 API 배포 (intrusion_monitoring.Inferencer)
    • Motion detection 기능 포함
    • Detection 기능 미포함.
    • inference option 관련 기능 미포함

0.0.3

• 2025-11-21
• SaigeToolkit 버전 업데이트: 2.7.2
• [버그 수정]
  • 난공사 과제 API (cctv_height.Inferencer) 빌드하여 사용시 타입 에러 발생하는 문제 수정.

0.0.2

• 2025-11-19
• [버그 수정]
  • cctv_height.Inferencer.infer의 버그 수정. (enum 타입에 대해 두번 .value 호출되어 에러 발생)
  • cctv_height.Inferencer.infer api 독스의 키값 수정 timer -> time
  • API 독스 난공사 과제 링크 오류 수정 (CcctvHeightInferencer -> CctvHeightInferencer)

0.0.1

• 2025-11-19
• [기능 추가]
  • 감성보고서 과제 API 배포 (image_validation.Inferencer)
• [기능 수정]
  • cctv_height.Inferencer.infer의 리턴 타입 버그 수정.

0.0.0

• 2025-11-17
• [기능 추가]
  • 난공사 과제 API 배포 (cctv_height.Inferencer)
  • 시방준수 과제 API 배포 (install_compliance.Inferencer)