Release notes

0.5.0

• 2025/10/22
• [기능 추가]
  • Line detection 기반으로 사이드 뷰 프레임에서 회전 각도를 측정하는 기능이 추가되었습니다.

0.5.0-rc0

• 2025/10/13
• [기능 추가]
  • json 또는 dict 형태로 WindingMonitoringEngine의 설정값을 변경할 수 있는 update_monitoring_config 메소드가 추가되었습니다.
  • 사이드 뷰 프레임에서 회전 각도를 측정하는 기능이 추가되었습니다. (단, 현재는 dummy 값을 내보내도록 구현되어 있습니다.)
    • process_frame 메소드의 입력값이 변경되었습니다.
    • 기존에 배포되었던 모델 파일을 사용할 수 없습니다.
    • 서브모듈인 SaigeSegmentation2 가 업데이트 되었습니다.
    • 사이드 뷰 프레임이 제공되지 않으면 MissingSideViewFrameError 에러가 발생합니다.
• [Docs 수정]
  • process_frame의 Returns 설명을 수정하였습니다.

0.4.1

• 2025/09/29
  • 1차 PoC 코드입니다.
• [기능 개선]
  • 극단에서 방향이 반대로 잘못 예측되는 문제를 해결하였습니다.
  • 왼쪽 극단에서 tigthening_score가 다시 증가하는 이슈를 해결하였습니다.
  • 극단에서의 층 발생 여부에 있어 전선의 굵기를 고려하도록 개선되었습니다.
• [연구소 내부 기능]
  • 리눅스 서버에서 학습하기 위한 train 모드가 추가되었습니다.
  • 마스크 기반의 색깔 변화와 크기 조정을 위한 augmentation 기능이 추가되었습니다.
  • 상황별 테스트 케이스에 대한 성능을 검증하기 위한 테스트 코드가 추가되었습니다.
  • 각종 리팩토링 수행

0.4.0

• 2025/08/27
• [기능 추가]
  • 드럼 양옆에 붙인 테이프에 대한 tape segmentation class가 추가되었습니다.

0.3.2

• 2025/08/20
• [기능 개선]
  • 극단에서 두번째 전선을 넘기기 위한 로직을 한번 더 개선하였습니다.

0.3.1

• 2025/08/20
• [기능 개선]
  • 극단에서 두번째 전선을 넘기기 위한 로직을 개선하였습니다.

0.3.0

• 2025/08/19
• [기능 추가]
  • 극단에서 두번째 바퀴 권취를 위해 드럼을 움직이는 과정을 위한 이동 점수 drum_swing_score가 추가되었습니다.
• [기능 개선]
  • 권취 진행률 계산 로직을 개선하였습니다.
  • 스펀지 보양 알림 기본값이 80에서 90으로 변경되었습니다.
  • 권취 진행 방향 판단 로직을 개선하였습니다.
  • 권취 불량 판단 로직을 개선하였습니다.

0.2.2

• 2025/08/12
• [Bug Fix]
  • 극단에 도달하는 경우 결과가 정상적으로 출력되지 않는 이슈를 해결하였습니다.

0.2.1

• 2025/08/12
• [Bug Fix]
  • params.swing_term가 정상적으로 변경되지 않는 이슈를 해결하였습니다.

0.2.0

• 2025/08/11
• [기능 추가]
  • 극단에서 전선을 드럼에 밀착시키기 위한 로직이 추가되었습니다.
  • 극단에서 두번째 바퀴 권취가 첫번째 바퀴와 밀착할 수 있도록 드럼을 좌우로 이동시키는 로직이 추가되었습니다.
  • 극단 드럼 이동 관련 파라미터(params.swing_term, params.shift_strength)가 추가되었습니다.
• [기능 변경]
  • 극단에서 한바퀴 권취 후 방향이 전환되도록 방향젼환 로직이 변경되었습니다.

0.1.2

• 2025/07/31
• [기능 개선]
  • 권취 진행률 계산 로직을 개선하였습니다.

0.1.1

• 2025/07/29
• [기능 변경]
  • 권취 방향이 바뀌면 드럼 이동 유효 영역이 재설정되는 로직을 제거하였습니다.

0.1.0

• 2025/07/29
• [기능 변경]
  • 드럼 이동 유효 영역이 이동 신호 발생 이후 재설정되는 로직을 제거하였습니다.
  • 검사 시작 시, 해당 시점의 전선 위치를 바탕으로 설정된 유효 영역이 유지되도록 수정하였습니다.
• [Bug Fix]
  • 검사 도중 스펀지 보양 진행률 파라미터가 변경되어도 다시 보양 알림이 발생할 수 있게 수정하였습니다.

0.0.14

• 2025/07/24
• [기능 개선]
  • 드럼 이동 민감도의 기본값을 낮추어 드럼 이동 점수가 1.0에서 내려가지 않는 현상을 해결하였습니다.

0.0.13

• 2025/07/24
• [Bug Fix]
  • 드럼 이동 관련 파라미터(params.shift_sensitivity) 변경 시, 연구소 내부 파라미터가 정상적으로 수정되지 않아 이동 점수가 낮게 나오는 현상을 해결하였습니다.
• [기능 개선]
  • 권취 양극단 부분에서 진행률이 낮게 나오거나 높게 나오는 현상을 개선하였습니다.

0.0.12

• 2025/07/23
• [Bug Fix]
  • 양극단에서 방향이 전환된 경우, 진행률이 정상적으로 초기화되지 않고 기존 진행률로 이어지는 현상을 해결하였습니다.

0.0.11

• 2025/07/23
• [Bug Fix]
  • set_monitoring_option을 통한 API 파라미터가 정상적으로 수정되지 않는 이슈를 해결하였습니다.

0.0.10

• 2025/07/22
• [Bug Fix]
  • 권취 시작 단계에서 권취 진행 방향이 올바르게 예측되지 않는 이슈를 개선하였습니다.

0.0.9

• 2025/07/21
• [기능 개선]
  • 권취 진행률이 100%까지 도달하지 못하는 이슈를 개선하였습니다.
  • 양극단에서 방향 전환이 정상적으로 진행되지 않는 이슈를 개선하였습니다.

0.0.8

• 2025/07/17
• [기능 추가]
  • 권취 불량이 최초 1회 발생 시에만 출력될 수 있는 마스킹 기능이 추가되었습니다.
  • 드럼 이동 신호 주기를 설정할 수 있는 shift_alarm_interval 모니터링 옵션이 추가되었습니다. (default = 5)

0.0.7

• 2025/07/16
• [Bug Fix]
  • 권취 진행률이 실제 상황보다 다소 낮게 혹은 높게 예측되는 현상을 개선하였습니다.

0.0.6

• 2025/07/15
• [기능 추가]
  • 일정 프레임 이상 드럼 몸통이 예측되지 않을 경우 엔진을 자동으로 초기화하는 로직이 추가되었습니다.
  • API 에러가 발생하여 state_index = 5인 경우, 에러 메시지를 출력하고 error_message 변수로 리턴합니다.
  • 드럼 이동 신호가 과도하게 지속되는 현상을 방지하기 위해 드럼 이동 신호를 최대 5초까지만 출력하는 제한이 추가되었습니다.
• [기능 변경]
  • 스펀지 보양 알림이 기준 진행률에 도달한 최초 시점에만 알림이 한번 출력되도록 수정되었습니다.
  • 권취 전선의 예측 여부 및 모니터링 정상 작동과 상관없이 SEG 결과를 항상 출력하도록 수정하였습니다.
  • 임시로 추가되었던 햇빛 가려짐 영역 전선 연장 기능을 비활성화 하였습니다.
  • 권취 불량 과검을 줄이기 위해 기본 민감도를 낮추었습니다.
  • 민감도 변경으로 인한 권취 불량 감지를 유의미하게 조절하기 위해 변동되는 민감도의 폭을 확장하였습니다.
• [Bug Fix]
  • 작업 초기에 권취 진행 방향과 진행률이 잘못 예측되는 현상을 수정하였습니다.
  • 진행률이 불안정하게 늘었다가 줄어드는 현상을 수정하였습니다.

0.0.5

• 2025/07/12
• [기능 추가]
  • 햇빛에 가려져 권취 중인 전선이 잘 보이지 않는 경우에도 전선이 예측될 수 있는 기능이 추가되었습니다.
• [Bug Fix]
  • SEG 예측 결과가 출력되지 않는 경우 무조건 state_index가 5로 출력되는 버그를 수정하였습니다.

0.0.4

• 2025/07/10
• [기능 개선]
  • 권취 불량 과검을 줄이기 위해 불량 탐지 알고리즘이 개선되었습니다.

0.0.3

• 2025/07/09
• [Bug Fix]
  • API가 정상적으로 호출되지 않는 오류를 해결하였습니다.

0.0.2

• 2025/07/09
• [기능 개선]
  • 드럼 몸통의 양옆으로 튀어나오는 영역으로 인하여 권취 불량 과검이 발생하는 문제를 해결하였습니다.
  • 드럼 이동 스코어 계산 로직을 개선하였습니다.
  • 드럼 이동 스코어(drum_shifting_score)의 기본값을 -1.0에서 0.0으로 변경하였습니다.

0.0.1

• 2025/06/26
• [Bug Fix]
  • moving_direction 변수가 left_to_right 혹은 right_to_left로 출력되도록 수정하였습니다.
  • drum_moving_direction의 불필요한 상태인 stop을 삭제하였습니다.

0.0.0-rc2

• 2025/06/24
• [Bug Fix]
  • ng_boxes가 (N, 4)가 아닌 (4,) shape으로 출력되는 이슈를 해결하였습니다.
  • progress_rate가 불안정한 이슈를 해결하였습니다.
  • SEG의 예측 결과가 다중인 경우, 가장 큰 물체를 선택하도록 수정되었습니다.

0.0.0-rc1

• 2025/06/20
  • 이동 방향 전환 기능이 추가되었습니다. (state_index가 2인 경우 발생 가능)
  • 드럼 이동 중을 나타내는 state_index가 삭제되었습니다.

0.0.0-rc0

• 2025/06/19
  • Initial Release