Skip to content

Release notes

2.3.11

  • 2025/11/18
  • [버그 수정]
    • 인양물 segmentation contour 추출 시에 contour 점이 1-2개로 적은 경우를 필터링하도록 수정하였습니다.
    • 공간 지각 협착에서 depth map에 NaN 값이 포함된 경우 발생하는 버그 수정하였습니다.

2.3.10

  • 2025/11/14
  • [모델 추가]
    • 적재 불량 감지를 위한 Segmentation Model이 추가되었습니다.
      • 2_3_10.safetyseg
  • [기능 추가]
  • [기능 변경]
    • 협착 반경 설정 관련 파라미터들이 event에서 object 설정으로 위치를 이동하였습니다.
    • InferenceHandler.infer output의 crush_hazard_zone type이 np.array로 바뀌었습니다.

2.3.10-rc0

2.3.9

  • 2025/10/14
  • [버그 수정]
    • TensorRT 최적화 모델로 카메라 여러대 추론 시에 결과가 누락되는 버그를 수정하였습니다.

2.3.8

  • 2025/10/13
  • [버그 수정]
    • 배치 인퍼런스 시에 예측이 불안정한 버그를 수정하였습니다.

2.3.7

  • 2025/10/02
  • [기능 변경]
    • 윈도우 환경에서 spatial inferencer의 batch size 증가에 따른 속도 증가폭이 미미하여, 기본 batch size를 1로 변경 및 vram 사용량 개선하였습니다.
  • [기능 추가]
    • without_helmet, without_harness, fallen_person 이벤트 감지 시에 작은 객체가 감지되는 경우 이벤트가 발생하지 않도록 옵션을 추가하였습니다. object_area_threshold로 설정 가능합니다. (InferenceHandler.get_default_event_options 참고)
    • 모델 예측 점수가 높은 객체는 더 빨리 추적하도록 object tracker에 옵션을 추가하였습니다. object_score_threshold로 설정 가능합니다. (InferenceHandler.get_default_tracker_option 참고)
  • [기능 개선]
    • Object tracker 속도를 개선하고, 연산을 gpu로 일부 옮겨 cpu 사용률을 낮췄습니다.
  • [모델 추가]
    • 더 빠른 object tracker 연산을 위해 최적화 모델을 추가하였습니다.
      • 2_3_7.safetytrk

2.3.6

  • 2025/09/23
  • [버그 수정]
    • proximity_hazard_detect 이벤트에서 polygon_pairs 설정 시에 발생하는 버그 수정.

2.3.5

2.3.4

  • 2025/09/16
  • [모델 변경]
    • 공간 지각 모델을 변경하였습니다. 깊이맵, 노멀맵을 한 번에 예측하는 모델로 변경되어 이전보다 VRAM 사용량, 인퍼런스 시간이 소폭 증가할 수 있습니다.
      • 2_3_4.safetydepth

2.3.3

  • 2025/09/16
  • [기능 추가]
    • collision_hazard_detect, crush_detect 이벤트에 hazard_object_types 옵션 추가. (참고: InferenceHandler.get_default_event_options)
    • InferenceHandler.infer의 리턴의 classification_scores 필드에 이벤트 점수 필드 독스트링 추가.
      • tresspass: trespass_detect event score
      • in_danger_zone: danger_detect event score
      • in_collision_hazard_zone: in_collision_hazard_zone event score
      • collision_hazard: collision_hazard_detect event score
      • crush_hazard: crush_detect event score
      • 해당 이벤트의 발생 조건을 만족시키지 못한 경우에 score가 -1로 리턴 될 수 있습니다.

2.3.2

2.3.1

  • 2025/08/26
  • [기능 변경]
    • 더 빠른 인퍼런스를 위해 공간 지각 기능에서 batch size가 1로 고정되어 있던 부분을 2로 변경하였습니다.

2.3.0

  • 2025/08/20
  • [기능 변경]
    • 공간 지각 침입 기능에서 지면 깊이 맵을 피팅하는 기능을 개선했습니다.
    • Normal을 사용하는 기능이 없어서 일시적으로 normal inferencer가 제거되었습니다. 추후 수정 예정입니다.

2.3.0-rc2

  • 2025/08/08
  • [모델 변경]
    • 2_0_0.posco0.safetydet, 2_0_0.posco0.safetycls
  • [기능 추가]
    • 이벤트 중 침입, 협착, 위험, 충돌 이벤트에 한해서 event 여부와 score를 함께 리턴하도록 수정하였습니다. (2.2.1 업데이트와 동일)
    • 침입의 경우, depth를 사용하는 경우엔 score가 반환되지 않습니다.

2.3.0-rc0

  • 2025/07/30
  • [모델 추가]
    • 공간 지각 관련 모델이 추가되었습니다. VRAM 사용량 및 인퍼런스 시간이 증가할 수 있습니다. (최적화는 추후 예정)
      • 2_3_0.safetydepth, 2_3_0.safetymatch, 2_3_0.saigenormal
  • [기능 변경]
    • InferenceHandler.infer의 리턴값에 있는 time 딕셔너리 내용이 변경되었습니다. 자세한 사항은 docs 참조바랍니다.
  • [기능 추가]

2.2.0

2.1.0

2.0.0

  • 2025/04/07
  • SaigeToolkit 버전 업데이트: 2.6.1
    • RTX 30, 40, 50 시리즈 대응 가능.
  • [모델 변경]
    • 2_0_0.safetydet, 2_0_0.safetycls, 2_0_0.safetyreid
  • [버그 수정]
    • torch 관련 패키지 설치시, 신뢰할 수 없는 호스트 관련 에러가 발생하지 않도록 수정.
  • [기능 변경]
    • 객체 옵션(InferenceHandler.get_default_object_options 참고) 중 enabled의 기본값을 False로 변경.
    • InferenceHandler.build의 device의 기본값을 cuda로 변경하고, 빌드시 호스트에 사용가능한 gpu가 없거나, device=cpu이면 에러 레이즈. (각각, GpuDeviceUnavailableError, CpuDeviceNotSupportedError 발생.)

2.0.0-rc7

  • 2025/03/25
  • [기능 변경]
    • Object tracker 교체:
      • reidentification의 모델이 변경되었습니다. (2_0_0_beta3.safetyreid)
      • 붐비는 상황에서 사람 트레킹이 개선되고, 중장비 및 차량 클래스에 대한 트레킹이 가능해졌습니다.
      • Tracker 로직 변경 및 모델 변경으로 인해, 추론 스펙에 약간의 변동이 있습니다. (별도 공유 예정)
    • CLS score에 대한 필터링, EMA 추가 및 객체에 대한 연속성 카운트 추가로 객체 및 이벤트 과/미검 케이스 일부 개선.
    • 알람 옵션(InferenceHandler.get_default_alarm_options 참고) 중 enabled=False인 event는 InferenceHandler.infer의 객체별 events 딕셔너리에서도 항상 False로 리턴.

2.0.0-rc6

2.0.0-rc5

2.0.0-rc4

  • 2025/02/18
  • SaigeToolkit 버전 업데이트: 2.4.0
  • [기능 추가]
    • InferenceHandler.build에서 optimize (bool) 변수 추가. True시 해당 디바이스에서 첫 빌드시 tensorrt 최적화에 몇 분가량 소요되고, 그 다음부터는 최적화된 모델을 바로 불러옵니다.
  • [기능 변경]
    • InferenceHandler.infer의 리턴값의 time 딕셔너리의 구성 변경.
      • 추가된 key: load_time, reidentification_time, event_alarm_time.
    • InferenceHandler.set_alarm_options의 일부 옵션 변경
      • end_time: 기존에 0~86399로 범위로 설정하던 것을 0~86400 범위로 변경
      • start_time과 end_time이 같으면 발생하던 InvalidAlarmOptionsError가 더 이상 발생하지 않음. 대신 항상 활성화된 것으로 간주합니다.
  • [기능 개선]
  • [버그 수정]

2.0.0-rc3

  • 2025/01/17
  • API 독스 수정 (Python 환경 설치법 관련)

2.0.0-rc2

  • 2025/01/16
  • SaigeToolkit 버전 업데이트: 2.3.1
  • [기능 변경]
    • monitoring_area 및 일부 polygon 형태의 옵션을 사용하는 이벤트(trepess_detect, danger_detect 이벤트)의 polygon format 변경
      • n-각형 폴리곤에 대해서
        • 변경 전: [[x1, y1], ..., [xn, yn], [x1, y1]]
        • 변경 후: [[x1, y1], ..., [xn, yn]]
  • [기능 추가]

2.0.0-rc1

  • 2025/01/08
  • [Bug Fix]
    • 배치 사이즈가 1보다 큰 경우 InferenceHandler.infer에서 나오는 이미지당 추론 시간이 잘못 계산되던 버그 수정.
  • [기능 추가]
    • InferenceHandler.infer에서 나오는 추론 시간에 event_alarm_time (이벤트 관제에 소요된 시간) 추가.

2.0.0-rc0