These docs are for v1.0. Click to read the latest docs for v2.0.

Key Concepts

πŸ™‹β€β™€οΈ User

μ‚¬μš©μžλŠ” μˆ˜λ©΄μ„ κΈ°λ‘ν•˜κ³ μž ν•˜λŠ” λŒ€μƒμ„ μ˜λ―Έν•˜λ©°, SDK ν˜Ήμ€ APIλ₯Ό μ‚¬μš©ν•˜μ—¬ μˆ˜λ©΄μ„ μΈ‘μ •ν•˜κ³ μž ν•˜λŠ” μ‚¬μš©μž uuidλ₯Ό 생성할 수 μžˆμŠ΅λ‹ˆλ‹€. 이λ₯Όν†΅ν•΄ μ‚¬μš©μžλ³„λ‘œ 수면 μ„Έμ…˜μ„ 관리할 수 μžˆμŠ΅λ‹ˆλ‹€.

πŸ›Œ Sleep Session

수면 μ„Έμ…˜μ€ ν•œ 번의 잠(μΉ¨λŒ€μ— λˆ„μ›Œμ„œ μΌμ–΄λ‚˜κΈ°κΉŒμ§€)에 ν•΄λ‹Ήν•˜λŠ” κ°œλ…μž…λ‹ˆλ‹€. νŠΉμ • μ‚¬μš©μžμ˜ 수면 μ„Έμ…˜μ„ μƒμ„±ν•˜κ³ , λΆ„μ„ν•˜κ³ μž ν•˜λŠ” 데이터λ₯Ό μ—…λ‘œλ“œν•˜κ³ , μ„Έμ…˜μ„ μ’…λ£Œν•  수 μžˆμŠ΅λ‹ˆλ‹€.

μ„Έμ…˜μ€ OPEN, CLOSED, COMPLETE의 총 3κ°€μ§€μ˜ μƒνƒœ(state)λ₯Ό 가지고 μžˆμŠ΅λ‹ˆλ‹€.

  • OPEN: μ„Έμ…˜μ΄ μƒμ„±λ˜μ—ˆκ³  μ˜€λ””μ˜€ 데이터λ₯Ό 뢄석을 μœ„ν•΄ μ—…λ‘œλ“œν•  수 μžˆλŠ” μƒνƒœ
  • CLOSED: μ„Έμ…˜ μ’…λ£Œ μƒνƒœλ‘œ μ˜€λ””μ˜€λ₯Ό 더 μ—…λ‘œλ“œν•  μˆ˜λŠ” μ—†μœΌλ©°, 뢄석이 μ™„λ£Œλ˜κΈΈ κΈ°λ‹€λ¦¬λŠ” μƒνƒœ
  • COMPLETE: λͺ¨λ“  뢄석이 μ™„λ£Œλœ μƒνƒœ

πŸ“‡ Mel Spectrogram

μŠ€λ§ˆνŠΈν°μ΄λ‚˜ 슀마트 λ””λ°”μ΄μŠ€μ—μ„œ μΈ‘μ •λœ μ˜€λ””μ˜€ λ°μ΄ν„°λŠ” SDK의 μ „μ²˜λ¦¬ μ•Œκ³ λ¦¬μ¦˜μ„ 톡해 멜 μŠ€νŽ™νŠΈλ‘œκ·Έλž¨μ˜ ν˜•μ‹μœΌλ‘œ λ³€ν™˜λ˜μ–΄ μ„œλ²„μ— μ „μ†‘λ©λ‹ˆλ‹€.

Mel Spectrogram

Mel Spectrogram

πŸ“Š Data Metrics

수면이 μ’…λ£Œλ˜κ³  λͺ¨λ“  뢄석이 μ™„λ£Œλ˜λ©΄ 뢄석 결과둜 확인할 수 μžˆλŠ” λ°μ΄ν„°λŠ” λ‹€μŒκ³Ό κ°™μŠ΅λ‹ˆλ‹€. ν”Œλžœμ— 따라 μ‹€μ‹œκ°„ 뢄석 κΈ°λŠ₯ 이용 μ‹œ Open μƒνƒœμ˜ μ„Έμ…˜μ—μ„œ ν˜„μž¬κΉŒμ§€ λΆ„μ„λœ 수면 단계, 호흑 μ•ˆμ •λ„ 단계 데이터λ₯Ό μ‹€μ‹œκ°„μœΌλ‘œ 확인할 수 μžˆμŠ΅λ‹ˆλ‹€.

Asleep Data Visualization

Asleep Data Visualization

No.Data NameDefinitionTypeValueExamplePlan
1start_time수면 츑정이 μ‹œμž‘λœ μ‹œκ°stringYYYY-MM-DDThh:mm:ss2022-08-01T00:00:00+09:00[μ‹€μ‹œκ°„ 뢄석] μ‚¬μš©μ‹œ μ˜€ν”ˆ μ„Έμ…˜μ—μ„œ 확인 κ°€λŠ₯
2end_time수면 츑정이 μ’…λ£Œλœ μ‹œκ°stringYYYY-MM-DDThh:mm:ss2022-08-01T08:00:17+09:00
3sleep_timeμž λ“€κΈ° μ‹œμž‘ν•œ μ‹œκ°stringYYYY-MM-DDThh:mm:ss2022-08-01T00:30:00+09:00
4wake_timeμž μ—μ„œ κΉ¨μ–΄λ‚œ μ‹œκ°stringYYYY-MM-DDThh:mm:ss2022-08-01T07:30:00+09:00
5sleep_latency수면 μΈ‘μ • μ‹œμž‘ ν›„ μž λ“€κΈ° κΉŒμ§€ κ±Έλ¦° μ‹œκ°„intseconds1800
6wakeup_latencyμž μ—μ„œ κΉ¨μ–΄λ‚œ ν›„ 수면 츑정을 μ’…λ£Œν•˜κΈ°κΉŒμ§€ κ±Έλ¦° μ‹œκ°„intseconds1800
7sleep_efficiency수면 μΈ‘μ • μ‹œκ°„ 쀑 μ‹€μ œλ‘œ μž λ“  μ‹œκ°„μ˜ λΉ„μœ¨float0 이상 1 μ΄ν•˜0.84
8time_in_bed수면 μΈ‘μ • μ‹œμž‘ μ‹œκ°λΆ€ν„° 수면 μΈ‘μ • μ’…λ£Œ μ‹œκ° κΉŒμ§€μ˜ μ‹œκ°„intseconds28800
9time_in_sleep_period수면 μΈ‘μ • μ‹œκ°„ 쀑 수면 μΈ‘μ • μ‹œμž‘μœΌλ‘œλΆ€ν„° μž λ“€κΈ° κΉŒμ§€ κ±Έλ¦° μ‹œκ°„κ³Ό μž μ—μ„œ κΉ¨μ–΄λ‚œ ν›„λ‘œλΆ€ν„° 수면 츑정을 μ’…λ£Œν•˜κΈ°κΉŒμ§€ κ±Έλ¦° μ‹œκ°„μ„ μ œμ™Έν•œ μ‹œκ°„
(time_in_bed - sleep_latency - wakeup_latency)
intseconds27000
10time_in_sleep수면 μΈ‘μ • μ‹œκ°„ 쀑 μ‹€μ œλ‘œ 수면 μ€‘μ΄μ—ˆλ˜ μ‹œκ°„
이 μ‹œκ°„μ΄ deep, light, rem의 3λ‹¨κ³„λ‘œ ꡬ뢄됨
intseconds24300
11time_in_wake수면 도쀑에 κΉ¬ μ‹œκ°„intseconds2700
12time_in_rem수면 단계가 rem 으둜 μ§„ν–‰λœ 총 μ‹œκ°„intseconds13500[4단계 뢄석] μ‚¬μš© ν•„μš”
13time_in_light수면 단계가 light 둜 μ§„ν–‰λœ 총 μ‹œκ°„intseconds5400[4단계 뢄석] μ‚¬μš© ν•„μš”
14time_in_deep수면 단계가 deep둜 μ§„ν–‰λœ 총 μ‹œκ°„intseconds5400[4단계 뢄석] μ‚¬μš© ν•„μš”
15sleep_ratio수면 단계 도쀑 깨지 μ•Šκ³  μž” μ‹œκ°„μ˜ λΉ„μœ¨float0 이상 1 μ΄ν•˜0.9
16wake_ratio수면 단계 도쀑 쀑간에 κΉ¬ μ‹œκ°„μ˜ λΉ„μœ¨float0 이상 1 μ΄ν•˜0.1
17rem_ratio수면 단계 도쀑 REM 수면의 λΉ„μœ¨float0 이상 1 μ΄ν•˜0.5[4단계 뢄석] μ‚¬μš© ν•„μš”
18light_ratio수면 단계 도쀑 light 수면의 λΉ„μœ¨float0 이상 1 μ΄ν•˜0.2[4단계 뢄석] μ‚¬μš© ν•„μš”
19deep_ratio수면 단계 도쀑 deep 수면의 λΉ„μœ¨float0 이상 1 μ΄ν•˜0.2[4단계 뢄석] μ‚¬μš© ν•„μš”
20time_in_unstable_breath호흑 λΆˆμ•ˆμ • κ΅¬κ°„μ΄μ—ˆλ˜ 총 μ‹œκ°„intseconds2700[호흑 λΆˆμ•ˆμ •] μ‚¬μš© ν•„μš”
21time_in_stable_breath호흑 μ•ˆμ • κ΅¬κ°„μ΄μ—ˆλ˜ 총 μ‹œκ°„intseconds24300[호흑 λΆˆμ•ˆμ •] μ‚¬μš© ν•„μš”
22unstable_breath_ratio수면 단계 도쀑 호흑 λΆˆμ•ˆμ • κ΅¬κ°„μ΄μ—ˆλ˜ μ‹œκ°„μ˜ λΉ„μœ¨float0 이상 1 μ΄ν•˜0.1[호흑 λΆˆμ•ˆμ •] μ‚¬μš© ν•„μš”
23stable_breath_ratio수면 단계 도쀑 호흑 μ•ˆμ • κ΅¬κ°„μ΄μ—ˆλ˜ μ‹œκ°„μ˜ λΉ„μœ¨float0 이상 1 μ΄ν•˜0.9[호흑 λΆˆμ•ˆμ •] μ‚¬μš© ν•„μš”
24estimated_ahi호흑 λΆˆμ•ˆμ • λ ˆλ²¨μ„ νŒλ‹¨ν•˜κΈ° μœ„ν•œ κ°’float29.71[호흑 λΆˆμ•ˆμ •] μ‚¬μš© ν•„μš”
25breathing_pattern호흑 λΆˆμ•ˆμ •μ˜ 단계stringenum
- STABLE
- VERY_STABLE
- UNSTABLE
- VERY_UNSTABLE
STABLE[호흑 λΆˆμ•ˆμ •] μ‚¬μš© ν•„μš”
26sleep_stages수면 단계 리슀트int<2단계 λΆ„μ„μ˜ 경우>
- -1: error
- 0: wake
- 1: sleep

<4단계 λΆ„μ„μ˜ 경우>
- -1: error
- 0: wake
- 1: light sleep
- 2: deep sleep
- 3: REM sleep
0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1[μ‹€μ‹œκ°„ 뢄석] μ‚¬μš©μ‹œ μ˜€ν”ˆ μ„Έμ…˜μ—μ„œ 확인 κ°€λŠ₯
27osa_stages호흑 μ•ˆμ • 단계 리슀트int-1: error
- 0: stable
- 1: unstable
0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 1, 1, 1, 1[호흑 λΆˆμ•ˆμ •] μ‚¬μš© ν•„μš”,
[μ‹€μ‹œκ°„ 뢄석] μ‚¬μš©μ‹œ μ˜€ν”ˆ μ„Έμ…˜μ—μ„œ 확인 κ°€λŠ₯

🚧

μ˜λ£ŒκΈ°κΈ°λ²• μ•ˆλ‚΄

μ„œλΉ„μŠ€ ν™”λ©΄ 및 λ§ˆμΌ€νŒ… μžλ£Œμ— 수면 무호흑증, 무호흑, μ €ν˜Έν‘, AHI λ“±μ˜ μ§ˆν™˜ κ΄€λ ¨ λͺ…칭을 μ‚¬μš©ν•˜λ©΄ μ˜λ£ŒκΈ°κΈ°λ²• μœ„λ°˜μœΌλ‘œ μ²˜λΆ„λ  수 μžˆμ–΄, μ—μ΄μŠ¬λ¦½μ—μ„œλŠ” '호흑 λΆˆμ•ˆμ •'으둜 ν‘œμ‹œν•˜κ³  μžˆμŠ΅λ‹ˆλ‹€. μ˜λ£ŒκΈ°κΈ°λ²• κ΄€λ ¨ν•œ μžμ„Έν•œ λ‚΄μš©μ€ μ‹μ•½μ²˜μ— λ¬Έμ˜ν•˜μ‹­μ‹œμ˜€.