Settings & Configurations

6.1 Settings overview

Purpose: Configure templates, reports, validation rules, and tags to match your clinic’s workflows.

Settings apply at the group level unless otherwise noted.

6.2 Interpretation templates

Interpretation templates define the content of clinical interpretations.

You can:

• Create a new template
• Edit an existing template
• Duplicate a template
• Remove a template
• Import or export templates

Group-based vs. private templates

• Group-based templates are shared across all users in the group.
• Private templates are only visible to the creator.

Use group-based templates to standardize reporting across a clinic.

We strongly suggest removing the default private templates after creating the group templates to avoid duplication and confusion.

How to create a new template

• Tap on create template.
• Select the group to create the new template.
• Assign a template name
• Add header and body for the content.
• You can add as many blocks as needed.
• Click save or save and duplicate to create more templates.

6.3 Report design

Report designs control the layout and content of generated reports.

You can:

• Create custom report designs
• Edit existing designs
• Assign report designs to groups

How to create a report design

• Tap on create report design.
• Select the group you want to create the report.
• Report design template is assigned by default.
• Assign a report design title.
• Click Save

How to further customize your report design

Start with a default template design, including sections such as Overview, Patient Data, Methods, Study Info, Report Template, Signature, Key Metrics, Body Position Statistics, and Signals.

Tailor the report layout and structure to meet specific needs, incorporating your organization's branding, rearranging sections, adding or modifying content, and customizing sleep metrics.

Preview and Validate

Use the Get Sample tool to review and validate the customized sleep report design before finalizing it. This tool allows you to see how the report will appear with sample data and includes error detection mechanisms to ensure quality.

Please note, this tool does not apply for Multi-night reports.

Data Dictionary

Use the data dictionary as a comprehensive reference guide containing a predefined set of sleep metrics and corresponding codes. Insert these codes directly into your report template to include specific sleep metrics.

Data dictionary expansion: Building Multi-night Reports

Adding Sequential Night Metrics

To visualize metrics for individual nights:

1. Select the metric you want to display.
2. Add the night-specific extension: -1, -2, etc., to indicate which night the value corresponds to.

Example:

Base Metric	Extension	Description
<AHI3%>	<AHI3%-1>	AHI 3% for night 1.
<AHI3%>	<AHI3%-2>	AHI 3% for night 2.
<AHI3%>	<AHI3%-3>	AHI 3% for night 3.

Adding Aggregate Metrics

To show calculations across multiple nights:

1. Select the base metric you want to aggregate.
2. Add the appropriate extension:

Available Aggregations:

• -Avg → average across nights.
• -Sum → sum of all nights.
• -Min → minimum value among the nights.
• -Max → maximum value among the nights.

Example:

If using <AHI3%> as the base metric for a 3-night report:

Base Metric	Extension	Description
<AHI3%>	<AHI3%-Avg>	Average AHI 3% across 3 nights.
<AHI3%>	<AHI3%-Sum>	Total AHI 3% for 3 nights.
<AHI3%>	<AHI3%-Min>	Minimum AHI 3% among 3 nights.
<AHI3%>	<AHI3%-Max>	Maximum AHI 3% among 3 nights.

FAQs

What happens if I include fewer nights than expected in the report?

The system calculates aggregates based on available sessions. For sequential values referencing a missing night, you’ll see “No Data”.

What happens if I don’t specify a night when using a multi-night report?

If you use a tag like <AHI3%> without a night extension, the system will display “No Data” in multi-night reports.

Can I mix sequential and aggregate metrics in the same report?

Yes! You can combine both types to offer providers a fuller picture.

Is there a limit to the number of nights I can include in the report?

We recommend keeping it to 10 nights or fewer to maintain readability and performance.

Multi-Night Report Examples

This folder includes sample reports that demonstrate how to use sequential and aggregate metrics in real multi-night scenarios.

https://drive.google.com/drive/folders/1h46tqO9DNHkb3cGDoPe9kOGW6DYO-7pB?usp=sharing

6.4 Study validation

Study validation rules help ensure data quality before interpretation.

Minimum valid recording time

• Set the minimum required recording time for a session.
• Default to 4 h.
• Sessions below this threshold will be flagged but they are still able to be interpreted.
• Patient in the app is warned when they stop the study before threshold.
• Validation rules apply per group.

6.4 Tags

Tags help organize patients, sessions, and orders.

How to create a new tag

• Tap create tag
• Select the group where that tags will be applied
• Select a color to further help organization efforts
• Click save

By clicking the 3 dots you can delete the created tag.

Best practices

• Use short, descriptive names.
• Avoid duplicate or overlapping tags.
• Align tags with workflows (e.g., “Follow-up”, “QA”, “Pending review”).

Tagging Patients

Tags help organize patients and support workflows.

You can:

• Add or remove tags directly from the patient list.
• Filter patients by tag.

Common use cases:

• Follow-ups
• Internal workflows
• Titration