2,745
edits
Changes
m
SH SleepyHead works on Macs running most modern OSX systems without any problems. On Windows machines, SH SleepyHead 0.9.8-1 should install cleanly on anything from XP through Windows 10. If you run into problems with installing on Mac, Windows or Linux, please post your question in the [http://www.apneaboard.com/forums/Forum-Software-Support-Forum Software Support Forum] and someone will likely be along soon to help.
spelling
'''For Windows:''' As of October 28, 2015, there is an '''Automatic Windows Installer''' ('''.exe''') file available on the [http://www.sleepfiles.com/SH2/ SleepyHead Download Page] that will automatically check your computer's operating system to see if it's either a 32 or 64-bit system, and then automatically install either a 32 or 64 bit copy of SleepyHead on your computer. The installer includes shortcuts to both the ''OpenGL'' and ''BrokenGL'' versions in the Windows Start Menu, but places a shortcut on your desktop to the default ''OpenGL'' version (which is the preferred option). After installation, try the ''OpenGL'' version first and if it doesn't work for you, simply use the ''BrokenGL'' version that is linked in the Windows Start Menu.
If you would like to '''manually''' install SleepyHead on Windows, the download page also has the older zip files for 32 bit and 64 bit Windows. The zip files aren't installers, so you'll first have to determine if you need the 32 bit or 64 bit version. If in doubt, choose the 32 bit version. You need to save the file somewhere you can remember and unzip it. Then in order to run SleepyHead, you have to go into the unzipped SH SleepyHead folder and click on the SleepyHead application.exe file to launch the program.
'''For Linux:''' There are several different Linux packages available. Some older versions are stored in the Releases folder on the Sourceforge site. You can find them by going [https://sourceforge.net/projects/sleepyhead/files/Releases/Linux/ here]. 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 SleepyHead 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. For the newer versions of SleepyHead for Linux, please refer to the wiki instructions on [http://www.apneaboard.com/wiki/index.php?title=Building_SleepyHead_from_source Building SleepyHead from Source] and a [http://www.apneaboard.com/forums/Thread-Building-SleepyHead-on-Linux forum thread here].
== Additional Notes ==
'''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.
== Creating a Profile ==
When you first open up SleepyHead, you will be asked to create a profile. The process is pretty straight forward, but you do have to do it before you can use SH SleepyHead to download your data. The first page of the Profile builder looks like this:<br />
[[File:profile_zpsc00048a0.jpg]]<br />
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 SleepyHead 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:<br />
2) 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) Remember to put the card back into your CPAP 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 SleepyHead 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 =
"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 SHSleepyHead, this was really buggy. It seems to work much better in SH SleepyHead 0.9.5 and 0.9.6. On a Mac, SH SleepyHead will tell you the location of the saved screenshot. On a very small netbooks running Windows 7, it's not completely clear whether "Take Screenshot" works and it does NOT tell the user the location of the saved screenshot.
<br />
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 some things within the Zeo itself to make the import run smoothly.<br />
If you plan on using SH SleepyHead with an oximeter, please see [[Importing CMS 50D Plus oximeter data into SleepyHead]], [http://www.apneaboard.com/forums/Thread-Importing-Oximetry-Data-in-Sleepyhead this forum thread], or or post your questions on the [http://www.apneaboard.com/forums/Forum-Software-Support-Forum Software Support Forum].
<br>
<br />
The top chart is the '''Events chart'''. The Events chart gives a snapshot of just how good or bad the night was. (This patient had a really good night on this night). In SH SleepyHead 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.
<br />
The particular graphs that you will see in SH SleepyHead depends on the machine you are using and whether you have turned any of the available graphs "off". This is discussed later in this article as well.
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 be discussed later in this article. <br />
Total Leaks 11.00 14.00 23.00 34.00'''
The '''Leak Rate''' numbers are SHSleepyHead's statistical "guess" about what the patient's '''unintentional''' leak rate is. This number is NOT an official Encore number and it does not come directly from the data on the 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.
'''The Leak Rate graph'''
This graph shows both the Total Leaks (light gold color on top) and the SH SleepyHead 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.
In this example, the Redline option turned OFF because the patient knows her 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.
'''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 SHSleepyHead''
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.
'''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 SleepyHead 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.<br />
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 [http://www.apneaboard.com/wiki/index.php?title=Beginner%27s_Guide_to_SleepyHead#Important_preferences_settings 7. Important "preferences settings].
A typical SH SleepyHead 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.<br />
[[File: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 SleepyHead 0.9.6 flags one patient's rare official Large Leaks is shown below. (This Large Leak has a number of really interesting characteristics, and you can read about it in the blog post, [http://adventures-in-hosehead-land.blogspot.com/2013/09/anatomy-of-large-leak-in-encore-and.html Anatomy of a Large Leak in Encore and SleepyHead], which analyzes exactly what's going on in this leak. )<br />
[[File:large_leak_flage_zps357316c6.jpg]]
And yet, many newbies are very interested in this graph. So in the interest of trying to clear up misconceptions about this graph, it is included 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 CPAP session. In other words, the y-value of the SH SleepyHead 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:<br />
[[File:ahi-graph-balanced_zpsa8d453f9.jpg]]
[[File:AHI-graph-1_zps3721dd53.jpg]]
<br />
At this level of zooming, SH SleepyHead does not label the events; and hence each of the events have been manually labelled in this example, 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 the patient turned her BiPAP off and back on at 4:45. You'll notice that the AHI graph goes from 0 to 1 at this time.
'''Note''': Any time the CPAP 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 SleepyHead AHI graph to look like ResScan's, you can use the "Zero Reset" option for the AHI/Hour graph in the SH SleepyHead Preferences. See [http://www.apneaboard.com/wiki/index.php?title=Beginner%27s_Guide_to_SleepyHead#Important_preferences_settings 7. Important preferences settings] for finding the "Zero Reset" option.<br />
<br />
* '''ResMed S9:''' The numbers in parenthesis are the length of the event measured in seconds.
* '''PR System One:''' The numbers are event markers. For CAs, OAs, Hs, PBs, and LLs, the numbers are usually a good approximation of the event length measured in seconds. For RERAs, it appears that the number is a good approximation of the event measured in seconds. For VS, VS2, and FL it is not at all clear what the meaning of the numbers is. SH SleepyHead uses the VS2 numbers to draw the Snore graph; presumably the higher the number attached to a VS2, the louder OR longer the snoring. It's not clear which. For more information on how the PR scores snoring see [http://www.apneaboard.com/wiki/index.php?title=Beginner%27s_Guide_to_SleepyHead#Snoring_Data 10. Snoring Data].
* '''DeVilbiss IntelliPAP:''' The numbers in the parenthesis are usually single digit numbers and it is not clear what their meaning is. Since the IntelliPAP does not record Flow Rate data, it is impossible to see whether there is some connection between these numbers and the lengths of the events.
* '''F&P Icon:''' The numbers in parenthesis seem to always be 1, and hence they are not related to the length of the event. You can zoom in on each event in the Flow Rate curve and estimate the length of the event visually.
== Tricks for moving around SH SleepyHead and changing the appearance of the SH SleepyHead 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.
* 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 SleepyHead takes you to that date in Daily Data view.
== Tricks and shortcuts to manipulate graphs ==
* 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 SleepyHead 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.
* 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 SleepyHead 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 SleepyHead 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.
* 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 SleepyHead and removing the SD card from your computer, remember to unlock the card before putting it back into your S9 CPAP. 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 ResScan on a Win 8.1 or Win 10 machine will NOT prevent this problem from happening; Windows 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.
A: All modern CPAPs store the '''compliance''' data on-board and they will write that data to the SD card when the SD card is reinserted into the CPAP. Some CPAPs 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. How much data you will see for the night in SleepyHead depends on both the brand of CPAP 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 SleepyHead 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 SleepyHead 0.9.6.
* We don't know exactly what ''F&P Icon'' or ''DeVilbiss'' users will lose.
== Q: I've downloaded my data from a ResMed S9 Elite, AutoSet, VPAP S, or VPAP Auto, and there is no detailed data and SleepyHead says I didn't use the machine. What did SleepyHead 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 SleepyHead 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 SleepyHead (including SH SleepyHead 0.9.3) cannot use the S9 summary data at all, and hence an early version of SleepyHead will tell you that there is no data for the day and "claim" that you did not use the machine. SH SleepyHead 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'd like to post some SleepyHead data to the forum, what should I do? ==
A: For tips and instructions on posting SH SleepyHead data to the form go to [http://www.apneaboard.com/wiki/index.php?title=Beginner%27s_Guide_to_SleepyHead#Posting_SleepyHead_Graphs_to_the_Forum 14. Posting SleepyHead Graphs to the Forum]
== Q: Where can I report bugs? ==
Donate to Apnea Board