Cloudwiki/확장 기능/freq

# Cloudwiki 주파수응답 삽입 확장 기능

이 확장 기능은 음향기기의 주파수응답 측정 데이터를 위키에 저장하고, Chart.js 그래프로 출력해 문서에 포함시키는 기능입니다.

# 데이터 업로드

## 데이터 형식

REW 기준 text로 출력한 데이터를 사용합니다.

[+ 데이터 예시]

```
* Measurement data measured by REW V5.31.3
* Source: USB-C to 3.5mm Headphone Jack Adapter, no input selected, 0, volume: no control. Timing signal peak level -16.3 dBFS, measurement signal peak level -16.1 dBFS
* Format: 256k Log Swept Sine, 1 sweep at -12.0 dBFS using an acoustic timing reference
* Dated: 2025 Nov 3 21:53:14
* REW Settings:
*  C-weighting compensation: Off
*  Target level: 75.0 dB
* Note: ; Delay -0.2767 ms (-95 mm, -3.74 in) using estimated IR delay relative to Acoustic reference played from Qudelix-T71 2.0  L with no timing offset Clock adjustment: 1.4 ppm
* Measurement: Left
* Smoothing: None
* Frequency Step: 0.36621094 Hz
* Start Frequency: 0.36621094 Hz
*
* Freq(Hz); SPL(dB); Phase(degrees)
0.366211; 64.867; -66.1918
0.732422; 68.105; -84.3009
1.098633; 68.970; -80.2345
1.464844; 71.285; -57.8447
1.831055; 76.088; -46.4884
....이하 생략
```
[-]

### 데이터 추출 (REW)
> [Room EQ Wizard](https://www.roomeqwizard.com) 기준입니다.

측정 완료 후, 측정 데이터를 선택 후 최상단의 File을 클릭하고, 드롭다운 메뉴에서 Export, Export measurement as text를 선택후, 원하는 경로로 저장합니다. 
텍스트 파일로 추출된 내용을 복사하고, 아래 `주파수응답 데이터 문서 생성` 과정에서 사용하세요.
REW에서 추출된 텍스트 데이터는 추가 처리 과정 없이 즉시 삽입이 가능합니다.

## 주파수응답 데이터 문서 생성

문서의 제목 앞에 `freq:` 를 붙입니다.
`LCD-X-left` 데이터를 업로드 하는 경우, 문서 제목은 [[freq:LCD-X-left]] 가 됩니다.

## 문서에 삽입

문서 편집기에서 [[Cloudwiki/기능/틀|틀 문법]] 과 유사하게 `freq:문서 제목` 형식으로 주파수 응답 문서를 삽입하세요.
`{{freq:LCD-X-left}}` 


## 타겟 응답과의 비교/보정

두 번째 인자에 다른 `freq:` 문서를 지정하면 첫 번째 응답 위에 두 번째 응답을 점선으로 함께 표시하고, 타겟 기준 보정 모드도 사용할 수 있습니다.

`{{freq:LCD-X-left|freq:Harman-OE-2018}}`

이때 두 번째 슬롯에 들어간 응답(`freq:Harman-OE-2018`)은 **타겟 응답**(예: 하만 타겟, DF 등)으로 취급됩니다.

- **기본 표시** — 첫 번째 응답(실선) 위에 타겟 응답이 점선으로 항상 겹쳐서 표시됩니다. 별도 버튼이 필요하지 않습니다.
- **보정 버튼** — 그래프 헤더의 토글 버튼. 켜면 첫 번째 응답에서 타겟 응답을 뺀 편차(SPL Δ)를 표시합니다. 200~1000 Hz 평균이 0이 되도록 자동 정렬되어 타겟 대비 형상 차이를 직관적으로 볼 수 있습니다. 타겟이 커버하지 않는 주파수 구간은 표시되지 않습니다.

### Phase 와의 상호 배타

위상(Phase) 데이터가 있는 측정에서는 Phase 보기와 보정 모드가 한 번에 하나만 켜질 수 있습니다.



### 동작 규칙

- 두 번째 인자가 비어 있으면 단일 그래프(`{{freq:제목}}`)와 동일하게 동작합니다.
- 두 번째 인자가 `freq:` 네임스페이스의 문서가 아니거나, `freq:` 문서이더라도 데이터를 불러올 수 없거나 REW 형식으로 파싱할 수 없으면, 보정 버튼 대신 헤더 아래에 경고 배너가 표시됩니다. 첫 번째 응답은 정상적으로 렌더링됩니다.
- 타겟 응답에 위상 데이터가 있어도 보정에는 SPL 만 사용됩니다.

# 데이터 스무딩

편집기에서 바로 사용 가능한 스무딩 기능이 제공됩니다. 

freq: 로 저장된 주파수응답 문서 편집 페이지에서 `데이터 스무딩` 버튼이 노출되며, 1/48 ~ 1옥타브 (기본 권장값 1/24)로 스무딩할수 있습니다.

스무딩 처리 이후 데이터는 새 리비전으로 저장되며, 스무딩 이전 원본 데이터도 리비전 기록으로 남아 복원이 가능합니다.
스무딩시 위상(Phase) 데이터는 제거됩니다.