Support Apnea Board & OSCAR  

Beginner's Guide to SleepyHead

From Apnea Board Wiki
Revision as of 02:36, 29 August 2015 by SuperSleeper (talk | contribs) (Important preferences settings)
Jump to: navigation, search

Cleanup.png

Admin Note: RobySue's Beginner's Guide to SleepyHead was originally posted on the Apnea Board Forum. During an update of our forum database on August 25, 2015, those original posts were lost. This wiki article is on ongoing project to reconstruct the information in those posts from existing caches of our forum.


This article is still under construction, so please have patience with us.


If you have a question about the SleepyHead software, please post your question in Apnea Board's Software Support forum


Contents

Installing SleepyHead

by RobySue (edited 6/20/2014)

Step 1. Download SleepyHead

You can download SleepyHead from the the folowing link: http://www.sleepfiles.com/SH2/ You may need to scroll down to find the links to both the Mac and Windows versions of SleepyHead. They're in the first box under "SleepyHead News"

Step 2. Installing SleepyHead

For Macs: The downloaded SleepyHead-20140622-MacOSX-0.9.6-testbuild-Qt5.3.0.dmg should open up as a "Volume" and you simply drag the SleepyHead icon to your Applications folder. Once the application has been copied to the Applications folder, it's useful to drag it to the Dock so that launching SleepyHead is easy.

For Windows: The download comes as a zip file named SSleepyHead-20140623-Win32-0.9.6-testbuild-Qt5.3.0-BrokenGL-WinXP-MinGW. It doesn't have an installer. You need to save the file somewhere you can remember and unzip it. In order to run SleepyHead, you have to go into the unzipped SH folder and click on the SleepyHead application.exe file to launch the program. While you are in the unzipped SH folder, you can create a shortcut for future use so you don't have to go into the folder each time. I suggest right click mouse on the SleepyHead.exe file and choose "pin to start menu" or "pin to taskbar" for easy access.

For Linux machines: There are several different Linux packages available. They are stored in the Releases folder on the Sourceforge site. You can find them by going to https://sourceforge.net/projects/sleepyhead/files/Releases/Linux/ . Select the appropriate package for your particular linux machine. Install the software in the normal way for your system. NOTE: I have NOT installed SH on a Linux system, and I don't know how well the packages work. Most Linux users know their way around their system however, and are not newbies when it comes to downloading software.

Additional Notes

SH works on Macs running most modern OSX systems without any problems. On Windows machines, SH 0.0.6 should install cleanly on anything from XP through Windows 8.1. If you run into problems with installing on Mac, I should be able to help. If you run into problems installing on a Windows machine, you'll have to hope someone else can help you. If you run into problems installing on Linux, well, you're on your own or you should know enough to get help from the resources page at SourceForge.

NOTE: Future versions of SleepyHead will probably NOT run on XP, Vista, or Mac OS X 10.6. These operating systems are no longer officially supported by their creators, and and users of these operating systems are running a great security risk if they use them online.

Final NOTE: If you find mistakes in what I've written OR if you have suggestions on cleaning up the language, please PM me instead of posting a reply. And I'll edit this post after getting the PM. That way this thread won't get cluttered with a lot of replies that make it hard for people to find the information they are looking for.

Running SleepyHead for the first time

by RobySue (edited 6/22/2014)

First time users of SleepyHead are sometimes confused about what they have to do when they open up Sleepy Head for the very first time.

Creating a Profile

When you first open up SleepyHead, you will be asked to create a profile. The process is pretty straightfoward, but you do have to do it before you can use SH to download your data. The first page of the Profile builder looks like this:

Profile zpsc00048a0.jpg


If you are using a PR machine, the most important part of the profile is to make sure you get the time zone correct on this first page. SH uses the time zone information to take the timestamps on the data and adjust it to local time if your machine uses GMT when recording the data. It's also important to remember to check the Daylight Savings time box if appropriate. If you make a mistake, you can edit the profile later. But it is easier to get the time right when you are creating the profile.

Once the profile is finished and saved, SleepyHead will display a blank page that looks like this:

Splash page zps8cf763aa.jpg


As the page says, it's reasonable to click on Preferences and double check somethings first. If you need help, jump to 7. Important preference settings

The main point here is that if you start clicking around looking for your data, it won't be there. You still have to download (or import) the data into SleepyHead.

Importing Data into SleepyHead the FIRST time

Put the SD card into the SD slot if you have not already done that. If your computer does not have an SD slot, you will need to buy a generic SD card reader and put the SD card in that.

WARNING: It's wise to make sure the card is locked if you are using a Mac or a Windows 8.1 machine since these operating systems will write hidden files to unlocked cards. And the Resmed S9 machines will reject SD cards with any extra files written on them.

Once the card has been mounted to the computer system, you still need to import the data into SleepyHead. There are three different ways to Import the data:


  1. The Import Icon on the sidebar. Click this and it starts the import process.
  2. The Import Data under the File submenu. Select this from the standard File menu in the usual way for your system and it starts the import process.
  3. The keyboard shortcut. On a Windows machine you can simply press the F2 key and that will start the import process.


The Import Data menu item and the Import Icon are circled in the screen shot below.


ImportData zps7cd64788.jpg


If you are using SleepyHead 0.9.5 and 0.9.6 and your SD card is in the SD slot or card reader, once you click on Import Data, you will get a small pop up dialog box that looks this:


SH-096-dialog box zpsd18c401e.jpg


Click "Yes", and the data should load. After the initial data import, SleepyHead should display your data in a screen that shows the Statistical Data. It looks like this:


Sucessful data download zpscafe2b33.jpg


Clicking on the Daily tab in the SleepyHead window brings up the Detailed Daily Data for the last day of data:

DailyData zpsd4876708.jpg


Clicking on the Overview tab in the SleepyHead window brings up the bar graph data for the last year of data: Image has been scaled down 25% (777x546). Click this bar to view original image (1024x719). Click image to open in new window.

Overview-data zps11f6c863.jpg


NOTE: I'm using one of my hubby's data cards that has limited data on it, and that's why all the overview data is at the far right of the screen: I didn't import any detailed data that was older than June 6, 2014.

Importing Data into SleepyHead AFTER the first time

Each time you want to import data into SleepyHead you go through the same basic process, except you don't have to create the profile:

Step 1. Open SleepyHead

SleepyHead will bring up a list of profiles for you to chose from. For most people, there will only be one name on the profile. Highlight the desired profile and press the Select User button. The data for that profile will load into SleepyHead and the Statistics page should load.

Step 2. Make sure the SD card is in the SD slot or card reader.

It's wise to make sure the card is locked if you are using a Mac or a Windows 8.1 machine since these operating systems will write hidden files to unlocked cards. And the Resmed S9 machines will reject SD cards with any extra files written on them.

Step 3. Import the Data

Once SleepyHead loads the data for the selected Profile and the SD card is mounted, you import the (new) data by either pressing the Import icon, using the File menu to select Import Data, or the keyboard shortcut---pressing the F2 key. The Import dialog box will appear and if you are importing from the After the first data importation, you can import the data regardless of which data view you are looking at. If you import data while in the Daily Data view, the Daily Data will jump to the last day of imported data after the data is successfully imported.


Additional Notes

1) The process for importing the data is easy once you get used to it.

2) You need to remember to properly unmount the SD card from your computer before removing it from the SD slot or card reader. You unmount the SD card the same way you unmount a flash drive or an SD card from a digital camera.

3) You need to remember to put the card back into your PAP machine. This is particularly true for Resmed users: All the detailed data is written directly to the SD card, and if there is no SD card, that data is lost. And SH will report that there is no data for the night. (ResScan will be able to report on the summary data that is stored in the S9's memory and then written to the card when it is inserted into the machine.

Basic SleepyHead Organization

When you are first learning how to use SleepyHead, it helps to have a basic understanding of the organization of each of the data views are available in SleepyHead.

Basic Parts of the SleepyHead Window in All Views When you start SleepyHead and select the profile you want to use, SleepyHead opens up the Statistics page, which is as good of a place to start as anywhere else for looking at the overall organization. Here's a marked up copy of what you see on a Mac:

MainParts zps0bd778ce.jpg

The Main Menu on Windows is at the top of the SleepyHead window (like the Main Menu for any other application). It's a pretty standard main menu.

The Navigation Bar is always visible and it's always in the middle of the top part of the window. Clicking each button on this Navigation changes the data. We'll examine each of the data views in more detail in later posts.

The Right Sidebar duplicates the Navigation bar AND adds an Import icon that can be used to start the import data process talked about in 2. Running SleepyHead for the first time. I usually find that the Right Sidebar takes up a lot of real estate on my laptop. You can turn the Right Sidebar off by pressing the F8 button on the keyboard. (On a Mac you may have to use Shift-F8 depending on how you have your function keys set up.) The Main Menu---a closer look

The Main Menu has four submenus:


  • File
  • View
  • Data
  • Help

On the Mac, the SleepyHead menu is a standard "Application" menu with the standard things, including "Preferences" and "Quit SleepyHead. Windows applications don't have this "Application" menu. The File menu

The File menu looks like this on a Mac:

File menu zps887eda61.jpg

In Windows, the File menu looks much the same except that it also contains "Preferences" and "Exit" as menu options. (These are under the SleepyHead menu on the Mac.)


For a new SleepyHead user, the most important options on this menu are the "Import Data" and "Edit Profile". In Windows, add "Preferences" to that list. For now you can ignore the other options under the File menu.
The View menu The View menu looks like this on both a Mac and a Windows machine:

View menu zpscc9f50c7.jpg

It's important to keep "Link Graph Groups" checked. As long as that's checked, when you zoom in on one of the daily graphs, all the daily graphs will zoom in the same amount. That's very useful when you need to look at more than one graph to see what's going on.

Unchecking "Right Sidebar" will make the Right Sidebar disappear, which gives the graphs in the Daily view more room.

"Fullscreen Toggle" is self explanatory. If you are working on a laptop, that's often an important thing to know about.

"Take Screenshot" is also self explanatory. In earlier versions of SH, this was really buggy. It seems to work much better in SH 0.9.5 and 0.9.6. On a Mac, SH will tell you where the screenshot was saved to. On my very small netbook running Windows 7, it's not completely clear whether "Take Screenshot" works and it does NOT tell me where it tries to save the screenshot.


The Data menu The Data menu looks like this on a Mac:
Data menu zps87dfda23.jpg

The Windows menu is very similar, but has a few differences. For a new user of SleepyHead, the only item on this menu that you may need is the Purge CPAP data options under the Advanced menu item. When Zeo was still in business, a lot of us were using Zeos as well as CPAPs. And Import Zeo data was (and remains) a way to get Zeo data into SleepyHead. It does require doing somethings on the Zeo side to make the import run smoothly.


I don't use an oxymeter, and hence I've never needed the Rebuild Oximeter Indices. If you plan on using SH with an oximeter, you will need to ask others about problems you encounter.


Parts of the Daily data window

The format of the Statistics and Overview pages is straightforward. But it's worth looking at the pieces of the Daily Data window as part of the basic organization in SleepyHead. Here's a typical Daily data window for a PR System One Auto:

Daily parts zpsee91cb1c.jpg


The window has four major parts:


  • The calendar in the upper left corner
  • The Left side bar below the calendar with numerical data
  • The detailed daily graphs in the middle of the window
  • The Right Sidebar, which can be turned off in order to give the graphs more horizontal room.

We'll look at each of these parts except for the Right Sidebar in a bit more detail.

The Calendar The calendar allows you to both identify what day's data you're looking at:

Calendar zps58efc78a.jpg

If you click on a date in the calendar, the daily data for that date loads into the daily data window. It's also important to understand that the data for June 20, 2014 is the data for the NIGHT that started on June 20, 2014 and ended on the morning of June 21, 2014. And that's true regardless of whether you get to bed before midnight.

Now look at the little arrows in the calendar. The two arrows in green circles on the bar with the month's name allow you to navigate around the calendar without changing the data in the graphs. This makes it faster to get to a certain day you know you want to look at when it's not in the current "month". The two arrows that surround the bubble with the highlighted date for the daily data move one day backward or forward in data. The third outside arrow on the far right will immediately jump to the last date with data.

Pressing the downward triangle between the month and the year allows you to quickly change to a different month. Clicking the year allows you to quickly change to a different year. That helps if you need to jump to a date that is fairly far from the one you are currently looking at.

Pressing the upward facing arrow in the bubble with the the date in it will hide the calendar and change that triangle to a downward facing triangle. Clicking the downward facing triangle will unhide the calendar. Hiding the calendar is useful if you want more room for the Left Sidebar data.

The Left Sidebar The Left Sidebar has both summary data and statistical data for the given date. Typically you need to scroll down to see all the data. Here's a picture that shows the top part of the Left Sidebar:

Left sidebar top zpsb64da2be.jpg



And here's a picture showing the bottom part of the Left Sidebar:

Left sidebar bottom zpsa1381cb7.jpg

Tips on how to interpret all this data can be found in 4. Basic data interpretation: Daily Detailed Data. The organization of the Left Sidebar is what we're interested in here.

The top of the Left Sidebar is the summary efficacy data for the night. Below that is a pie chart that give the relative sizes of each of the major types of events scored by the machine. The pie chart can be turned off if you want.

Below the pie chart is the statistical data for pressure, leaks, and respiratory data that may not be of much interest, particularly if you are just starting out.

Below the statistical data is some summary data about the machine's settings for the night and the session data. This data is from hubby, so the session data is pretty boring: He typically turns the machine on, goes to sleep, and doesn't wake up until morning. My session data is much more interesting due to my insomnia.


The daily detailed graphs The daily detailed graphs lie in the middle of the Daily data window. These are the graphs that the experienced posters keep referring to when we're asking for more specific information about what your graphs look like.


Here's a close up of the top of the graphical data:

Graphs1 zpsffe4b21d.jpg


The top chart is the Events chart. The Events chart gives a snapshot of just how good or bad the night was. (Hubby had a really good night on this night.) In SH 0.9.5 and 0.9.6, this chart is pinned to the top of the detailed data graphs and it will NOT scroll out of view when you scroll down to look at more graphs. It's best to leave the Events chart pinned since it serves as a navigation guide: The Events chart does not zoom in with the rest of the graphs.

The Flow Rate graph is often called the wave flow data. When you zoom in on this graph you can see a trace of every breath you took all night long.

The labels on the rest of the graphs are self-explanatory once you know the jargon. We'll talk about that in a later post.

Scrolling down reveals additional daily data graphs:

Graphs2 zps1a38e585.jpg

The particular graphs that you will see in SH depends on the machine you are using and whether you have turned any of the available graphs "off". We'll talk about that in later posts.

That gives a pretty complete picture of the overall organization of the data in SleepyHead. So you should now be able to find things pretty quickly. Understanding that data will take up a series of later posts.


Basic data interpretation: Daily Detailed Data

The amount of data available in SleepyHead can be overwhelming to new PAPers, particularly those who only want some reassurance that "things are working." While many newbies tend to focus on the data in the Statistics tab and the Overview tab, the data in the Daily tab is usually more useful when you are trying to analyze what's going well and what's not going so well during the CPAP adjustment period. Moreover, the Daily Detailed Data is currently more robust and less buggy than the data presented in the Statistics tab. So I would encourage new SleeyHead users to first concentrate on getting comfortable with their detailed Daily data. Even so, you want to look at the detailed Daily data in context: One bad night does not mean things are suddenly not working; a month of bad nights does indicate something is wrong.

I am most familiar with how the daily data looks for Resmed and PR machines. So I focus on those machines in this post, but much of what I write applies to the data SleepyHead shows for any of the machines that it supports.

I am also going to try to restrict myself to the most basic, important data for a newbie to concern themselves with. This post reflects my own tastes in what data I tend to pay attention to on a regular basis. As a mathematician, I have a strong preference for the graphical data in the Daily Data window.

Left Side Bar data---AHI and event data table Recall the Left Side Bar of the Daily data looks like this:

LeftSideBar zps5909a752.jpg


The single most important piece of numerical data is the AHI data. The goal of PAP therapy is to keep the AHI down below 5 night after night after night ...

If your AHI looks good and your leak data is acceptable, then the PAP machine is doing its job. Whether that's enough to make you feel great is another issue, but the machine is doing its job.

Under the AHI banner we see the indices for all the various types of "events" that might be recorded during the night. In other words, the line that says


Obstructive Apnea 0.39

means that my OAI = 0.39 on this night. In other words

OAI = (number of OAs scored)/(run time) = 0.39

on this night.

If a particular type of event is not present in this table either your machine doesn't record them OR you didn't have any of those events on that night.

If your AHI is still too high and you ask folks on the forum about it, people will ask you about the distribution of events. They want to know what the OAI, the HI, and the CAI are. Note that

AHI = OAI + HI + CAI

In general the advice people will offer you about what to do about an AHI that is too high will depend on what the OAI and CAI look like. NEW in SleepyHead 0.9.6: Large Leak Summary Data For PR System One users, if you have any official Large Leaks, SleepyHead 0.9.6 will report the percentage of time spent in Large Leak territory with the other summary event data. This should make it easier for PR System One users to figure out whether their leaks are are significant enough to adversely affect therapy.

Percentage time in Large Leak for users of other machines will NOT appear with the AHI data above the pie chart.

The pie chart at the end of the index data gives a quick visual impression of what kind of events were most common. On this night I had far more FLs than any other kind of scoreable event.

Note: Resmed machines record the snore data and flow limitation data as a continuous graph, so there will be NO snore data or flow limitation data on this table. RERAs are only scored by PR System One machines. IMPORTANT NOTES about PR System One machines:

1) The PR System One machines record two kinds of Snore Data. In SleepyHead they are referred to as VS1 and VS2 data.


  • In Sleepy Head 0.9.6, The Vibratory Snore index shown in the Left Sidebar data is the average number of VS2 per hour. In other words:
Vibratory Snore (index) = (number of VS2 scored)/(run time)
  • In Sleepy Head 0.9.3, The Vibratory Snore index shown in the Left Sidebar data is the average number of VS1 per hour. In other words:

Vibratory Snore (index) = (number of VS1 scored)/(run time) The thing is: VS1 snores are scored on a PR machine only if the machine is running in Auto mode. If you are using a PR machine in fixed pressure mode, the SleepyHead 0.9.3 Vibratory Snore index will always be 0.0; but that does NOT imply that you are not snoring.


2) The Flow Limitation data is recorded on a PR machine only if the machine is running in Auto mode. If you are using a PR machine in fixed pressure mode, the Flow Limitation index will be 0.0; but you can't assume that means you are not having any flow limitations.

Left Sidebar Data---Statistical Data chart This is located directly below the Pie Chart. Let's look at it more closely:

LeftSideBar-Stats zps8015d40f.jpg

Med (Median) and 90% (or 95%) are statistical terms. The median value for a given set of data is the halfway point: Half the data is AT or BELOW the median value; half the data is AT or ABOVE the median value. The 90% value is the data value for which 90% of the data is AT or BELOW the value and 10% of the data is AT or ABOVE the value. Both Median and 90% are explained very carefully in my blog post Average, Median, 95% numbers: A guide to those who don't remember their introductory stats

Of all the numbers in this table, the most important ones are the Pressure numbers and the Leak and Total Leak numbers. All the other numbers in this table can safely be ignored.

I use a BiPAP and that's why I have both an IPAP and and EPAP line. I also use a PR machine, so that's why I have both Leak and Total Leak data. Users of a S9 Elite or AutoSet will see both lines for both pressure and EPAP, where the EPAP data equals Pressure - EPR. Resmed users will NOT have a line for Total Leak data since the S9 records only the unintentional leak data.

The EPAP line of the table looks like:

EPAP 4.00 4.00 4.00 5.00

This means that my minimum EPAP =4, my median EPAP = 4, my 90% EPAP = 4, and my max EPAP = 5. What this tells me is that my EPAP stayed at 4cm for at least 90% of the night. But my EPAP did get as high as 5cm at some point during the night.

The IPAP line of the table

IPAP 6.00 6.00 8.00 8.00

means that my minimum IPAP = 6, my median IPAP = 6, my 90% EPAP = 8, and my max IPAP = 8. That means that my IPAP stayed at 6cm for at least 50% of the night and my IPAP was LESS THAN or EQUAL to 8 cm for 90% of the night. From this data, we can't tell if my IPAP = 8 for almost 50% of the night or if my IPAP = 8 for only about 10-15% of the night.

Statistical Leak Data The most important data in statistical data is the Leak data. Because I use a PR System One, there are two lines of leak data and they look like this:

Leak Rate 0.00 0.00 10.00 14.00 Total Leaks 11.00 14.00 23.00 34.00

The Leak Rate numbers are SH's statistical "guess" about what my unintentional leak rate is. This number is NOT an official Encore number and it does not come directly from the data on my SD card; it is calculated from the Total Leak rate data that is recorded on the SD card.

The Total Leaks line is the statistical summary of the (raw) leak data. In some sense this may be more trustworthy for people using machines that record total leaks.

And the meaning of the numbers? My median (unintentional) leak rate is 0.0 L/min, my 90% (unintentional) leak rate is 10.00 L/min, and my maximum (unintentional) leak rate is 14.00 L/min. This means:

  • For at least 50% of the night, my unintentional leak rate was 0.0 L/min; in other words for at least 50% of the night, I had no detectable unintentional leaks
  • For 90% of the night my leak rate was at or BELOW 10.00 L/min and for at most 10% of the night my leak rate was ABOVE 10.00 L/min
  • Since my maximum leak rate was 14 L/min, I know that for at most 10% of the night my leaks were between 10 L/min and 14 L/min.

These Leak numbers are pretty good numbers for a PR System user.

The Total Leak numbers confirm that my leaks are pretty well under control: My minimum total leak rate was 11.00 L/min; my median total leak rate was 14.00 L/min; my 90% total leak was 23.00 L/min; and my maximum total leak rate was 34.00 L/min. At the pressures I use the expected leak rate for my mask is about 20-29 L/min. So these numbers look very good: For 90% of the night my total leak rate was AT or BELOW 23 L/min, which is right around the expected leak rate for my mask.

NEW in SleepyHead 0.9.6: Time over leak redline

For Resmed S9 users, SleepyHead 0.9.6 will report the percentage of time when the Leaks are over the Resmed RedLine at 24 L/min at the end of the Statistical data under the Pie Chart. This should make it easier for Resmed S9 users to figure out whether their leaks are are significant enough to adversely affect therapy. Users of other PAP machines will not have this line in their Daily Data report.

Part I: Are my leaks bad enough to worry about? Interpreting the statistical leak data

If you use a PR System One or a Resmed S9, SleepyHead will show you the percentage of time your leaks were in Large Leak territory for your machine. This will help you evaluate whether or not your excess leaks are both large enough and long enough to adversely affect your therapy. A small amount of time in Large Leak territory can be ignored if your leaks are under control for most of the night; a large amount of time in Large Leak territory cannot be ignored.

The question, of course is how much time in Large Leak territory is too much? Resmed provides a guideline for its users: Mr. Red Frowny face shows up on the Sleep Quality Report if your leaks are above the Redline for at least 30% of the night. When the Large Leaks last that long, Resmed's engineers believe both efficacy of the PAP therapy and the accuracy of the recorded data can be adversely affected. We will assume that 30% of the night in Large Leak territory is clearly bad news for users of any PAP machine. But many people may find that their therapy begins to be compromised by the time Large Leaks make up 20% of the night. For a lot more information on leaks, see 8. Leaks.

If you are using a DeVilbass Intellipap or an F&P Icon or if you are using SleepyHead 0.9.3 or earlier, then you will need to use the median and 90% (or 95%) Leak/Total Leak data to evaluate your leaks.

In order to make sense of the statistical numbers shown on the Leak Rate and Total Leaks lines, you need to know how the manufacturer of your machine defines Large Leak. Information about how Resmed, F&P, DeVilbass define Large Leak can be found in 8. Leaks. PR does not have a published "line" for defining Large Leak on the System One machines, but there are patterns that have been noticed in the PR data. That information is also talked about 8. Leaks.

In general: If your maximum Leak or Total Leak data is well under the official Large Leak definition for your machine, then you know you do NOT have any leaks that are large enough to clearly affect the efficacy of your therapy or the accuracy of your data.

If your 90% (or 95%) Leak or Total Leak data is well under the official Large Leak definition for your machine, but the maximum Leak or Total Leak data is over the Large Leak line for your machine, then you have a few, probably short lived Large Leaks. At most your leak was in Large Leak territory for no more than 10% (or 5%) of the total night. Unless all the time in Large Leak territory is in one prolonged Large Leak, chances are your Large Leaks are NOT long enough to have an adverse affect on your therapy.

If your median Leak or Total Leak data is well under the official Large Leak definition for your machine, but the 90% (95%) Leak or Total Leak data is near or over the Large Leak line for your machine, then you may have a leak problem that is both large enough and long enough to adversely affect your therapy. On the one hand, we know that your leak was NOT in Large Leak territory for at least 50% of the total night. But the numbers alone don't tell us if you were in (or close to) Large Leak territory for only 10-15% of the night or if you were in (or close to) Large Leak territory for 45% of the night. You really need to examine the leak graph to figure out what's going on. More on that later in this post.

If your median Leak or Total Leak data is close to or above the official Large Leak definition for your machine, then you definitely have a problem with Large Leaks. You are leaking at a very high and signficant rate for at least 50% of the night, and that definitely means that the leaks are both long enough and large enough to adversely affect your therapy and the accuracy of your data.


Important Daily Detailed Graphs The machine you are using will determine exactly which graphs will show up in your Daily Data. But the most important graphs will be present in every machine's data.

In SleepyHead you can temporarily hide unneeded graphs so that they're not in your way; resize graphs so that more of them fit on your screen; and rearrange the graphs so that you can group the graphs you want to look at together. You can also pin selected graphs to the top of the Daily graphs section so they do not scroll out of view. You can also zoom in on particular parts of the data where there is a lot of activity so that you can get a better idea of what might be going on at night. Instructions on how to do all these things can be found in 13. Manipulating Daily and Overview Graphs.

In this post I want to concentrate on which graphs are important, what information they convey, and how they are related to each other.

First a screen shot of my preferred set up of the daily graphs:
Daily-graphs zpscf0763d4.jpg
This screen shot shows the four most important Daily Detailed graphs that are needed to have a clear understanding of your data and what's going on each night.

The Events Table The Events Table is a snap shot that lets you see when all the events occurred and what kind of events they were. By default, the Events table is pinned to the top of the Daily Detailed Data graphs and will not scroll out of site. When zooming in on the other graphs, the Events Table will remain as is, with the zoomed in part of the night highlighted on the events table. So it also provides a useful reference tool for being able to quickly put the zoomed in graphs into the context of the whole night.

The Flow Rate graph NOTE: Resmed S9, PR System One, and F&P Icon machines record Flow Rate data if the card is in the PAP machine during the night; the DeVilbiss IntelliPAP does NOT record Flow Rate data.

The Flow Rate graph is also referred to as the "wave flow" graph. It provides a record of each and every breath you took all night long. At this scale, everything is all run together; the real power in the Flow Rate graph is when you zoom in sufficiently close to start seeing individual breaths and events. Note that each of the events in the event table shows up as a tick mark on the Flow Rate graph (with the exception of the PR System One VS2 tick marks.) The little boxes appearing on my Flow Rate graph are mostly Pressure Pulses that the PR central detection algorithm uses for testing the patency of the airway.

The Pressure graph The Pressure graph shows the therapeutic pressure level throughout the night. Because I'm using a PR BiPAP, the IPAP and EPAP graphs vary independently of each other. The IPAP is the top graph; the EPAP is the lower graph. Resmed Elite and AutoSet users will have two pressure graphs if they have EPR turned on. The top graph is the Pressure setting; the bottom graph, which is label EPAP, shows what EPAP = Pressure - EPR looks like.

If you are using your PAP in fixed pressure mode, the pressure graph is not of much use---unless you are spending a lot of time hitting the ramp button. But if you are using your PAP in Auto mode, the pressure curve tells you when the machine raised the pressure and how much it raised the pressure. Comparing the pressure increases with the events flagged in the Flow Rate curve or the Events Table can give you some very good ideas about why the machine decided to increase the pressure and also give you a sense of whether the disordered breathing got better or worse with the pressure increase.


The Leak Rate graph This graph shows both the Total Leaks (light gold color on top) and the SH calculated (unintentional) Leaks (purple on bottom) because I'm using a PR System One. A Resmed user is only going to see the purple Leaks graph.

I have the Redline option turned OFF because I know my leaks well enough to know that an official Encore LL is going to be scored only if the Total Leak Rate is up near 60 L/min.

This is not my best leak line, but it is a perfectly acceptable leak line for a PR System One BiPAP with IPAP = 8 and EPAP = 4 or 5.

Looking at the Leak graph will allow you to see just how long your worst leaks lasted and just how big they were. When the leak graph looked at along with with the statistical leak data in the Left Sidebar, you can get a very good idea of whether leaks may be adversely affecting your therapy. If you have a wide Auto range, you can track whether increases in pressure are leading to increased unintentional leaking. And when the leak rate is in Large Leak territory, you can often see how the Large Leak affects the ability of the machine to track the breathing, and how that affects the accuracy of the AHI data.

Two other potentially important graphs The Snore graph is sometimes useful to look at, even though no-one knows just what the y-axis numbers actually mean. The reason its useful is that snore graph can sometimes explain a pressure increase when there seems to be nothing unusual going on in the Flow Rate graph.

For Resmed S9 users, the Flow limitation graph is sometimes useful to look at because it can explain a pressure increase in the absence of both snoring and events. High spots on the Flow limitation graph typically correspond to some pretty distorted looking inhalations in the Flow Rate graph. NOTE about Flow Limitation data: The PR machines score FL in a very different way than the Resmeds do, and this means there is no FL graph for a PR machine.

ALL OTHER GRAPHS All the other graphs (the Respiratory Rate, the Tidal Volume, the Minute Ventilation, and so on and so forth) can be ignored by newbies. If there's something really odd in your Flow Rate data, a more experiences forum member may ask you for one of these graphs on occasion. If you're a real data junkie, you may find these graphs interesting, but they usually do not provide much help in figuring out what might be wrong when a newbie is in trouble. These graphs will be discussed in some future post ....


The Event Table---a detailed look The Event table gives a snapshot of how good or bad the whole night was, and whether certain parts of the night were much uglier than the overall AHI might indicate. Compare these two event charts:
Event-charts zpsd5714439.jpg

You don't need the actual AHI numbers to see that the first night was a lot worse than the second. On the second night, there are only three "events" scored all night: Two CAs and one H. There are a few Flow Limitations, which are common in my data), but even the FL are well spaced. And the bit of snoring at the beginning of the night is not a real issue. Overall, this night's efficacy data is really quite good.

But on the first night, there are a lot more tick marks over all AND between 4:15 and 5:30 there are a lot of OAs, Hs, and CAs scored. There's a second smaller cluster of events around 8:30 as well. The other thing we can immediately see about the first night is that outside of the 4:15-5:30 and 8:30-9:00 time frames, the rest of the night was pretty good.

The Event table tells us where to look if we want (a lot) more information about periods with "bad nighttime breathing." On the top night's data, it's worth zooming in on the 4:15-5:30 to see just how ugly things are. When we zoom in on the daily graphs, the Event table remains fixed, but the zoomed in time frame is highlighted as shown:

Zoomed-FREvents zps084eaf37.jpg
The highlighting on the Event table gives a quick visual reference of where the zoomed in data comes from. That's useful if you start scrolling through zoomed in Flow Rate data for a whole night and notice something of interest. In other words, the Event Table serves as a "navigation" tool when you are looking at zoomed in detailed data.

Because the Event Table provides both an overall snapshot of the whole night AND serves as a navigation tool, in SleepyHead 0.9.6, the Event Table's positions is pinned at the top of the Daily Data graphs.

When posting screen shots of zoomed in Daily Data, it is useful to include the Events Table in the screen shot so the others can get a sense of how the selected Detailed Data fits into the night as a whole.


The Flow Rate graph---a detailed look NOTE: Only Resmed S9, PR System One, and F&P Icon machines record Flow Rate data; if you are a DeVilbiss IntelliPAP, you will not have a Flow Rate graph when you look at your data in SH

The Flow Rate graph is a visual record of each and every breath you took while using the machine. You are inhaling when the Flow Rate is positive and you are exhaling when the Flow Rate is negative. Stronger inhalations result in higher (positive) peaks and stronger exhalations result in lower (more negative) valleys in the Flow Rate graph. The events from the Event Table are superimposed on the Flow Rate graph with vertical lines of different colors.

The Flow Rate graph looks quite different depending on how far you have zoomed in on the data. All of the following Flow Rate graphs are from the same night's data:

Fr-all zpsf8767371.jpg

Different information is conveyed by different levels of "zoom" in the Flow Rate graph. More information on the Flow Rate graph can be found in 9. Beyond AHI: Getting specific information about events.

For now I'll just give the following broad guidelines about looking at the Flow Rate graph at differing zoom levels:


  • Full night. This usually doesn't give much more information than just the events table. But sometimes you can get a sense of when you were particularly restless because normal sleep breathing is usually much more shallow than normal wake breathing. If there are a lot of places with really big values for the wave flow, those may indicate restless periods during the night.
  • 60-90 minute windows. These usually let you see what's going on during a full cluster of events, but they usually don't let you see what's going on at the individual breath level. Sometimes you can spot funky breathing patterns that might be indicative of unstable respiration patterns that are common in periodic breathing or potential CO2 undershoot/overshoot cycles; sometimes you can't.
  • 5-20 minute windows. You can see the individual breaths, and for many clusters, a 20 minute window will show you the whole cluster.
  • 30-60 second windows. You can see an individual event, but not much else. Unless you have a question about a specific individual event, zooming in this far usually results in not giving enough context to others to evaluate the data and provide intelligent feedback.


Additional notes about navigating inside the Flow Rate graph These comments apply to ALL the Detailed Daily Data graphs except for the Event Table, but for the most part, you need these tips when you're examining the Flow Rate graph.

1) Zooming and unzooming. You can zoom in on the center of the Flow Rate graph by LEFT clicking when the mouse is over the Flow Rate graph. You can zoom back out by RIGHT clicking when the mouse is over the Flow Rate graph.

2) Scrolling through a Flow Rate graph. Regardless of how far you have zoomed in on the Flow Rate data, you can scroll through the Flow rate graph by holding the RIGHT mouse button down while moving the mouse in a horizontal direction.

3) Glitches Sometimes you run into a SH glitch and the y-axis for the Flow Rate graph is off: The middle part of the breathing cycle is not graphed at 0 L/min. It's a known problem. If this happens to you, the easiest thing to do is just to mentally draw the 0.0 L/min line half way between the peaks and valleys in the Flow Rate graph and use that to measure when you are inhaling and exhaling.


The Pressure graph---a detailed look If you use a CPAP or APAP that is NOT a Resmed S9 Elite or S9 AutoSet, you will only see one pressure curve. If you use a bi-level device OR a Resmed S9 Elite or S9 AutoSet, you will see two curves. The top curve is the IPAP---the pressure setting for inhalations; the bottom curve is the EPAP---the pressure setting for exhalations. (The reason the S9 Elite and AutoSet have two pressure curves is that when EPR is on, the machine acts very much like a bi-level.)

If you are using your PAP in fixed pressure mode, the Pressure graph will be a flat line after the ramp period is over. Hence the Pressure graph provides no useful data and can be ignored. So for this section, I will presume that you are using an auto adjusting machine and that it set to Auto mode.

The primary data you can get off the pressure curve is information about what the machine thinks your pressure needs seem to be for the night. Looking at the Pressure graph and the Flow Graph together allows you to see just how the machine responds to your sleep apnea each and every night. (On a Resmed S9 AutoSet, you might also need to look at the Snore graph and the Flow limitation graph as well.) Common concerns that people have about their Pressure graph Most concerns and questions people tend to ask about the Pressure graph are really about the Pressure graph relates to other parts of the data. Here are some common things people ask about the Pressure graph.

Question: I had an OA and the machine didn't increase the pressure. Why didn't it increase the pressure to blow through the event and open my airway and end the apnea?

Answer: While APAPs and Auto bilevels are designed to respond to OAs with pressure increases, they are NOT noninvasive ventilators and they CANNOT trigger inhalations. (The fancier ASV machines ARE noninvasive ventilators and can trigger inhalations.) If the machine is going to increase the pressure in response to an OA, it will wait until the OA is over and you are breathing again before it increases the pressure.

Moreover, the auto algorithms are designed to NOT respond to isolated OAs and Hs: Unless two or more events happen relatively close to each other (as in within about 2 minutes of each other), an APAP or Auto bi-level machine is programed to NOT increase the pressure. Here's an example of a 20-second OA that my BiPAP Auto ignored on a recent night:

Isolated apnea zpscf3f0501.jpg
You'll note that the machine had been decreasing the IPAP pressure (since my breathing was stable) for several minutes before the OA occurred. Neither my EPAP (which is at its minimum value) nor the IPAP is increased for this particular OA because it's isolated. There's not another OA or H within 2 minutes of this particular OA.

The fact that APAPs and auto bi-levels do not respond to isolated OAs and Hs seems counter intuitive to many new PAPers. But this lack of response is intentional and it mimics the AASM Clinical Guidelines for Manual Titration Sleep Studies. The idea is not to jack up the pressure every time any event happens: That can lead to more unstable breathing, discomfort, and more pressure than is needed to keep the airway open most of the time.

Question: Why is my pressure increasing when there don't seem to be any events?

Answer: APAPs (and Auto bi-levels) increase pressure in response to OAs, Hs, snoring, and flow limitations. The PR System One APAP and BiPAP Auto also increase pressure in response to RERAs. The PR System One also has a "search" routine built into its Auto algorithm, and it will periodically increase the pressure as a "test" to see if the shape of the wave flow improves, even if nothing is being scored. Those test increases show up as saw tooths on the pressure curve. On Resmed machines, the most likely cause for a pressure increase without any events is probably snoring or flow limitations. Here's a picture of a increase in pressure on a Resmed VPAP in response to nothing but flow limitations:

Pressure increases zps4dbeba44.jpg

While this person had a ton of OAs scored early in the night (along with some dramatic pressure increases), the snippet we're looking at here shows two pressure increases in response to activity on the Flow Limitation graph. The second pressure increase starts a bit before 4:10 and doesn't end until a bit before 4:35. In those 25 minutes, the S9 increases the pressure by a full 5 cm without an OA or H in site.


Question: If I'm having a lot of events and my machine is running at or near its maximum pressure setting a lot of the time. Does that mean I need to increase the max pressure?

Answer: It depends.

Looking at the Pressure graph, along with the Flow Rate graph and type of events being scored all come into play in figuring out what might be the best course of action. Sometimes it's pretty easy to tell when a modest increase in either the min or max pressure setting is a reasonable thing to try. But sometimes things are not so simple.

On the one hand, the maximum pressure setting needs to be high enough to effectively prop the airway open during the times when the airway is most likely to collapse. If the maximum pressure is not high enough, the airway will continue to be prone to collapsing off and on throughout the night.

On the other hand, the minimum pressure needs to be high enough where the machine does not need to increase the pressure by a significant amount during the first cluster of events. Sharp rapid increases of 5-8 cm of pressure in 10 minutes might not allow the airway enough time to stabilize and settle down. And unstable breathing can cause further events, which leads to more pressure increases and more unstable breathing.

And then to muddy the waters even further: Approximately 10-15% of PAPers may have a tendency to develop pressure induced central apneas if the pressure setting is too high. And what "too high" is strongly depends on the individual. And while our machines have algorithms to distinguish central apneas from obstructive ones, those algorithms are not perfect, and there is some evidence that the algorithms may be more likely to misscore CAs as OAs when the CAs occur at relatively higher pressures.

So blindly increasing your pressure just because the machine is running at or near your maximum setting all night long is not a good idea. Before you decide to change your pressure settings, you really need to do some careful thinking about what you hope to accomplish by changing the pressure and have a plan on how to evaluate whether the change does what you intend it to do. And keep in mind that it really is a good idea to consult your sleep doc about any changes to your therapeutic settings.

The Leak Rate graph---a detailed look Depending on what machine you are using, the Leak Rate Graph will have either one or two graphs in it.

Resmed machines report only the excess leak rate, which is simply called Leak in the SleepyHead leak data. A Resmed user will see only one leak graph in the Leak Rate graph.

All other major brands of PAPs report Total Leaks, which include both the intentional leak rate for your mask at your pressure AND the excess leaks. In other words:

Total Leak = Intentional Leak + Excess Leak

SleepyHead does a statistical analysis of the Total Leak data for non-Resmed machines to calculate an estimated excess leak rate and reports this estimated excess leak as Leak Rate. This means that users of NON-Resmed machines have two "leak" graphs in the Daily Detailed Data graphs: One for Total Leak (the raw data from the machine) and one for Leak (the SleepyHead estimated excess leak rate).

The top (gold) graph is the Total Leak Rate graph and the bottom (purple) graph is the Leak Rate graph, which shows the SleepyHead estimated excess leak rate.

Defining Large Leaks Different manufacturers have different definitions of what Large Leak means for their machine. But for all brands of machines, the idea is that if your leaks are under the manufacturers Large Leak definition, the machine should be able to gracefully compensate for the leaks and deliver effective therapy and accurate data. Information about how Resmed, PR, F&P and DeVilbass each define Large Leak can be found in 8. Leaks.

Tools to help identify Large Leaks: Show Leak RedLine If the manufacturer of your machine has a published Large Leak definition, you can use the Show Leak Redline option to draw a Red Line on your Leak/Total Leak graph to make it easy to spot when the leaks are high enough to be considered Large Leaks. The Show Leak Redline option is talked about in 7. Important "preferences settings".

A typical SH 0.9.6 Leak graph from an S9 VPAP Auto that shows a night with one long leak that is in or near Large Leak territory is shown below. It's worth noting that the amount of time with the leak rate AT or ABOVE 24 L/min is only about 40 minutes and the total run time for the night was about 8.5 hours; hence Mr. Green Smiley Face showed up the next morning on the S9's LCD.

Redline-resmed zps4f287fff.jpg

Tools to help identify Large Leaks: Large Leak shading for PR System One machines For users of PR System One machines, SleepyHead 0.9.6 will use the Encore Large Leak data to identify parts of the Flow Rate curve that are earmarked as occurring during Large Leaks. The Large Leak will also show up on the LL line in the Events Table as a gray bar and it will show up on the Flow Rate graph as gray background shading. By looking at both the Flow Rate data and the Total Leak line, you can be begin to get a sense of where your PR machine draws the Large Leak line for your mask and your pressures. An example of how SH 0.9.6 flags one of my very rare official Large Leaks is shown below. (This Large Leak has a number of really interesting characteristics, and I wrote a blog post, Anatomy of a Large Leak in Encore and SleepyHead, analyzing exactly what's going on in this leak. )

Large leak flage zps357316c6.jpg

Part II: Are my leaks bad enough to worry about? Interpreting the graphical leak data The Leak Rate graph is the most reliable way of answering the question: Are my leaks both large enough and LONG enough to adversely affect the quality of my therapy and the accuracy of my data?

Loosely, Leak and Total Leak lines can be described as "Great", "Good", "Decent Enough", "Problematic", "Bad", and "Horrible", all of which are based on the amount of time the leaks or total leaks are in Large Leak territory for your particular machine.

Great, Good, and Decent Enough Leak/Total Leak lines In general, a Great Total Leak line will be flat or almost flat and hover somewhere around (or just below) the intentional leak rate for your mask at your pressure. A Good Total Leak line will be "fuzzy" flat, stay mostly around the intentional leak rate for your mask and pressure, but tends to have some visible periods of noticeably higher leaks, most of which stay well below the cut off for "Large Leaks" for the given machine. A Decent Enough Total Leak line has more obvious leaks than a "Good" one does, but line stays below the Large Leak line for at least 70-90% of the night. (There's some debate between PAP users of just how long the Large Leaks need to last before they become problematic.)

For Resmed users or for folks who simply want to concentrate on the (excessive) Leak data, a Great Leak line will be flat or almost flat and hover somewhere around (or just below) 0.0 L/min. A Good Leak line will be "fuzzy" flat, stay mostly around 0.0 L/min, but tends to have some visible periods of noticeably higher leaks, most of which stay below 10-15 L/min. A Decent Enough Leak line has more obvious leaks than a "Good" one does, but line stays below 25-30 L/min for at least 80-90% of the night. (There's some debate between PAP users of just how long the Large Leaks need to last before they become problematic.)

If we look at the Statistical Leak data from the Left Side bar for Great Leak/Total Leak lines and Good Leak/Total Leak lines, the 90% (or 95%) Leak/Total numbers will be under the manufacturer's definition of "Large Leak". The maximum may or may not be under that line.

The Statistical Leak data for a Decent Enough Leak/Total Leak line will have a median Leak/Total Leak number well below the the manufacturer's definition of "Large Leak". The 90% (or 95%) leak numbers, however, may very well be larger than the official Large Leak definition.


Problematic Leak/Total Leak Lines These are leak lines where it's clear that Large Leaks are present during a significant amount of the night, but it's not clear if the Large Leaks last long enough for the machine's manufacturer to say they are a problem.

The manufacturer with the clearest definition of when Large Leaks become long enough to adversely affect the quality of the PAP therapy and the accuracy of the data is Resmed: Resmed's infamous Mr. Red Frowny Face shows up on the machine's Sleep Quality Report when the (excess) Leaks are AT or ABOVE 24 L/min for at least 30% of the night. So we'll assume that if the time in Large Leak is approaching 30% of the entire night, the Large Leaks are problematic.

So a good working notion for a Problematic Leak/Total Leak line would be the following:

A Problematic Total Leak line is one that is NEAR or IN the manufacturer's Large Leak Territory for somewhere between 20-35% of the night; A Problematic Leak line is one that is ABOVE 24 L/min for somewhere between 20-35% of the night. A Problematic Leak/Total Leak line indicates that the leaks may be both long enough and large enough to have an adverse affect on the quality of your therapy and the accuracy of the data.

The Statistical Leak data for a Problematic Leak/Total Leak line will typically have a median Leak/Total Leak number well below the the manufacturer's definition of "Large Leak", but the 90% (or 95%) leak numbers, will be larger than the official Large Leak definition.

If you see a Problematic Leak/Total Leak line every now and then, there's no point in worrying about it. If you see Problematic Leak/Total Leak lines a lot, however, you may want to consider taking measures to address the leak issues.

Bad and Horrible Leak/Total Leak Lines These are leak lines where it's clear that that Large Leaks are present during substantial amount of the night, and it's clear the Large Leaks are both long enough and large enough to adversely affect your PAP therapy.

A working definition of a Bad Leak/Total Leak line is that the leaks are bad enough to trigger a visit from Mr. Red Frowny Face if you were using a Resmed S9: If large leaks make up more than 30% of night, you've got a problem with leaks.

A Horrible Leak/Total Leak line is a leak line where the leaks are totally out of control: If over 50-60% of the night is in Large Leak territory, you've got a Horrible Leak/Total Leak line and a pretty significant problem with leaks.

The Statistical Leak data for a Bad Leak/Total Leak lines may have a median Leak/Total Leak number well below the the manufacturer's definition of "Large Leak", but the 90% (or 95%) leak numbers, will be larger than the official Large Leak definition. If the median Leak/Total Leak number is close to or above the the manufacturer's definition of "Large Leak", then you've got a Horrible Leak/Total Leak line.

Most people don't have random, rare Bad or Horrible Leak/Total Leak lines. Folks who have real leak problems tend to have Bad or Horrible Leak lines on a significant portion of the the nights they use the PAP. If you are seeing multiple Bad or Horrible Leak/Total Leak lines each week, you know you need to do something about the leaks.

A final comment on the connection between the Statistical Leak data and the graphical leak data It is important to note that Decent Enough, Problematic, and Bad Leak/Total Leak lines may all have the same characteristics in the statistical Leak data:

  • The median Leak/Total Leak numbers will be well under the manufacturer's official definition of Large Leak
  • The 90% or 95% Leak/Total Leak numbers will typically be above the manufacturer's official definition of Large Leak.

What separates Decent Enough leaks that you don't need to worry about from Bad leaks that must be fixed is the duration of the large leaks. And knowing the median and 90% leak/total leak rates is just not enough information to tell whether the large leaks lasted about 10-15% of the night (Decent Enough) or whether the large leaks lasted about 40-45% of the night (Bad or Horrible).

If the median Leak/Total Leak numbers look good and the 90% (95%) Leak/Total Leak numbers are in Large Leak territory, you must look at the Leak/Total Leak graphs in order to figure out whether the leaks were both long enough an large enough to adversely affect your therapy.


The AHI Graph This graph is often misunderstood by many new PAPers And because of that, I tend to recommend that new SleepyHead users just ignore this graph.

And yet, many newbies are very interested in this graph. And so in the interest of trying to clear up misconceptions about this graph, I've included it here.

The y-value in the AHI graph gives running count of the number of apneas scored during the last 60 minutes of the current PAP session. In other words, the y-value of the SH AHI graph at time t is the total number of events (OAs+CAs+Hs) recorded during the last hour of run time in the current session. When a particular event becomes one hour old, it is dropped from the running total. Because each event that is scored remains part of the AHI graph until it is an hour old, the AHI graph will remain above 0.0 for long periods of time when no events are being scored. The following image shows a series of 3 events scored within an 8-minute period, followed by over an hour of sleep with no additional OAs, Hs, or CAs scored. The AHI first increases to 3 and it stays at 3 until each of the three events "ages" out of the running total:

Ahi-graph-balanced zpsa8d453f9.jpg
AHI Graph and its connection to the Flow Rate graph and the Events table: A more complicated example. When there is a lot of activity in flow rate data over a long period of time, what happens to the AHI graph may be more complicated. Here is a marked up copy of part of one of my AHI graphs that shows what can happen when multiple clusters of events occur within 90 minutes of each other:

AHI-graph-1 zps3721dd53.jpg
At this level of zooming, SH does not label the events; and hence I've labeled each of the events, including flow limitations and the vibratory snore at the end of this window.

This particular hump in the AHI graph starts with OA1 at 5:26:21 with OA1, the first event recorded since I turned my BiPAP off and back on at 4:45. You'll notice that the AHI graph goes from 0 to 1 at this time. When CA1 is recorded at 6:00:00, the AHI graph bumps up to 2. When OA2 is scored at 6:17:21, the AHI climbs to 3.

At 6:26:21 the AHI graph goes DOWN from 3 to 2. The reason is that OA1 is now an hour old, and hence it is no longer included in the list "events that occurred less than an hour ago."

At 6:28:14, the machine records OA3, and so the AHI graph goes from 2 back up to 3. The machine records H1 at 6:30:39, and the AHI graph goes from 3 to 4 at this point. The machine records H2 at 6:35:09, and the AHI graph increases from 4 to 5. I wake up shortly after H2 and I turn my BiPAP OFF at 6:36:15. And it's my turning the BiPAP off at 6:36:15 that causes the AHI graph to suddenly plummet from 5 to 0.

Note: Any time the PAP machine is turned OFF and then back ON, the AHI graph is reset to 0 because a new session has started.

Note to only ResScan users: The AHI graph in ResScan resets to 0 at the top of every hour. Hence it is not going to look like the default SleepyHead AHI graph. If you want the SH AHI graph to look like ResScan's, you can use the "Zero Reset" option for the AHI/Hour graph in the SH Preferences. See 7. Important preferences settings for finding the "Zero Reset" option.

Basic data interpretation: Overview Data

Long term trends in the efficacy data are important for many reasons. One of the most important is that we all have the occasional bad night where the AHI is much higher than normal or the leaks are awful. Occasional bad nights do not indicate that there's something wrong with the way the PAP therapy is going. (Well, a really awful night for leaks might indicate it's time to replace those nasal pillows or to check whether the mask was put together correctly.) Sleep docs tend to focus almost exclusively on the long term data---a small number of well understood summary numbers and graphs are easier to look at than a massive amount of daily data when you are meeting with large numbers of patients each month.

Overview data The Overview data is a graphical representation of the highlights of the Detailed Daily data over a range of days (or months or years). Each of the graphs is either a bar graph or a line graph with one entry for each day's data. The following screen shot shows three of the more useful Overview data graphs from my husband's data:
Overview1 zps35d8e666.jpg

The AHI graph The bar for each day's AHI data is split into three colors; the relative sizes of each bar tell you the relative number of events. Bars that are

  • mostly dark blue (like most of hubby's) indicate the user had more Hs scored than other events,
  • mostly light blue indicate the user had more OAs scored than other events, and
  • mostly purple indicate the user had more CAs scored than other events.

Looking at the data as a whole, we see that it took hubby about three weeks to really settle into PAP and have the AHI come down to what's now his normal range. It's also interesting to note the spike in AHI on June 12. Hubby had a bike accident on that day and got scrapped up pretty good, broke his right big toe, and got a significant laceration on his right ankle as well as banged up his shoulder. So he was in pain that night. My guess is the pain is related to the higher AHI. (I've noticed this in my own data as well.)

The usage graph is not one we talk about much here, but we can see from the number at the top left of the graph that hubby is averaging 6:57 hours of mask time and that he's only had two days with really significant problems keeping the mask on. (One of those nights was when we were driving overnight across country and didn't get to our destination until around 7:00 AM and hubby went to bed after we got in; the other was another cross country drive where we got in about 3:00.)

The Session Times graph give a good over view of your sleep patterns. If you sleep well, this graph probably won't be of much interest. If you have problems with insomnia or circadian rhythm problems, looking at the patterns in this graph may go a long way towards explaining why you may not be feeling much better even with PAP: PAP fixes OSA, but it does not fix bad sleep that are caused by other things. In hubby's Session Times data, it's easy to see that hubby's wake up times are a bit more regular than his bedtimes. It's also easy to spot which nights he had trouble keeping the mask on.

Scrolling down we can see additional graphs. Three more graphs that are often useful are shown below:
Overview2 zps72255898.jpg

The Leaks and Total Leaks graphs show the maximum, 95%, and median Leaks and Total Leaks for each day. The 95% (or 90%) and median Leak graphs are are more important than the maximum values. Hubby has had a few days where his 95% leak rate is pretty high, but not high enough to have had any leaks flagged as Large Leaks in his Daily Data.

The Peak AHI graph gives graphical information about the number of apneas and hypopneas recorded in any 60 minute period during the given night's data. The Maximum Peak AHI is the maximum number of events that occurred during any one hour of the given night; this is a crude measure of how bad the worst hour of the night was. The Maximum Peak AHI values are usually going to be quite a bit higher than the overall AHI for the night because for most of use, once we start PAPing we have long period with no events and hopefully many hours where the hourly AHI is at or close to 0.


Basic data interpretation: Statistics Data

Long term trends in the efficacy data are important for many reasons. One of the most important is that we all have the occasional bad night where the AHI is much higher than normal or the leaks are awful. Occasional bad nights do not indicate that there's something wrong with the way the PAP therapy is going. (Well, a really awful night for leaks might indicate it's time to replace those nasal pillows or to check whether the mask was put together correctly.) Sleep docs tend to focus almost exclusively on the long term data---a small number of well understood summary numbers and graphs are easier to look at than a massive amount of daily data when you are meeting with large numbers of patients each month.

In this post, we'll focus on how Sleepy Head presents the long term summary data.

Organization of the Statistics Page

Below the SleepyHead header, the Statistics Page looks like this:
Statistics overview zps819c6797.png

As you can see, the Statistics page has three major parts and two different "views". The parts are:

The CPAP Statistics. This chart has two distinct Report Modes. The Standard mode, which is shown here, is the default mode and it provides summary numbers for standard CPAP data reported for time ranging from the Most Recent (latest one-night) data to the data for the last year. The Monthly report gives summary numbers for each of the last 12 calendar months of data. Changes to Prescription Settings. This chart provides a list of all machine/prescription settings you have used. For a newbie, this chart should be relatively straightforward. Machine Information chart. This shows the make, model, and serial number for each PAP machine that you've used with SleepyHead, as well as the first and last dates of usage.


The idea behind the Statistics Page is to provide a quick numerical view of the most important numbers from the efficacy data. This is the data that most DMEs print out from the proprietary software if the sleep doctor or insurance company wants more than just usage data. The organization of the summary data in the proprietary software varies from brand to brand, and we won't look at how the proprietary software organizes this data.


A detailed look at the CPAP Statistics Here is my CPAP Statistics chart:
CPAP-statistics zps1e21a1e7.png

You will notice that the total number of days of CPAP data is listed immediately under the header CPAP Statistics. CPAP data includes data from any kind of PAP machine that you have imported into the SleepyHead profile you are using. The dates of the range of data is also listed.

It's important to note that:


  • Until you have more than 7 days of data the numbers in all columns except Most Recent will be the same
  • Until you have more than 30 days of data the numbers in all columns except Most Recent and Last Week will be the same
  • Until you have more than 6 months of data the numbers in the Last 6 months and Last year columns will be the same.

As you accumulate more and more data, you will start to notice that the numbers in the Last 6 months and Last year do not change very much from day to day.

The data in the CPAP Statistics is gathered in sections. We'll examine each of them in turn.


CPAP Usage data The first two lines concern usage or compliance data:
CPAP Usage zpsc9d98063.png

The numbers for Average hours per night is a simple average: Add up the usage for each night in the time period and divide by the number of days in the time period. We can see that I didn't get much sleep last night (July 4) and that I'm averaging about 6 hours of mask time (and bed time) over the last year. There's a bit of variation between the 7-day, 30-day, 6-month, and 1-year figures, but the variation is not significant.

Sleepy Head defines Compliance for a given night as "usage is at least four hours". The line for defining Compliance can be set in the Sleepy Head preferences if desired. The percentage in the Compliance column is simply the percentage of days in the time period where the usage was at least four hours. The fact that my 1-year compliance is listed as 96% means that I used my CPAP for at least 4 hours on roughly 350 or 351 days. (Both 350/365 and 351/365 round to 0.96). Of the 15 days where I was not compliant, most of them are nights where I got less than 4 hours of sleep. Notably, however, two nights were sleep tests that I did last summer.
Therapy Efficiacy data The Therapy Efficiacy data are the numbers that measure the overall effectiveness of your PAP therapy. The whole point of PAPing is to get and keep the AHI below 5.0 long term while also having the leaks under control and getting enough sleep to feel well in the daytime. Here's my Therapy Efficacy data:
Therapy Efficiacy zpse827284e.png

The indices in this list are the same as those listed on the Left Side Bar in the Daily Data. Exactly which indices will be listed here depends on the machine you are using:


  • PR System One users will see everything on my list.
  • Resmed S9 users will see the AHI, Obstructive Apnea Index (OAI), the Hypopnea Index (HI), and Central Apnea Index (CAI).
  • DeVilbass Intellipap users will see the AHI, Apnea Index (AI), NonResponding Apnea Index (NRAI), and the Hypopnea Index (HI).
  • F&P Icon users will see the AHI, Apnea Index (AI), and Hypopnea Index (HI).

The long term indices are computed in the same way the nightly indices are computed: SH counts the number of events recorded during the time frame for the index and divides that by the total run time for the time frame. In other words the long term indices are long term averages.

As an example: My 6th month AHI = 1.79. This means that:


(total number of OAs + Hs + CAs in the last six months)/(total run time in last 6 months) = 1.79

In other words, in the last 6 months, I've had an average of 1.79 events each hour of sleeping with the machine. Some hours I've had a lot more than that; other hours I've had no events. But the expected number of events per hour of sleep would be 1-2 events each hour.

All the other indices are computed the same way and have the same meaning.


When we look at the numbers in aggregate, we can see some interesting things about my data:


  • My Last Week numbers are quite a bit better than my 6-month and 1-year numbers. That means that my OSA has been better controlled this week than it has on average for the last 6 months. I know that my AHI numbers tend to be somewhat cyclic each month, and this week has been a "good" week.
  • The Last Month data is a bit better than the 6-month and 1-year data. So the last month has been a pretty good one in terms of PAP therapy. SH data cannot provide an explanation of why it's better. However I'm through my spring allergy season and the summer allergies have not been that bad this year. And that may be a partial explanation for why the 30-day numbers are a bit better than the 6-month and 1-year numbers. More than likely my 30-day AHI will go back up once Ragweed starts to pollenate in the fall.
  • The Last 6 month numbers are a tiny bit better than the Last year. The difference is not statistically significant. And taken together, the 6-month and 1-year numbers say that my machine is doing its job of preventing most of my apneas and hypopneas from happening. A long term AHI < 2.0 is quite good.

Leak Statistics

The Leak Statistics are based on the Sleepy Head Leak data. Sleepy Head uses Leak to represent the excess or unintentional leak rate. In other words, for machines that record Total Leak Rate data, it's important to understand that

Leak Rate = Total Leak Rate - Intentional Leak Rate

SleepyHead uses a statistical analysis to estimate the intentional leak rate from the Total Leak Rate data and uses that to compute the Leak Rate. For more details about how SleepyHead handles Leak Rate and Total Leak Rate data see 8. Leaks.

My summary Leak Statistics data looks like this:

Leaks-Statistics zps82d4b2bb.png

NOTE: I've changed my "top percentile" calculations to the 90% instead of the 95% because Encore reports 90% figures instead of 95%. Most SH users will see 95% numbers where my data shows 90% numbers.

The average and 90% leak rates must be interpreted in terms of the statistical meanings of the words average and 90% (90th percentile) of a data set. For those who do not remember any about averages or percentiles, I suggest that you read Average, Median, 95% numbers: A guide to those who don't remember their introductory stats.

We'll start with the 90% (or 95%) leak rates because they are actually easier to understand in terms of PAP therapy.

The 90% and 95% leak rates are the 90th and 95th percentiles for the entire set of leak data for the given time frame. We can informally think about the computation needed to find the Last Week 90% leak rate as follows: Loosely speaking, the PAP machine has sampled the leak rate a finite number of times in the last 7 days. So for the 7-day 90% leak rate, we can informally think of lining up all the sample leak data points for the last 7 days in increasing order. If there are 10000 sample data points on our list, we find the 90% by finding the 9000th number on the list because .90*10000 = 9000. The 95% leak rate would be the 9500th number on our list.

The 90% leak rates for 30-day, 6-month, and 1-year are found the same way: We line up all the data points for leak rate for the entire time period in increasing order. If there are n points on the entire list, we first find the integer k that is equal to or just barely bigger than 0.9*n and then we find the kth number on the list.

The meaning of the long term 90% leak rate is the same as the meaning of the daily 90% leak rate in the Detailed Daily data. The fact that my 90% 6-month leak rate equals 3.0 means that for 90% of the time my BiPAP has been on in the last 6 months, the unintentional leak rate has been AT or LESS than 3.0 L/min. We can also say that my unintenional leak rate was ABOVE 3.0 for no more than 10% of the time my machine was running in the last 6 months. Which means that long term I have no serious leak problems to worry about.


The average leak rate for a given time frame is just the (weighted) average for all the leak data in that time frame. In other words to compute the 7 day average leak rate, we look at all the leak rate data for the last 7 days as one data set and find the (weighted) average for the large data set. Loosely speaking, the PAP machine has sampled the leak rate some very large, but finite number of times in the last 7 days. You add up all the "leak rate data points for the last 7 days" and divide by the total number of data points in the 7 days and you get the weighted average leak rate for the last 7 days.

The average leak rate for the last 30 days, last 6 months, and last year is computed the same way: Informally, you add up all the sample leak rate data points for the last 30 days, 6 months, or year (respectively) and divide by the total number of data points for the same period of time.

GEEK ALERT Skip the following paragraph if your eyes are starting to glaze over because you don't like dealing with statistics.

Understanding the long term average leak rate numbers is a bit more difficult simply because average leak rates do not have a simple "time" interpretation. Technically speaking, the leak curve is a continuous graph for each night. For the 7-day average leak rate, we string all seven of the leak curves together to get one very long curve that traps a finite amount of area between it and the horizontal axes for the graph. The 7-day average value for the leak rate would be the area under the 7-day leak curve divided by the total time the machine was running for the last 7 days. In other words, the 7-day average leak rate is just the average height of the leak curve over the course of the last 7 nights. (The idea is that the area under the curve really can just be thought of as the sum of the data points and the length of time is then just the number of data points.)

Note: Because of the way weighted averages are computed, we cannot anything about how long the leak rate was AT or BELOW the 7-day, 30-day, 6-month, or 1-year average leak rates.


Pressure Statistics The Pressure Statistics are not very interesting if you are using a fixed pressure PAP machine, your max pressure and 90% or 95% pressure levels should equal your pressure setting. Your minimum pressure level and your average pressure level will be less than your pressure setting if you use the Ramp feature. The minimum pressure level will most likely be the starting Ramp pressure.

The Pressure Statistics are more interesting if you are using an Auto PAP in Auto mode.

My summary Pressure Statistics data looks like this:
Pressure zps4027bd44.png

Two things need to be pointed out about my Pressure data:


  • Most people will have either "Pressure" data and no IPAP/EPAP data OR they'll have IPAP/EPAP data and no "Pressure" data. I'm not sure why I have both. It's probably a SleepyHead bug.
  • I've changed my "top percentile" calculations to the 90% instead of the 95% because Encore reports 90% figures instead of 95%. Most SH users will see 95% numbers where my data shows 90% numbers


Several things should be pointed out about pressure data:


  • Users of DeVilbass Intellipap CPAP/APAPs, F&P Icon CPAP/APAPs, and PR System One CPAP/APAPs will have Pressure data.
  • Bi-level users will have IPAP/EPAP data regardless of the brand of machine.
  • Resmed S9 CPAP/APAP users who use EPR will have IPAP/EPAP data because these machines act very similar to bi-levels. The IPAP data is the pressure level data; the EPAP data is the pressure level - EPR setting. In other words, if the pressure is 8 and EPR = 2, the IPAP = 8 and the EPAP = 6 = 8 - 2.
  • If you use a Ramp, the Ramp pressures ARE used in the statistical computations. The min pressure, min IPAP, and min EPAP pressure numbers will typically be those used at the start of your ramp.
  • The meaning of 90%, 95%, and average pressure and IPAP numbers are similar to the meanings of 90%, 95%, and average leak rates.
  • The minimum and maximum pressure (IPAP/EPAP) numbers are true minimums and maximums. In other words, the 6-month min pressure number is the lowest pressure that's been recorded in the last 6 months; the 1-year maximum IPAP is the highest IPAP pressure that's been recorded in the last year.


Bugs in the CPAP Statistics data There are some bugs in the CPAP Statistics numbers. So if a number obviously does not make sense, its best to disregard the number. Resmed S9 summary data has been particularly challenging for JediMark to work with if no detailed daily data is available for some days. The summary data stored for a day with multiple sessions is not sufficient to compute the long term percentiles and averages when only the summary data is available.

Important preferences settings

When you select Preferences off the appropriate menu, a Preferences panel will come up. Regardless of whether you are using a Mac or a Windows machine, the Preferences panel will look the same. The default starting place in the Preferences panel is the Import pane. The Import panel The Import tab of the Preferences panel looks like this:
Preferences1 zps954c59ba.jpg

While looking at the Import tab of the Preferences panel, there are only two settings for a newbie to really worry about:


  • Day time split. If you often sleep past noon, changing this allows all your sleep data for one "night" to appear on the same day instead of being split across two days. NOTE: Day time split is NOT available after you import data from an S9 into SleepyHead. This choice was intentional since disabling Day time split is needed to make it possible for SleepyHead to get at the S9's summary data.
  • Create SD card backups during Import. As the parenthetical note says, making sure this is checked is pretty critical for Resmed S9 and FP Icon users since those machines overwrite the detailed data on the SD card on a regular basis. Checking this will make it easier to reimport the data if it becomes necessary.

All other settings on this page can be left at the default settings until you're more comfortable with SH. (NOTE: my settings are NOT the default settings.)


The CPAP panel The CPAP tab of the Preferences panel looks like this:
Preferences2 zpsb50a35c7.jpg
The default values have been edited on my profile. Things of note for a newbie:

  • The CPAP information on the left side of the panel is largely irrelevant at this point. SleepyHead defaults to a statistical model for approximating the (excess) leak for all machines other than the Resmed S9, which records only the excess leak. If you forget to change the Leak Calcs from "Mask Profile" to "Statistical Model" it really doesn't matter.
  • CPAP clock drift should be left at 0 seconds unless you know your CPAP clock is off and you can't change PAP's internal clock. Mine is off by a whopping 23 minutes, and because it's a PR System One, I can't change the PAP's clock; hence the offset of 1380 seconds.
  • Show Leak Redline. The default is to have this checked and the default value for the Redline is the Resmed value of 24 L/min. This is a NEW feature in SH 0.9.6. If you are using a Resmed S9, it's strongly recommended that you make sure Show Leak Redline is checked. If you are using a different machine, this may be a useful option for you, but you will need to change the value for the Redline. More on that in a bit.
  • Show compliance affects how low usage days show up in the Overview data and the compliance data in the Statistics page. The default line is 4 hours for obvious reasons. I'd suggest leaving this alone.
  • Custom User Event Flagging. I'd recommend that a new PAPer leave this unchecked. It can be useful if you have a lot of "almost" apneas or "almost" hypopneas showing up in your detailed data, but it really is an advanced feature.
  • AHI/Hour Graph Settings. The default is to have the box by Zero Reset unchecked. Leaving the box unchecked tells the AHI/hour graph to keep a running total of the number of events (OAs + CAs + Hs) that have happened in the last 60 minutes. To make the AHI/hour graph behave like the ResScan AHI/Hour graph, you need to check the Zero Reset box; then the AHI count is set back to 0 at the top of every hour.




A detailed look at the Show Leak Redline option The default is to have this checked and the default value for the Redline is the Resmed value of 24 L/min. This is a NEW feature in SH 0.9.6. Since I use a PR System One and I pretty much understand my leaks, I've unchecked the Redline so I don't get one in my daily leak graphs. If you want a line for helping you spot Large Leaks and you are NOT using a Resmed S9 machine, the first thing you will need to do is figure out whether your machine's manufacturer has an official definition of "Large Leak" or not. Here is what I've been able to put together:


  • Resmed S9. You should use the default Redline setting of 24 L/min, and and you want to keep the Leaks graph under this line.
  • F & P Icon. The F&P Icon reports TOTAL leaks and the F&P Icon definition for Large Leak is a TOTAL leak rate that is above 60 L/min. You should set the Redline at 60 L/min and you want to keep your TOTAL leaks under a Redline drawn at 60 L/min.
  • Devilbiss IntelliPAP Auto. The Devilbiss IntelliPAP reports Total leaks and the Devilbiss definition of Large Leak is a TOTAL leak rate that is above 95 L/min. You should set the Redline at 95 L/min and you want to keep your TOTAL leaks under a Redline drawn at 95 L/min.
  • PR System One. The PR machines report TOTAL leak, but PR never tells us what the official definition of a Large Leak. SleepyHead 0.9.6 now flags the official Encore Large Leaks as gray bars over the Flow Rate graph. So if you get a lot of large leaks, you can use that data to help you decide where to draw a Large leak line. But until you get some data, here's a staring place to make some guesses about where to draw the Redline that are based on looking at a lot of Encore data from a lot of PR users over the years:
    • Older Series 50 System One machines. If you are using a pressure setting that is higher than 8-10cm, Encore usually does not flag Large Leaks until the Total Leak rate is up around 90-100 L/min. If you are using very low pressures (4-8cm), Encore may start flagging large leaks at around 60 L/min. So start by selecting a Redline of 90 L/min if you are using pressures above 8 cm and a Redline of 60 L/min if you are using pressures below 8 cm. Adjust if you see Gray Large Leak bars in your actual data.
    • New Series 60 System One machines. If you are using a pressure setting that is higher than 8-10cm, Encore usually does not flag Large Leaks until the Total Leak rate is up around 80 L/min. If you are using very low pressures (4-8cm), Encore may start flagging large leaks at around 50 L/min. So start by selecting a Redline of 80 L/min if you are using pressures above 8 cm and a Redline of 50 L/min if you are using pressures below 8 cm. Adjust if you see Gray Large Leak bars in your actual data.


The Graphs panel The Graphs tab of the Preferences panel contains a list of all potential graphs that SleepyHead can draw along with a minimum and maximum value for each graph. The panel looks like this:
Preferences3 zps08a70ced.jpg

Note that there are going to be graphs on this list that do NOT show up in your particular data; that's because this is a master list of all the graphs for all the machines that SleepyHead supports. If your machine does not record a particular kind of data, you won't have that graph show up in the daily data, even though it will be listed here.

The "default" values where both the min and max values are set to 0.0 allows SH to choose the values for the vertical scale of the graphs. Most of the time those default values are just fine. However, sometimes the the default values compress the data too much vertically and that can leave a lot of "unused white space" in the graphs. If you want to change a graph's values, double click on the particular value you want changed, and you'll be able to edit it:
Preferences4 zpse8e10be4.jpg
SleepyHead should save your graph settings after you've changed them, so you really only need to edit the y-values for the graphs once.

The values that make sense for MY data are probably NOT a good starting point for most people since I'm a very petite 5'1" female who weighs about 110 lbs. That said, here's what the value I typically use for my graphs look like:
Preferences5 zpsafcf5d39.jpg
The General panel The General tab of the Preferencs panel looks like this:
Preferences6 zpsdc512fd2.jpg

I have edited some of my settings. For a newbie, the default settings are fine.

The default Upper Percentile Calculation is 95% (the Resmed number), but I prefer to use the 90% numbers, since they agree with Encore, the official software for my machine.

Median is a better choice for the "middle" calculation than either "Average" or "Weighted Average" in my mathematician's opinion. The numerical average and weighted average are not a meaningful as Median is. The Median is the "middle" point of the data---50% of the data lies AT or BELOW the median and 50% of the data lies AT or ABOVE the median. Both the Average and Weighted Average can be (seriously) skewed by even a tiny bit of outlier data.

The default for "Skip over Empty Days" is to have the box checked; I want to be reminded that there's no data for a particular day, so I uncheck that box.

The default for "I want to try experimental and test builds" is to have the box unchecked. For a new user that's the right choice. (I've been a SH user right from the start, and in fact some of my BiPAP data was used way back in SH 0.7 to get SH to load the PR BiPAP data correctly. So I have that box checked because I'm one of the "testers" when I have the time to help find bugs.)


The Appearance panel The Appearance tab of the Preferences panel looks like this:
Preferences7 zps7c33c511.jpg
I have edited some of these values. By default, the default values for the check boxes are:


  • Use Anti-Aliasing is turned OFF
  • Use Square Wave Plots is turned OFF
  • Show event break down pie chart is turned ON
  • Use Pixmap Caching is turned ON
  • Animations & Fancy Stuff is turned ON
  • Allow Yaxis scaling is turned ON


For most newbies, the default settings can be left alone, with the following possible exception:

  • Use Pixmap Caching. By default, this is turned on; I would recommend turning "Use Pixmap Caching" off by unselecting the box. Pixmap Caching can make some of the graphics stuff go faster, but it can also cause problems, particularly if your graphics card is not standard. I routinely turn Pixmap Caching off by unchecking the box because I don't notice a speed up when Pixmap Caching is turned ON and I have used machines that have had bizzare problems with the graphs when Pixmap Caching is turned ON is that go away when I turn Pixmap Caching off.


Also note: Right now the "Animations & Fancy Stuff" is disabled in SH0.9.6 while JediMark and his collaborators are chasing some bugs. So you don't get anything extra if Animations & Fancy Stuff is turned ON. I never much cared for the animation stuff, so I always turned it off.

Leaks

Beyond AHI: Apneas and hypopneas in the Flow Rate graph

Snoring Data

Flow Limitations

Fancy Stuff: Other Data Available from SleepyHead

Manipulating Daily and Overview Graphs

Posting SleepyHead Graphs to the Forum

Tricks and Shortcuts

by RobySue (edited 6/28/2014)

These are tricks and shortcuts that work in SleepyHead. Some of them manipulate graphs, others help your navigate around Sleepy Head quickly.

Note: Tricks and shortcuts appear on this list more than once because I think of them in more than one way.

Note: I've got all the tricks and shortcuts that I'm aware of on this list. But each of the subcategories of tricks and shortcuts is NOT organized. Organizing the lists is not high on my priority list right now.


Tricks for moving around SH and changing the appearance of the SH windows

  • Cursor left and right keys scrolls the highlighted box. If the calendar is highlighted, these keys will move the Daily Detailed data backward or forward by one day at a time.
  • Right clicking on, and then dragging the currently selected highlight in the Event Table allows you to easily slide the current selected time "window" over the whole period.
  • Right clicking on, and dragging any graph other than the Events Table will act as if you are picking it up and panning it left or right.
  • Double clicking on a graph's title text area pins or unpins any graph. Pinned graphs always remain visible on screen, up the top. Your graph pins are persistent.
  • Clicking on graph title text and dragging allows you to reorder the graphs, but pinned graphs will always be on top. Pinned graphs can be reordered amongst themselves in this same way.
  • Clicking on the date panel above the Daily Detail calendar toggles the calendar on/off to quickly give you more room in the Left Sidebar of the Daily Data for the statistical data
  • F8 key quickly toggles the right navigation panel to give you more graph room.
  • You can drag the vertical sizer line that is between the left panel and graph area all the way to the left, allowing you to get full screen graphs.
  • If you want to view only ONE of the Daily graphs or ONE of the Overview graphs, you can minimize all the graphs with the down arrow button next to the right side drop down in the bottom panel, then turn back on the graph you want to look at in the drop down menu in the bottom left corner. To make all the graphs visible again, click the arrows next to that drop down menu box twice.
  • The "Reset" button down the bottom panel of the graph area restores all graphs to uniform sizing.
  • You can click on the colored event names in the Daily Details panel to jump to them highlighted in the Events tab
  • You can click on the duration shown in the CPAP Sessions to highlight just that session.
  • Clicking on the an entry in the Prescription Changes list in the Statistics page will jump to Overview and select that date range.
  • Tooltip durations can be altered in the Appearance Preferences. If you find them annoying drag it all or most of the way to the left.
  • Shift-click on a date in the Overview screen and SH takes you to that date in Daily Data view.

Tricks and shortcuts to manipulate graphs

  • Holding in Control (or Command on Mac) and using the mouse wheel zooms graphs in/out
  • Cursor up & down keys zooms when the graph area has input focus.
  • Cursor left and right keys scrolls the highlighted box. If the Daily Data or Overview graphs are highlighted, this will provide a horizontal scroll.
  • Holding in Control (or Command..) while left/right click on a graph will cause it to zoom faster.
  • Right clicking on, and then dragging the currently selected highlight in the Event Table allows you to easily slide the current selected time "window" over the whole period.
  • Right clicking on, and dragging any graph other than the Events Table will act as if you are picking it up and panning it left or right.
  • Double clicking on the y-axis labels will toggle between auto-zoom and default zoom, provided the graph's y-range hasn't been specified in the Graph Preferences
  • Double clicking on a graph's title text area pins or unpins any graph. Pinned graphs always remain visible on screen, up the top. Your graph pins are persistent.
  • Clicking on graph title text and dragging allows you to reorder the graphs, but pinned graphs will always be on top. Pinned graphs can be reordered amongst themselves in this same way.
  • You can drag the vertical sizer line that is between the left panel and graph area all the way to the left, allowing you to get full screen graphs.
  • Clicking on the grey line between graphs allows you to resize that particular graph. SH will remember the graph heights for next time.
  • If you want to view only ONE of the Daily graphs or ONE of the Overview graphs, you can minimize all the graphs with the down arrow button next to the right side drop down in the bottom panel, then turn back on the graph you want to look at in the drop down menu in the bottom left corner. To make all the graphs visible again, click the arrows next to that drop down menu box twice.
  • The "Reset" button down the bottom panel of the graph area restores all graphs to uniform sizing.
  • The "100%" button zooms out completely to show the entire day.
  • You can click on the duration shown in the CPAP Sessions to highlight just that session.
  • If you have trouble seeing the graph lines, you can now set the thickness of line plots in Appearance Preferences
  • Overview graphs can be alternatively displayed as Line plots (non-bar graphs) in Appearance Preferences

Keyboard tricks and shortcuts

  • Cursor up & down keys zooms when the graph area has input focus.
  • Cursor left and right keys scrolls the highlighted box. If the graphs are highlighted, this will provide a horizontal scroll; if the calendar is highlighted, these keys will move the day data backward or forward by one day at a time.
  • F8 key quickly toggles the right navigation panel to give you more graph room.
  • F11 key quickly toggles to and from Full Screen view.
  • F12 key takes a screenshot of the current SleepyHead window; the screenshot will be saved to your SleepyHeadData/Screenshots folder.

Useful tricks with the mouse

  • Holding in Control (or Command on Mac) and using the mouse wheel zooms graphs in/out
  • Holding in Control (or Command..) while left/right click on a graph will cause it to zoom faster.
  • Right clicking on, and then dragging the currently selected highlight in the Event Table allows you to easily slide the current selected time "window" over the whole period.
  • Right clicking on, and dragging any graph other than the Events Table will act as if you are picking it up and panning it left or right.
  • Double clicking on the y-axis labels will toggle between auto-zoom and default zoom, provided the graph's y-range hasn't been specified in the Graph Preferences
  • Double clicking on a graph's title text area pins or unpins any graph. Pinned graphs always remain visible on screen, up the top. Your graph pins are persistent.
  • Clicking on graph title text and dragging allows you to reorder the graphs, but pinned graphs will always be on top. Pinned graphs can be reordered amongst themselves in this same way.
  • Clicking on the date panel above the Daily Detail calendar toggles the calendar on/off to quickly give you more room in the Left Sidebar of the Daily Data for the statistical data
  • You can drag the vertical sizer line that is between the left panel and graph area all the way to the left, allowing you to get full screen graphs.
  • Clicking on the grey line between graphs allows you to resize that particular graph. SH will remember the graph heights for next time.
  • You can click on the colored event names in the Daily Details panel to jump to them highlighted in the Events tab
  • You can click on the duration shown in the CPAP Sessions to highlight just that session.
  • Shift-click on a date in the Overview screen and SH takes you to that date in Daily Data view.
  • There is an option in Appearance Preferences to dampen the horizontal left and right panning on sensitive Mac trackpads/mice. This allows you to define a millisecond delay between vertical scrolling and horizontal panning. Without this setting, scrolling is a nightmare to use for people with shaky hands on sensitive input devices.

SleepyHead FAQ

by RobySue

Q: Can SleepyHead change or erase the data on my SD card?

A: No. SleepyHead only reads the data on the SD card; it never writes anything to the SD card. Note, however, that some computer operating systems may write hidden files to the SD card. So it is a good idea to lock the SD card before you put it into your computer's SD card slot. Click here for a more detailed answer.

Q: I imported my data into SleepyHead and when I put the card back into my Resmed S9, I get an error that says: " 'Invalid SD card, erase card data?". Why is this happening and what should I do?

A: SleepyHead did not cause the problem; your operating system did. The operating system wrote some hidden files to the card, and the S9 does not want anything on the SD card that it did not write to the card. All versions of Mac OSX will write hidden files to an unlocked SD card. Windows 8.1 is also known to write hidden files to an unlocked SD card. To fix the problem: Let the S9 erase the card and rewrite the summary and compliance data to the card. You will NOT lose any data that you've already imported into SleepyHead. And the summary and compliance data that your DME and sleep doc care about will be written back to the card. To prevent the problem in the future: Be sure to lock the SD card before inserting the SD card into your computer or card reader. You lock the SD card by sliding the "Lock" tab on the side of the card to the Locked position. That will prevent the operating system from writing hidden files to the SD card. After importing data into SH and removing the SD card from your computer, remember to unlock the card before putting it back into your S9 PAP. If you forget to unlock the card, you might see an error message on the S9's LCD telling you that the inserted card is read only. NOTE: Using Rescan on a Win 8.1 machine will NOT prevent this problem from happening; Win 8.1 will still write hidden files to an unlocked SD card and when you put the card back in the S9, the S9 will still insist on erasing the contents of the card.

NOTE AND WARNING for WIN 8.1 USERS

Some Win 8.1 users have reported that locking the SD card does NOT prevent their computer from writing files to the SD card. The lock switch on the SD card is a physical switch and not all SD card readers have a corresponding physical switch in them that recognizes and respects the SD card's lock switch. You can test whether your Win 8.1 machine will ignore the Lock switch by doing the following: Step 1) Place a Locked SD card into the machine. I'd suggest an SD card that is NOT the one from your S9 machine. Step 2) Try to save a file of your choice to the SD card in the usual way. If the computer writes the file to the SD card, then you know that the simple fix of locking the SD card is NOT going to work on your computer and its SD card slot: The Win 8.1 operating system will continue to write those hidden system files to the SD card in spite of the card being locked.

What to do next depends on which Win 8.1 operating system you have and how comfortable you are with some advanced features of the Win 8.1 operating system. Here are two things you can try: Try an external SD card reader plugged into a USB port. If the external SD card reader has the right kind of physical switch to detect the position of the SD card's lock tab, that should prevent Win 8.1 from writing the system files to the SD card. Try following these instructions from MS about how to prevent Win 8.1 from writing system files to removable media Note that these instructions specifically indicate that some of the suggestions are NOT applicable to Windows 8.1 Home edition.


Q: Will SleepyHead work on my computer?

A: SleepyHead 0.9.3 will work on PCs running anything from Windows XP through Windows 8.1; it will also run on Macs running OS X 10.6 and later. SleepyHead 0.9.6 may have problems running on Windows XP, Windows Vista, and Mac OS X 10.6. Future versions of SH will most likely NOT run on XP, Vista, or OS X 10.6. (NOTE: Windows XP and Mac OSX 10.6 have been completely left for dead by their creators, and users of these operating systems are running a great security risk if they use them online.) SleepyHead will also run on many flavors of Linux, but it is harder to install under Linux.

Q: My computer doesn't have an SD card slot. Can I still use SleepyHead?

A: Yes. You may use any generic SD card reader to access the data on the SD card. Generic SD card readers are readily available at office supply stores and big box stores like Target and Walmart. They usually cost less than $10 or $15.

Q: Is there a list of keyboard short cuts and mouse tricks for Sleepy Head?

A: Yes. Go to Tricks and Shortcuts

Q: I forgot to put my SD card back into my PAP after importing the data into Sleepy Head. Have I lost my data?

A: All modern PAPs store the compliance data on-board and they will write that data to the SD card when the SD card is reinserted into the PAP. Some PAPs store a fair amount of other data on-board as well as the compliance data, and all of the on-board data will be written to the SD card when you PAP. How much data you will see for the night in SleepyHead depends on both the brand of PAP you use and the version of SleepyHead you use.

PR System One users will lose the Flow Rate data and the "fancy stuff" computed from the Flow Rate data. But the Event Table, Pressure graph, and Leak graph should all show up in the Daily Graphs along with the daily summary data in SH 0.9.3.

Resmed S9 users will lose all of the detailed daily data and all of the Daily Data graphs. But summary data for the day should show up in SH 0.9.6. I don't know exactly what F&P Icon or DeVilbass users will lose.

Q: How often do I need to import my data into SleepyHead?

A: It depends on the kind of PAP you are using. Resmed S9 users need to import the data on a weekly basis if they want to see all available data, including the Flow Rate graph; the S9 overwrites the high resolution data (including the Flow Rate data) on a seven day cycle: In other words, tonight's high resolution data replaces the high resolution data from one week ago. The rest of the detailed daily data (pressure, leak, event table), is overwritten every 30 days.

F&P Icon users need to import the data on a weekly basis; the F&P Icon overwrites the daily detailed data on a seven day cycle: In other words, tonight's detailed daily data replaces the high resolution data from one week ago.

PR System One and DeVilbass Intellipap users can download much less frequently. These machines store several months to a year's worth of full efficacy data on the SD card. It's still not a bad idea to import the data into SleepyHead on regular basis in case the SD card becomes corrupted.

Q: I've downloaded my data from a Resmed S9 Elite, AutoSet, VPAP S, or VPAP Auto, and there is no detailed data and SH says I didn't use the machine. What did SH do with my data?

A: SleepyHead didn't do anything with your data. The most likely cause for your problem was that the card was left out of the S9 over night. (Or the card was not fully inserted.) If the SD card is not inserted into the S9 during the night, all the daily detailed data (including all the graphs) is lost; the S9 writes the detailed daily data directly to the SD card. The summary data, including the usage data, the overnight AHI, the overnight median, 95%, and maximum pressure levels, and the leak data overnight median, 95%, and maximum leak rate data, is stored in the S9's internal memory and is written back to the SD card when you re-insert the card. But SH cannot use this summary data for anything on the Daily Data page, and hence if you forget to put the SD card back into your machine, you won't get the graphs. Early versions of SH (including SH 0.9.3) cannot use the S9 summary data at all, and hence an early version of SH will tell you that there is no data for the day and "claim" that you did not use the machine. SH 0.6 should import the summary data into the Statistics page, although the calculated averages and percentiles using data from nights with no detailed daily data may not be mathematically accurate. The reason is that there's not enough data to accurately calculate the over night numbers if there are multiple sessions.


Q: I don't see any Flow Rate data. What am I doing wrong?

A: DeVilbass Intellipap users will not see any Flow Rate data because the Intellipap does not record that data to the card. Resmed S9, PR System One, and F&P Icon users will only see Flow Rate data if the card was in the machine while it was running; the Flow Rate data is written directly to the card. Resmed S9 and Icon users who do not down load their data at least once a week will only get the last 7 days of Flow Rate data for each down load: The S9 and the Icon both overwrite the Flow Rate data once a week.


Q: Can Sleepy Head work with data from an oxymeter?

A: Yes, SH can work with some O2 monitoring devices. See <GET A REFERENCE> for details.

Q: Can Sleepy Head tell me when I was in REM sleep?

A: No. Your CPAP does not record EEG data, which is needed to determine REM.

Q: Can Sleepy Head tell me when I was awake during the night?

A: No. Your CPAP does not record EEG data, which is needed to determine night time wakes.

Q: Can Sleepy Head tell me when I was sleeping on my back?

A: No. Your CPAP does not record positional data. SleepyHead can sync with Somnopose software

Q: I'd like to post some Sleepy Head data to the forum, what should I do?

A: For tips and instructions on posting SH data to the form go to 14. Posting SleepyHead Graphs to the Forum

Q: Where can I report bugs?

A: If you are familiar with Sourceforge, you may report bugs on the SleepyHead project page. If you would rather not report the bug there, you may post the bug to this thread or PM robysue. For a bug report to be useful, you need to include:

  • The version of SleepyHead you are using
  • Your operating system (be specific)
  • Your computer's machine's make and model
  • Your PAP's make and model
  • A screenshot showing the bug

If you are reporting a bug that crashes SleepyHead, indicate what you were doing at the time of the crash.




Donate to Apnea Board