These docs are for v1.0. Click to read the latest docs for v3.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 Name

Definition

Type

Value

Example

Plan

1

start_time

수면 츑정이 μ‹œμž‘λœ μ‹œκ°

string

YYYY-MM-DDThh:mm:ss

2022-08-01T00:00:00+09:00

[μ‹€μ‹œκ°„ 뢄석] μ‚¬μš©μ‹œ μ˜€ν”ˆ μ„Έμ…˜μ—μ„œ 확인 κ°€λŠ₯

2

end_time

수면 츑정이 μ’…λ£Œλœ μ‹œκ°

string

YYYY-MM-DDThh:mm:ss

2022-08-01T08:00:17+09:00

3

sleep_time

μž λ“€κΈ° μ‹œμž‘ν•œ μ‹œκ°

string

YYYY-MM-DDThh:mm:ss

2022-08-01T00:30:00+09:00

4

wake_time

μž μ—μ„œ κΉ¨μ–΄λ‚œ μ‹œκ°

string

YYYY-MM-DDThh:mm:ss

2022-08-01T07:30:00+09:00

5

sleep_latency

수면 μΈ‘μ • μ‹œμž‘ ν›„ μž λ“€κΈ° κΉŒμ§€ κ±Έλ¦° μ‹œκ°„

int

seconds

1800

6

wakeup_latency

μž μ—μ„œ κΉ¨μ–΄λ‚œ ν›„ 수면 츑정을 μ’…λ£Œν•˜κΈ°κΉŒμ§€ κ±Έλ¦° μ‹œκ°„

int

seconds

1800

7

sleep_efficiency

수면 μΈ‘μ • μ‹œκ°„ 쀑 μ‹€μ œλ‘œ μž λ“  μ‹œκ°„μ˜ λΉ„μœ¨

float

0 이상 1 μ΄ν•˜

0.84

8

time_in_bed

수면 μΈ‘μ • μ‹œμž‘ μ‹œκ°λΆ€ν„° 수면 μΈ‘μ • μ’…λ£Œ μ‹œκ° κΉŒμ§€μ˜ μ‹œκ°„

int

seconds

28800

9

time_in_sleep_period

수면 μΈ‘μ • μ‹œκ°„ 쀑 수면 μΈ‘μ • μ‹œμž‘μœΌλ‘œλΆ€ν„° μž λ“€κΈ° κΉŒμ§€ κ±Έλ¦° μ‹œκ°„κ³Ό μž μ—μ„œ κΉ¨μ–΄λ‚œ ν›„λ‘œλΆ€ν„° 수면 츑정을 μ’…λ£Œν•˜κΈ°κΉŒμ§€ κ±Έλ¦° μ‹œκ°„μ„ μ œμ™Έν•œ μ‹œκ°„
(time_in_bed - sleep_latency - wakeup_latency)

int

seconds

27000

10

time_in_sleep

수면 μΈ‘μ • μ‹œκ°„ 쀑 μ‹€μ œλ‘œ 수면 μ€‘μ΄μ—ˆλ˜ μ‹œκ°„
이 μ‹œκ°„μ΄ deep, light, rem의 3λ‹¨κ³„λ‘œ ꡬ뢄됨

int

seconds

24300

11

time_in_wake

수면 도쀑에 κΉ¬ μ‹œκ°„

int

seconds

2700

12

time_in_rem

수면 단계가 rem 으둜 μ§„ν–‰λœ 총 μ‹œκ°„

int

seconds

13500

[4단계 뢄석] μ‚¬μš© ν•„μš”

13

time_in_light

수면 단계가 light 둜 μ§„ν–‰λœ 총 μ‹œκ°„

int

seconds

5400

[4단계 뢄석] μ‚¬μš© ν•„μš”

14

time_in_deep

수면 단계가 deep둜 μ§„ν–‰λœ 총 μ‹œκ°„

int

seconds

5400

[4단계 뢄석] μ‚¬μš© ν•„μš”

15

sleep_ratio

수면 단계 도쀑 κΉ¨μ§€ μ•Šκ³  μž” μ‹œκ°„μ˜ λΉ„μœ¨

float

0 이상 1 μ΄ν•˜

0.9

16

wake_ratio

수면 단계 도쀑 쀑간에 κΉ¬ μ‹œκ°„μ˜ λΉ„μœ¨

float

0 이상 1 μ΄ν•˜

0.1

17

rem_ratio

수면 단계 도쀑 REM 수면의 λΉ„μœ¨

float

0 이상 1 μ΄ν•˜

0.5

[4단계 뢄석] μ‚¬μš© ν•„μš”

18

light_ratio

수면 단계 도쀑 light 수면의 λΉ„μœ¨

float

0 이상 1 μ΄ν•˜

0.2

[4단계 뢄석] μ‚¬μš© ν•„μš”

19

deep_ratio

수면 단계 도쀑 deep 수면의 λΉ„μœ¨

float

0 이상 1 μ΄ν•˜

0.2

[4단계 뢄석] μ‚¬μš© ν•„μš”

20

time_in_unstable_breath

호흑 λΆˆμ•ˆμ • κ΅¬κ°„μ΄μ—ˆλ˜ 총 μ‹œκ°„

int

seconds

2700

[호흑 λΆˆμ•ˆμ •] μ‚¬μš© ν•„μš”

21

time_in_stable_breath

호흑 μ•ˆμ • κ΅¬κ°„μ΄μ—ˆλ˜ 총 μ‹œκ°„

int

seconds

24300

[호흑 λΆˆμ•ˆμ •] μ‚¬μš© ν•„μš”

22

unstable_breath_ratio

수면 단계 도쀑 호흑 λΆˆμ•ˆμ • κ΅¬κ°„μ΄μ—ˆλ˜ μ‹œκ°„μ˜ λΉ„μœ¨

float

0 이상 1 μ΄ν•˜

0.1

[호흑 λΆˆμ•ˆμ •] μ‚¬μš© ν•„μš”

23

stable_breath_ratio

수면 단계 도쀑 호흑 μ•ˆμ • κ΅¬κ°„μ΄μ—ˆλ˜ μ‹œκ°„μ˜ λΉ„μœ¨

float

0 이상 1 μ΄ν•˜

0.9

[호흑 λΆˆμ•ˆμ •] μ‚¬μš© ν•„μš”

24

estimated_ahi

호흑 λΆˆμ•ˆμ • λ ˆλ²¨μ„ νŒλ‹¨ν•˜κΈ° μœ„ν•œ κ°’

float

29.71

[호흑 λΆˆμ•ˆμ •] μ‚¬μš© ν•„μš”

25

breathing_pattern

호흑 λΆˆμ•ˆμ •μ˜ 단계

string

enum

  • STABLE
  • VERY_STABLE
  • UNSTABLE
  • VERY_UNSTABLE

STABLE

[호흑 λΆˆμ•ˆμ •] μ‚¬μš© ν•„μš”

26

sleep_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

[μ‹€μ‹œκ°„ 뢄석] μ‚¬μš©μ‹œ μ˜€ν”ˆ μ„Έμ…˜μ—μ„œ 확인 κ°€λŠ₯

27

osa_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 λ“±μ˜ μ§ˆν™˜ κ΄€λ ¨ λͺ…칭을 μ‚¬μš©ν•˜λ©΄ μ˜λ£ŒκΈ°κΈ°λ²• μœ„λ°˜μœΌλ‘œ μ²˜λΆ„λ  수 μžˆμ–΄, μ—μ΄μŠ¬λ¦½μ—μ„œλŠ” '호흑 λΆˆμ•ˆμ •'으둜 ν‘œμ‹œν•˜κ³  μžˆμŠ΅λ‹ˆλ‹€. μ˜λ£ŒκΈ°κΈ°λ²• κ΄€λ ¨ν•œ μžμ„Έν•œ λ‚΄μš©μ€ μ‹μ•½μ²˜μ— λ¬Έμ˜ν•˜μ‹­μ‹œμ˜€.