두 갈래의 글이 있습니다. 하나는 이 도구를 만들면서 직접 재본 측정 기록입니다. 인식 정확도를 어떻게 올렸고 어떤 시도가 실패했는지, 원본 숫자를 그대로 적었습니다. 다른 하나는 변환 결과를 읽고 활용하는 데 필요한 자료입니다. 코드 다이어그램과 코드 기호를 해석하는 방법, 실제로 손을 움직이는 요령입니다.
어느 쪽이든 필요한 항목만 골라 보셔도 됩니다.
개발 기록 — 직접 측정한 것들
이 도구를 만들면서 실제로 재본 숫자와, 틀렸던 판단을 그대로 적어둔 기록입니다. 인식 정확도를 어떻게 올렸고 무엇이 실패했는지 원본 측정값과 함께 공개합니다.
코드 인식 정확도를 세 줄 수정으로 F1 87.5에서 90.5로 올린 기록
악보 세 장 138개 코드에 정답을 붙여 측정했습니다. 분할 알고리즘을 새로 쓰는 것보다 이미 있던 버그 두 개를 고치는 쪽이 훨씬 효과가 컸습니다. 측정값과 원인을 그대로 공개합니다.
개발 기록코드부 분할 전략 다섯 가지를 실측 비교했더니 기존 방식이 이겼다
코드 리본 안에서 코드 하나하나를 잘라내는 방식을 네 가지 새로 만들어 기존 방식과 비교했습니다. 정밀도·재현율·F1을 정답 138개로 재본 결과와, 새 방식들이 왜 실패했는지 정리했습니다.
개발 기록볼타 브래킷 하나가 코드 네 개를 한 덩어리로 만들었다
악보의 1번·2번 반복 괄호를 그리는 긴 가로줄이 코드 인식을 망가뜨리는 과정을 측정값으로 추적했습니다. 글자 높이의 17.7배 폭으로 병합된 박스를 찾아내고, 획만 골라 지우는 방법으로 해결했습니다.
개발 기록악보 일곱 장으로 재본 인식 결과: 어떤 악보가 되고 어떤 악보가 안 되는가
테스트 악보 일곱 장의 실제 인식 개수와 처리 시간을 공개합니다. 코드가 없는 악보에서 가사를 코드로 오인하는 문제, 손글씨가 섞인 악보의 한계까지 측정값으로 정리했습니다.
개발 기록위치 다이어그램 잡는 팁
악보 위 어느 자리에 그림을 붙일지 정하는 과정에는 서로 다른 좌표계 세 개가 등장합니다. 리본 편집기를 만들면서 좌표계를 하나로 통일한 방법과, 왕복 검증으로 확인한 결과를 적었습니다.
ChordSticker 활용
도구가 어떻게 동작하는지, 그리고 더 좋은 결과를 얻으려면 무엇을 해야 하는지 다룹니다.
ChordSticker는 악보를 어떻게 읽는가: 오선 탐지부터 다이어그램 합성까지
악보 사진 한 장이 코드 운지법이 붙은 이미지로 바뀌기까지 내부에서 벌어지는 일을 단계별로 공개합니다. 왜 어떤 악보는 잘 되고 어떤 악보는 실패하는지 이해할 수 있습니다.
실전 팁악보 사진 잘 찍는 법: 코드 인식률을 끌어올리는 9가지
같은 악보라도 촬영 방식에 따라 인식 결과가 크게 달라집니다. 조명, 각도, 해상도, 배경, 파일 형식까지 인식 파이프라인의 실제 동작에 근거한 촬영 요령을 정리했습니다.
실전 팁자주 틀리는 코드 인식 유형 12가지와 수정 요령
b를 6으로, m을 M으로 읽는 문자 혼동부터 코드가 둘로 쪼개지는 분할 오류, 다이어그램이 붙지 않는 매칭 실패까지. 오류를 유형별로 나누고 각각의 수정법을 정리했습니다.
레퍼런스다이어그램이 붙는 코드 목록과 올바른 입력 표기법
ChordSticker 내장 코드 사전이 지원하는 근음 12종과 접미어 전체 목록, 자동 변환되는 표기, 지원하지 않는 표기의 대체 방법을 정리했습니다.
악보와 코드 읽기
코드표의 점 하나, 악보에 적힌 기호 하나가 무슨 뜻인지 해석하는 방법입니다.
기타 코드 다이어그램 읽는 법: 점 하나까지 전부 해석하기
기타 코드표(다이어그램)의 세로선, 가로선, 검은 점, X와 O 표시, 숫자, 바레 표시가 각각 무엇을 뜻하는지 하나씩 뜯어봅니다. 코드표를 보고 바로 손 모양을 만드는 순서까지 정리했습니다.
이론악보 위 코드 기호 완전 해설: Cmaj7, C7, Csus4, C/E는 무엇이 다른가
오선보 위에 적힌 코드 네임을 구성음 단위로 분해합니다. 메이저·마이너·세븐스·서스펜디드·애드·디미니시드·분수 코드까지, 기호를 보고 소리를 예측하는 규칙을 정리했습니다.
이론이명동음 완전 정리: G#과 Ab는 왜 같은 소리인데 다르게 적는가
같은 건반을 누르는데 이름이 둘인 이유, 조표에 따라 어느 쪽을 써야 하는지, 그리고 코드 사전이 한쪽 표기만 갖고 있어도 문제가 없는 이유를 설명합니다.
이론이름이 다른데 소리가 같은 코드들, 운지까지 같은 것은 무엇인가
Am7과 C6은 구성음이 같습니다. 그런데 잡는 손 모양은 다릅니다. 코드 사전 데이터로 어떤 쌍이 운지까지 같고 어떤 쌍이 갈리는지 확인했습니다. 인식 결과를 고쳐야 할지 판단하는 기준으로 씁니다.
기타 연주 기초
실제로 손이 움직여야 하는 부분. 오픈 코드부터 바레 코드, 카포 활용까지.
기타 오픈 코드 14개: 이것만 알면 웬만한 곡은 친다
C, G, D, A, E부터 Am, Em, Dm, 세븐스 코드까지 개방현을 쓰는 기본 코드 14개의 운지, 자주 나는 잡음의 원인, 코드 사이 이동 요령을 정리했습니다.
기초바레 코드 정복 가이드: F가 안 눌리는 진짜 이유
힘이 부족해서 F가 안 되는 것이 아닙니다. 검지 각도, 엄지 위치, 팔의 지렛대까지 물리적 원인을 분석하고, E형과 A형 두 모양으로 모든 코드를 만드는 방법을 정리했습니다.
실전 팁카포와 조옮김: 어려운 코드를 쉬운 코드로 바꾸는 계산법
카포를 어느 프렛에 끼우면 어떤 코드가 나오는지, 노래 키를 바꾸려면 몇 칸을 옮겨야 하는지 계산하는 방법과 조옮김 대조표를 정리했습니다.
이론과 상식
코드 진행의 논리와, 악보를 다룰 때 알아두면 좋은 저작권 상식입니다.
다이어토닉 코드와 코드 진행: 다음에 올 코드를 예측하는 법
조마다 정해진 일곱 개의 코드가 무엇이고, 왜 특정 순서로 이어지는지 설명합니다. 이 원리를 알면 인식된 코드가 맞는지 화성으로 검산할 수 있습니다.
알아두기악보 저작권 상식: 어디까지가 사적 이용인가
구입한 악보를 스캔해 변환하는 것, 변환한 결과를 합주 멤버와 나누는 것, 수업에 배포하는 것. 각각이 저작권법상 어떻게 다른지 정리했습니다.
처음이라면 이 순서로
- 사용 가이드로 전체 흐름을 파악합니다.
- 촬영 가이드를 보고 악보를 준비합니다.
- 변환한 뒤 코드 다이어그램 읽는 법으로 결과를 해석합니다.
- 결과가 이상하면 인식 오류 가이드를 참고해 고칩니다.
- 코드가 손에 익지 않으면 오픈 코드 14개부터 연습합니다.
이 도구가 어떤 악보에서 잘 되고 어떤 악보에서 실패하는지 숫자로 확인하고 싶으시면 악보 일곱 장 실측 결과부터 보세요. 인식 정확도를 어떻게 개선했는지는 개발 기록에 측정값과 함께 적어두었습니다.