ABR Graphical Masking Calculator - Instructions

Purpose: This calculator determines the appropriate masking noise level for ABR (Auditory Brainstem Response) testing, based on the formulae logic in Dr Guy Lightfoot's Excel calculator.

Quick Start

  1. Select patient age (required before plotting)
  2. Plot thresholds - Click on audiograms to plot AC and BC thresholds
  3. Check LEDs - Red = masking needed, Green = not needed
  4. Click any LED to see masking noise level and details

Session Management

Sessions allow you to save, share, and lock your audiogram data:

Button Function
💾 Save Saves session to server and creates a shareable URL. Sessions are editable until locked.
🔓 Lock & Share Permanently locks the session (read-only). Use this when ready for peer review. The icon changes to 🔒 when locked.
🗑️ Delete Deletes unlocked sessions. Locked sessions cannot be deleted.
Session Expiry: Sessions are automatically deleted after 6 weeks. Use "Export .abr" to keep a permanent local copy.

File Operations

Button Function
Export .abr Downloads your session as a .abr file (JSON format) for backup or transfer
Import .abr Loads a previously exported .abr file
Prepare Peer Review Exports thresholds to an Excel template for peer review documentation
Results Table Generates a formatted table for copying into patient management systems

Prepare Peer Review

This exports your plotted thresholds into a standardised Excel template used for ABR peer review documentation. The template is pre-filled with your threshold data, session URL, and test settings, reducing copy errors and replication work.

Results Table

Generates a formatted table of all plotted thresholds that can be copied directly into patient management systems or clinical documents. The table is formatted for easy pasting into Word or other applications.

Clicking on individual threshold values in the table copies them to clipboard with the nHL to eHL correction factor displayed. Some departments use this for annotating ABR trace PDFs with the corrected eHL values.

Example copied text:
Right 4kHz CE-Chirp AC(Inserts)
(>20) ≤30dBeHL
(>15) ≤25dBnHL

Plotting Thresholds

1 Select Patient Age

Patient age is required before plotting. Select from the dropdown or use the calculator:

2 Select Symbol Type

Type Right Ear (Red) Left Ear (Blue)
AC (Air Conduction) O X
BC (Bone Conduction)

Threshold Modifiers

Modifier Meaning MAT Created?
= Exact threshold No
Threshold at or better than this level (response present) Yes - MAT at 0 dBeHL if ≤30, otherwise at plotted level
˃ RA at this level (threshold is worse) Yes - MAT at plotted level +5dB (BC has additional rules)
≤/˃ Pairs: If you plot both ≤ and ˃ at the same frequency/ear/type, the MAT is calculated to maximize the air-bone gap for masking estimates.

3 Click on the Audiogram

dBeHL/dBnHL Toggle: Use the dropdown next to "Unit:" to switch between eHL and nHL units. The audiogram background changes to light blue in nHL mode.

Understanding MAT (Masking Assumption Threshold)

MAT = Masking Assumption Threshold - the threshold assumed for masking calculations when the actual threshold is unknown.

MAT points appear as grey symbols with MAT and are created automatically when you plot with ≤ or ˃ modifiers.

When you record a response (≤ modifier)

If you get a CR at 30 dBeHL or better, the calculator assumes hearing is normal and sets the MAT at 0 dBeHL. For air conduction, it will also create a bone conduction MAT at 0 dBeHL if you haven't already plotted one, since normal AC implies normal BC.

If the CR is above 30 dBeHL, the MAT is set at the level you tested at, since there may be some hearing loss present.

When there's RA (˃ modifier)

When you get RA at a level, the MAT is generally set 5 dB worse than where you tested, representing the assumption that threshold is just beyond the tested level.

For bone conduction with RA, the calculator also considers the air conduction threshold to avoid creating an impossible negative air-bone gap. If you're testing near the maximum bone conduction output (45 dBeHL or above), it assumes there's no air-bone gap and sets the BC MAT equal to the AC level.

When you have both ˃ and ≤ at the same frequency and ear

Sometimes you'll have both an RA level and a CR level for the same frequency and ear. In this case, the calculator positions the MAT to maximize the assumed air-bone gap, per clinical guidance. For AC it assumes threshold is 5 dB better than the CR level; for BC it assumes threshold is 5 dB worse than the RA level. This produces appropriate masking calculations.

Why MAT matters: When calculating masking, the calculator uses MAT values to estimate air-bone gaps when actual thresholds are unknown. This ensures masking calculations are clinically appropriate even with incomplete data.
Important: You should manually edit MAT points based on local protocols by clicking the MAT button (appears when MAT points exist) and clicking on the audiogram. Use the AC symbol to override an AC MAT and the BC symbol to override a BC MAT.
Normal MAT ← Click MAT to edit MAT points

LED Indicators

Coloured LED indicators appear next to each plotted threshold showing masking status at a glance:

LED Meaning
Red Masking is needed for this threshold
Green Masking is not needed
Click on any LED to see the masking calculation for that threshold. The full analysis appears below the audiograms.
Visual Feedback: When you click an LED, it appears with a sunken/pressed effect so you can easily see which threshold point is currently selected.

Masking Calculation Details

When you click an LED or query a stimulus level, the calculation results appear below the audiograms showing:

Query Mode (Optional)

Query mode lets you check masking requirements at stimulus levels you haven't plotted. This is useful for:

Click the QUERY? button, select AC or BC, then click on the audiogram at any stimulus level. A dashed symbol with ? appears showing the point being queried.

Fix as Threshold

After querying, if you've confirmed this as the threshold, click "Fix X dBnHL as new threshold?". The point becomes a normal plotted threshold with LED indicator, allowing you to update your audiogram as you test.

Masking Analysis Table

The Masking Analysis table appears below the audiograms once you have plotted points to assist with Peer Review. It shows:

Click any row in the table to see the full calculation details for that point.

Keyboard Shortcuts

Shortcut Action
A Select AC (Air Conduction)
B Select BC (Bone Conduction)
Ctrl+Z Undo last action (multiple levels supported)
Double-click Delete a plotted point

Display Options

Use the checkboxes below the Clear Audiogram button to customise the display for a cleaner audiogram view:

Option Effect
Hide Labels Hides dB values shown next to symbols
Hide LEDs Hides masking status indicator lights
Hide MATs Hides Masking Assumption Threshold points
Hide MAT Warnings Hides flashing warnings about unverified MAT points

Input Settings

Configure these to match your equipment (in the sidebar under the mode buttons):

Setting Description
ABR System Your ABR equipment (affects calibration values)
Stimulus Transducer Insert earphones, headphones, or BC
Noise Transducer How masking noise is delivered
Stimulus Type Click, CE-Chirp, or tone burst frequencies

Quick Start Profiles

After selecting patient age, you can load example audiogram configurations:

Profiles are available at 4kHz and 1kHz. They're useful for learning or quick demonstrations.

Direct Input Calculator

For users who prefer to enter values directly, use the ABG Calculator (🔢 button in header).

When you click this button from the graphical calculator after a query, your current settings are transferred automatically and masking is calculated immediately.

Excel Verification

For validation and troubleshooting, you can verify calculations against the original Excel spreadsheet:

Button Function
Verify vs Excel Compares current calculation results against the ABR Noise Calc2026.xlsx spreadsheet. Shows side-by-side comparison of Noise Level, Offset, Masking Needed, High Noise warning, and Cross-Masking Risk.
Download Excel Downloads a filled Excel file with your current inputs, preserving conditional formatting for visual verification.
Cross-Masking Thresholds: The gauge uses J16 values: ≤0 = Low, 0-10 = MODERATE, >10 = HIGH. High noise warning triggers when noise level (I20) > 99 dB.
Bandwidth Optimisation: "Verify vs Excel" only fetches calculation results (~1-2KB). "Download Excel" fetches the full spreadsheet file (~100KB). Use verify for quick checks.

Important Notes

Clinical Responsibility: This calculator is a time-saving guide only. The user must carry clinical responsibility for any decisions they make based on these calculations. Always verify results against clinical judgment and local protocols.
Unknown Thresholds: When thresholds are unknown, use the ≤ or ˃ modifiers to indicate the limits of what you've tested. The calculator will create appropriate MAT points for masking calculations. If in doubt, use values that result in higher masking noise.