Support Apnea Board & OSCAR  

OSCAR - The Guide

From Apnea Board Wiki
Revision as of 01:59, 8 March 2021 by Gideon (talk | contribs) (==)
Jump to: navigation, search


Full-48.png

Afrikaans / في الصفحة / български / 中国 / 臺灣 / čeština/ Dansk / Deutsch / Ελληνικά / Español / Filipino / Français / עברית / Magyar / Italiano / 日本語 / 한국어 / Nederlands / Norsk / Polskie / Português / Română / Pусский / Suomalainen / Svenska / ภาษาไทย / Türkçe
--> Do not use these buttons when you are on a translated page. Just close this tab to go back. <--

OSCAR - the Open Source CPAP Analysis Reporter

OSCAR is software that is compatible with Windows, Mac, and Linux operating systems, developed for reviewing and exploring data produced by supported CPAP, bilevel, ventilators, and related machines used in the treatment of sleep apnea. Oscar requires that data is collected on an SD card which MUST be inserted into the PAP machine during use to record detailed data.


Common features of detailed graphs

OSCAR daily screen.png

Left side-bar

OSCAR Side-bar.png The left part of the Daily screen is referred to as the left side-bar. It contains details of your machine and its settings, your AHI and other sleep indicators, and the amount of time you were asleep.


Starting from the top, the key parts of the left side-bar are

  1. Program identification, menu, and tabs, as found on all screens within OSCAR
  2. The current date. Click the small green arrows to move back & forth by one day. Click the Green arrow & bar >| to move to the latest date with data. Click the small black triangle to make the calendar appear or disappear.
  3. Tabs to select details, events, notes, and bookmarks. These will be discussed in greater detail below.
  4. AHI Summary. This is your apnea / hypopnea index for the sessions under review. It is the total number of apneas and hypopneas divided by the total hours of sleep. Generally, this will be for the whole night, however, if you have turned any sessions on or off (See No 11 below) then the AHI is given only for the sessions turned on.
  5. Machine type and settings summary. This gives the make and model of the CPAP machine. The PAP mode is the particular algorithm set on the machine (many machines can operate in more than one mode). It also shows the pressure settings. If you hover the mouse cursor over the machine name, the model number and serial number will appear in a pop-up box. Note: The settings for PC, S, and S/T modes on Philips Respironics System One machines may be displayed as random garbage numbers - this is a known problem and will be fixed in a later release of Oscar.
  6. Session starting, ending, and total times. Shows when the machine was turned on and off, and the total elapsed time. Note that although this is used to calculate the time asleep, the CPAP machine has no way of knowing if you were actually asleep or not.
  7. Event rates per hour. A simplified view of the different types of events you have experienced. Note that some machines display more or fewer event types, and these can be selected in the Event flag selector on the Daily page.
  8. Statistics for pressure, leaks, snores, and respiration. Detailed information about your respiration throughout the night. The statistics panel gives details of your pressures, minute ventilation, respiration rate, and other important parameters. For each parameter (referred to as a 'channel') the panel shows the minimum recorded, the median, 95th percentile and the maximum. Also shown are the total time in apnea, and the time over the leak redline. For Resmed machines, this is 24 L/min. For all machines the redline number can be set in the menu File | Preferences | CPAP.
  9. Machine Settings Details. A more complete set of machine settings giving you the pressure and other settings for your machine. The settings shown will vary according to the type of machine.
  10. Session Information. Each time the machine is started then stopped is called a session. If you sleep right through the night, that is a single session. If you stop the machine for a toilet break then start it again, then two sessions will be recorded.
  11. Buttons (bars) to turn sessions on and off. Clicking on these buttons will include or exclude sessions from the display of the night's data. Clicking on the blue and yellow session buttons will include or exclude sessions from the display of the night's data. This can be useful if (for example) you had a very brief nap in the afternoon and want to exclude it from the night's results. Note that turning a session off will change the calculated AHI for the night. Note also that sessions can be turned on and off using the small green/black buttons in the section information panel. When a session is off the button changes to black / red.


The Calendar

OSCAR Calendar.png

The calendar can be useful for navigation, but if you are posting an OSCAR Daily Detail graph on the forum, it should be minimized. To minimize the monthly calendar, just click on the triangle to the left of the current date.

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 any particular date is the data for the NIGHT that started on on that date and ended the following morning. And that's true regardless of whether you get to bed before midnight.

Now, look at the little arrows in the calendar.

  1. The two arrows that surround the bubble with the highlighted date move one day backward or forward.
  2. The third outside arrow on the far right ->| will immediately jump to the last date with data.
  3. The two arrows on the blue bar with the month's name allow you to jump forward or backward by a month.
  4. Pressing the downward triangle between the month and the year allows you to quickly change to a different month.
  5. Clicking the year allows you to quickly change to a different year.
  6. Pressing the upward-facing arrow in the bubble with the date in it will hide the calendar and change that triangle to a downward-facing triangle. Clicking the downward-facing triangle will show the calendar. The calendar covers up a lot of useful information and should always be hidden when making screenshots for uploading to a forum.

Pie Chart

OSCAR Pie chart.png


You can see a pie chart depicting the breakdown of your events.

To turn the pie chart on and off, go to the File menu and select File | Preferences | Appearance. For posting charts to the forum it's best to turn the pie chart off as it covers up more valuable information.

OSCAR Preferences Appearance.PNG

Summary Information (AHI, Machine, Hours, Event rates)

Items 4, 5, 6, and 7 in the sidebar image are collectively the summary information. They show your apnea-hypopnea index (AHI), brief details of your machine and its settings, the time you slept, and the events which occurred during your sleep.

Note that the AHI shown is only for the 'sessions' which are turned on (see below). The summary of events will only show those which are turned on in the event flag selector. The available events will vary among different types of machines.

Tabs: Details, events, notes and bookmarks

OSCAR Events tab.PNG
  • The Details tab is the default view which shows the statistics, machine settings, etc.
  • The Events tab Shows every apnea, hypopnea, large leak, and other significant events during the night. The numbers in brackets are the duration of the event in seconds. Clicking on any event will zoom the chart to show that event in detail.
  • The Notes tab allows you to keep a daily journal of your sleep experience. There are basic formatting buttons available as well as a slider to register how you feel (on a scale of Zombie to Awesome). You can also enter your weight each day.
    • The notes for a particular day can be included in the printed report. It's necessary to deselect all graphs except one, using the chart selector menu at the bottom right of the page. To print the report, go to the menu File | Print Report. Notes you have saved will be included in the printout.
    • You can export all your notes as an XML file for backup purposes or additional analysis. Use the menu option File | Backup Journal.
    • Oscar will calculate your body mass index (BMI) at the bottom of the Notes section. You must enter your weight each day. You must also enter your height in your profile (see Running Oscar for the First Time ). If either the weight or height is not entered the BMI calculation will not appear.
  • The Bookmarks tab lets you record the time of significant events you may wish to refer back to, such as an exceptionally long apnea.

Creating a bookmark

Bookmarks are created using the [bookmark tab] on the daily page:

  1. Click on the tab to open bookmarks
  2. On the flow rate graph, place the cursor on the event you wish to record (eg an apnea)
  3. Click the Add Bookmark button. A bookmark stating the time and date will be created.

OSCAR create bookmark.png

You can add text to a bookmark:

  1. Select the bookmark
  2. Double-click the words "Bookmark at xx:xx:xx" in the Notes column
  3. Type in your text
  4. Press Enter.
Reviewing bookmarks

In the [right sidebar] click on the Bookmarks button at the bottom of the sidebar. The sidebar will show a list of all the bookmarks which have been created.

To go to a particular bookmark, click on the date. OSCAR will open the daily page at that particular date. You can then click on a bookmark and OSCAR will adjust the display to show the event which has been selected.

You can search for particular text in your bookmarks using the search window at the top of the sidebar (under the word Bookmarks).

Deleting bookmarks

On the Daily page, select the bookmark you wish to delete, then click "Remove Bookmark" at the bottom of the panel.


The daily detailed graphs

The main part of the daily page is given over to the detailed graphs. These allow you to inspect all the important things which happened during the night, right down to a breath-by-breath review.

Common features of detailed graphs

Each daily graph chart has a number of features in common:

  • Turn graphs on or off: You can turn individual graphs on and off using the chart selector at the bottom right corner of the chart area. Click on the selector and a small menu will pop up, listing all the available graphs. Click on any one to turn it on or off. When turned on, the item will show a small green & black icon. If turned off, it will show a red and black icon. The available graphs will depend on your machine, and on settings in the preferences dialog.
  • Zoom level: The default view shows the whole night's chart compressed onto a single panel. You can zoom in and out for a closer view as follows:
  1. Left click anywhere on a graph;
  2. Right click anywhere to zoom out;
  3. Place the cursor on a graph, hold the Ctrl button and rotate the scroll wheel;
  4. Use the keyboard Up Arrow to zoom in and the Down Arrow to zoom out;
  5. To zoom out to the full view you can also right-click on any graph title and select "100% zoom level". Alternatively press and hold the Escape (Esc) key or Down Arrow on your keyboard for a couple of seconds.
  • Time scale: Along the bottom of each graph is a time scale to show when events occurred.
  • Pin chart in position: Double-click on the title of a graph to pin it in position. Once pinned, the graph will appear at the top of the screen and will not scroll with the other graphs.
  • Resize chart: You can change the vertical height of any graph by clicking in the divider line and dragging it up or down.
  • Pop out chart: Right-click on the graph label and select "Popout graph". A copy of the graph will be created in its own window, which can then be placed anywhere on the screen. If you pop out more than one graph, they will share a common window.
  • Clone graph: Right-click on the graph label and select "Clone graph". A copy of the graph will be created below the original. The cloned graph can be zoomed independently of all other graphs. To remove the clone, right-click on the title and select "Remove clone".
  • Reset graph layout: If you have changed the vertical height of one or more graphs, double click on a graph title and select "Reset graph layout". All graphs will be restored to their normal height.
  • Y Axis: If you want to change the vertical scale of a graph, right-click in the label of a graph and select "Y axis". A small pop-up will show, and give the options Autofit, Defaults, and Override. Select override, the adjust the minimum and maximum numbers until the trace on the graph is to your liking. Note that you must keep the mouse cursor within the pop-up - if it strays outside, the pop-up will disappear.


OSCAR Graph Y-axis scaling.png

  • CPAP overlays: Oscar can include a marker for each of the events on any of the graphs. Right-click the graph title and select 'CPAP Overlays'. A pop-up will appear, allowing you to turn on or off each type of event. The events will appear as a short tick along the top of the graph.
  • Oximeter overlays: If you have a pulse oximeter synched to Oscar you can display certain parameters using the oximeter overlay option.
  • Dotted lines: Oscar will display dotted lines across a graph to aid in reading it. The available lines will vary depending on the particular graph. Right-click on a graph title and select "Dotted lines". A pop-up will appear, with a list of available lines which you can turn on or off.

Daily (Standard Charts)

To reset the graph order for the Standard Charts click on View/Reset Graphs/Standard
These are the charts that are most used to see how your therapy is doing. When submitting for review these charts should be provided in a full night view. If you wish to submit a partial night highlighting a problem feel free to do so in addition to the full night.

  • 3-Minute view to see the form of the breaths
  • 10-15 minute view to evaluate breathing patterns such as CSR and PP/Periodic Breathing


Event Flags

OSCAR event flags.PNG

The Event Flags graph normally appears at the top of the stack. It shows each event (Obstructive Apnea (OA), Central Apnea/Clear Airway (CA), Hypopnea (H), Large Leak (LL), etc.) as a vertical bar. You can select which events to display using the event flag selector at the bottom left of the chart area. The available flags will vary depending on your machine. The graphical display of events is useful in determining whether they occurred at a particular time, in clusters, or spaced throughout the night.

Each event type in the Event Flags graph will have a corresponding entry in the sidebar summary area.

OSCAR sidebar summary.png

First, Events only show if you have had them at some point, OSCAR remembers. If you have NEVER had a Clear Airway/Central Apnea event (CA) recorded, none will show. The same for RERAs (RE), though not all machines report RERAs. Second, if you have previously had an event type such as Clear Airway/Central Apnea event (CA) recorded, that category will always display even if you have none on the current night. The events shown here are all, alright, almost all, reported by your xPAP machine.

The exception: In the File/Preferences/CPAP tab there is a section for those of you that may want to experiment called Custom CPAP User Event Flagging. This allows you to define different Flow Restrictions and Event Durations


OSCAR Custom CPAP Event Flagging.png

Issue - Positional Apnea

Positional Apnea is caused by misalignment of the airway typically tucking the chin down.
It is normally detected by clusters of Obstructive and Hypopnea events usually associated with an uneven and smaller/narrower Flow Rate chart.

Severe Positional Apnea.png

see the Wiki article Optimizing_therapy#Positional_Apnea

Issue - Other

Correlation with other charts indicating cause and effect


Flow Rate

ResMed S9, Philips Respironics System One, and Fisher & Paykel Icon machines record Flow Rate data if the card is in the CPAP machine during the night.
The DeVilbiss IntelliPAP does NOT record Flow Rate data.

OSCAR flow rate graph.png

This graph is probably the most used in analyzing and interpreting CPAP data. It shows airflow in and out of your lungs throughout the night. The flow above the zero line is inhalation and below the line is exhalation. The events are shown on this graph as well as on the event flags graph. You can zoom in to examine an event more closely.

Placing the cursor on any event will create a small pop-up detailing the type and duration of the event in seconds.

OSCAR flow rate detail.png

Nearly all that is happening throughout the night can be seen in the Flow Rate graph though usually in a zoomed view. Tidal Volumes and Minute Vent can be seen via the 'volume under the curve', flow limits may show as "grassy" on the full night view but are readily apparent when viewed with the breath waveform is readily distinguished, typically 2-3 minutes. Leaks may sometimes be distinguished by a difference in volume between inhale and exhale. Periodic Breathing can be confirmed easily on this chart and serious breathing patterns such as CSR can be identified and Flow Limits become readily apparent.

Issue - Positional Apnea (Chin tucking)

Severe Positional Apnea FL Closeup.png

Issue - Preiodic Breathing (CSR, PB)

Note: ResMed (incorrectly) labels all periodic breathing as CSR. All Periodic Breathing should be viewed in a zoomed view to identify its properties.


Philips Respironics machines flag breathing that meets their definition of periodic breathing (PB). On the Philips Respironics web pages, PB is defined as "Periodic breathing is defined as alternating periods of hyperventilation with waxing/waning tidal volume..." Typically the waxing and waning pattern must be quite regular in visual appearance and it must present for at least a minute or two for PB to be scored. PB is flagged with a green background on the flow rate data. Often, but not always, there will be CAs (or Hs or sometimes OAs) scored at the nadir of the cycle. Sometimes the System One will only flag the most obvious part of the cycle:
PB zpsee6cff1e.png
A bit of PB now and then is nothing to worry about. However, there is one form of PB that is called Cheyne-Stokes Respiration (CSR) that is clearly associated with some forms of heart disease, including congestive heart failure. CSR is very regular and has a CA at the nadir of the cycle (although the CA may be mis-scored as an OA or a UA). If you have serious heart disease and you see a lot of PB scored in your flow rate data, it is worth mentioning it to your cardiologist as well as your sleep doctor.

Detecting Periodic Breathing on other CPAPs

Once you know what PB looks like, you can often spot suspicious patterns by simply scrolling through the Flow Rate data in a 5-10 minute window. Any periodic waxing/waning patterns will show up at that magnitude. Whether this is worth doing on a regular basis is another question altogether. Unless you have a co-morbid condition that is associated with PB (such as congestive heart failure), PB is not something you need to spend much time worrying about or trying to locate in your data.

Here's an example of PB that may be CSR pulled from a ResMed machine:
CSR-example zpsee76d5af.jpg


Issue - Various (Flow Limitation, Snoring, Mouth Breathing)

Flow limitation images zpsdb148d1f.jpg


Pressure

Pressure and Mask Pressure

The pressure graph shows the pressure as it varies over time. The mask pressure graph shows the pressure at the mask on a breath-by-breath basis.

OSCAR pressure.png

Zooming in shows how the mask pressure is a high-resolution chart sampled 25 times per second, while the pressure is only sampled once per second. Depending on your machine settings there may be several traces shown - usually the inhale pressure (IPAP) and exhale pressure (EPAP).

OSCAR pressure detail.png


Flow Limit.

Philips Respironics: PR machines do not produce this chart, instead they show FL events on the Events chart.

ResMed: Flow Limits are calculated as an index, 0-1, indicating the flatness of the breath-form on the flow rate chart. Zero means none, severity increasing as the index approaches one. These show as a varying height vertical bar.

This is an important chart. Flow Limits are the 'foundation' of obstructive events. The least severe of these events are flow limits followed by hypopnea and then obstructive apnea. They are often identified as a fundamental part of RERAs and UARS.
Note that on this chart flow limits are under-reported as compared to what we can visualize on the flow rate graph discussed above.

If you have a lot of flow limits here, it is a good idea to review the Flow Rate chart for Flow Limits that do not show in this chart.

OSCAR flow limitation.png

Issue - Pressure Increasing

Flow Limits are often the main driver of pressure increases, especially with ResMed devices. Seeing Flow Limits in this graph is almost always accompanied by an increase in pressure as the ResMed algorithms depend heavily on the flow limits that are shown in this graph.


Leak Rate

The leak rate graph indicates whether excessive mask leaking occurred, and to what extent. All CPAP masks are designed to leak or vent surplus air away from the user's nose or mouth. This flushes away the exhaled breath and prevents the user from re-breathing his expelled CO2. The actual amount of this designed leak will vary according to the mask. Anything in excess of that amount is an "additional leak".

Resmed machines show a single trace indicating the additional leak. By default (in accordance with Resmed guidelines), Oscar flags any additional leak over 24 L/min as an excessive or "large leak". You can adjust the red line between acceptable and unacceptable leaks by using File | Preferences | CPAP | Flag leaks over threshold.

Philips machines show two traces - total leak and additional leak. It is the lower additional leak line that indicates whether the leak is excessive or not.

Leak graph from Resmed machine showing excessive leakage
Leak graph from Resmed machine showing excessive leakage


Leak graph from Philips machine showing upper and lower traces
Leak graph from Philips machine showing upper and lower traces


Snore

Resmed and Philips machines both show snoring as a graph with the height of the trace indicating the intensity of the snoring. In addition, Philips machines show individual snores as events labeled VS1 and VS2 (vibratory snore 1 and 2). It is usually suggested that VS2 be turned off when presenting screenshots for discussion as the large number of events recorded can overwhelm other data on the charts.

OSCAR snore graph from Resmed machine
OSCAR snore graph from Resmed machine


Zeo Data

If data has been imported from a Zeo sleep monitor device, additional graphs will be available, including Sleep stage,

OSCAR Zeo.png


Daily (Advanced Charts)

To reset the graph order for the Advanced Charts click on View/Reset Graphs/Advanced

Event Flags, Flow Rate

Event Flags, Flow Rate see Daily (Standard Charts) for description

Mask Pressure

Mask Pressure is used in advanced cases such as for Central Apnea or other breathing issues where the breathing is paced (Timed) such as in some cases of COPD. It lets us see how the pressure is being delivered.

ResMed ASV - Example

See the relationship between Pressure and Mask Pressure. The Pressure chart looks a little jointed, because of its resolution. I view it as the current target pressure. Here there are two plots, the top red one is IPAP or inhale pressure, the bottom green one is EPAP or Exhale pressure, the difference is the intended Pressure Support (or EPR with an AirSense)
Mask Pressure is the Pressure at the mask. It is recorded in much higher resolution than Pressure is.


In this example, you can see the shape of the pressure delivered by the Resmed ASV. Compare it to the square-wave which is what Philips gives, even with Flex at 3. Look how normal the resulting respiratory flow rate is. Midway through this graph is an obstructive UA event (we know it's obstructive because the Resmed doesn't miss a central). Note how quickly pressure hits the top of the PS setting when a breath is missed. It doesn't step up over 4-breaths, it comes in right away and backs off as soon as respiration is spontaneous. The Philips lags in both directions. As a result, the Resmed does not very often miss its minute vent target.

ASV Mask Pressure - ResMed.png


Tidal Volume

Minute Vent

Insp. Time

Exp. Time

Resp. Rate


Daily (Other Charts)

AHI

This chart is basically a running count of the number of 'events' in the previous 60 minutes. As such, it is not particularly useful, since you can see the clusters in the Event Flags chart at the top, and also see which types of events are occurring.


Time at Pressure

OSCAR Calculations

This section is new and under development, so please bear with us.
Mostly OSCAR is a reporter, it is even in the name, OSCAR - the Open Source CPAP Analysis Reporter.,br.

Here is what OSCAR calculates, including the math behind it.


Insp. Time

  • Some ResMed's do not report I and E times, Which ones do not (AutoSet, Elite?). Which ones are "Calculated" by OSCAR?

Exp. Time

  • Some ResMed's do not report I and E times, Which ones do not (AutoSet, Elite?). Which ones are "Calculated" by OSCAR?

Compliance

There are several different Compliance requirements out there, FAA, DOT, Medical Insurance. These requirements vary by the requiring organization and may even vary by country. It is the certifying organization that determines what the criteria is and it is they who may or may not accept OSCAR data as satisfying their documentation requirements.
The compliance requirements vary by the number of days use over a period of time and the required number of hours use per day. If the xPAP is not used during any given day it is considered a "non-compliant" day.

  • Compliance is calculated by OSCAR.




Donate to Apnea Board