Guide · 7 min read
How to edit a SOR file
To edit a SOR file, open it in the OTDR Wizard SOR editor, select an event on the trace or in the table, change its values in the panel, and select Download .sor. Everything you did not edit, including the trace and the instrument’s own data, is copied into the new file unchanged, and the file is read back and checked before it is offered. The editor is part of the Pro and Business plans; each downloaded file counts as one export.
Open the file
- From the viewer, open the file and select the pencil (Edit) in the top bar. The file opens in the editor.
- Or go to /editor/ and choose a file. The editor works on one file at a time.
The file is read and edited in your browser tab. It is never uploaded. Your work is kept in this browser as a draft, so a refresh does not lose it.
The tools
The tools are icons next to the trace (under it on a phone). Hover or long-press for the name; each has a keyboard shortcut.
| Tool | Key | What it does |
|---|---|---|
| Select | V | Tap an event to select it; drag to pan, scroll to zoom |
| Zoom | Z | Drag across the trace to zoom in |
| Add | A | Tap where an event is; its values are measured from the trace |
| Move | M | Drag an event along the trace |
| Delete | Del | Delete the selected event |
| Fibre end | E | Find the fibre end on the trace |
| Fit | F | Show the whole trace |
Undo and redo are in the top bar (Ctrl+Z, Ctrl+Shift+Z), with the list of changes next to them.
Edit an event
Select it, then change any of these in the Event tab:
- Position in km. Its loss markers move with it.
- Event loss and reflectance in dB.
- Type: non-reflective (a splice or bend), reflective (a connector) or saturated.
- Section attenuation: the dB/km of the fibre before the event.
- Comment.
Measure fits lines to the trace before and after the event and suggests the loss, the reflectance and the section attenuation, the way an OTDR does with least-squares markers. Select Use these values to apply them, or type your own.
Find the fibre end
The fibre end belongs where the trace shows it: the point where the backscatter stops and the trace falls to the noise, usually with a reflection. Select Find the fibre end (E). The editor reads the end from the trace and tells you what it found:
- The fibre end is in the right place: nothing to change. If events come after it, you can delete them, because an event past the fibre end is not part of the fibre.
- The trace ends somewhere else: for example when the OTDR put the end on a ghost (a false reflection after the real end) or on the noise. Select Set the end at … to put the fibre end where the trace ends. An event is added there if there is none, measured from the trace, and the events after it can be deleted in the same step.
- The end is not clear: when the trace does not fall clearly to the noise, or when the file stores its events with a different offset from its trace.
Only then, you can make the selected event the fibre end by hand, after a warning. The editor never changes the trace itself, so the end cannot be moved to change a measured length; the end event can only be dragged a short way (about two pulse lengths) from the end the trace shows. The end-to-end loss marker follows the end. In the Totals tab you can keep the instrument’s total loss, type one, or use the sum of the events or the value measured from the trace.
Change the group index
In Settings, change the group index (IOR). SOR files store positions as time, so every distance in the file follows the new value; see how OTDR distance is calculated.
Fix the test information
The Test info tab holds the cable and fibre IDs, fibre type, start and end locations, cable code, condition (new, as repaired or other), operator and comment. The Instrument tab holds the supplier, models, serial numbers, software version and notes such as the calibration date.
SOR files store text one byte per letter, so use Latin letters, digits and common symbols.
What is kept, and what is marked
- The trace, the measurement settings that describe how it was taken (pulse width, sampling, wavelength) and the vendor’s own blocks are not editable and are copied unchanged.
- Events you add, move or change get the standard SR-4731 marks in their event code: A for added, M for moved or edited, D for a fibre end set by hand. Other software can see them.
- An edit log inside the file lists every change with its date. When the file is opened in the OTDR Wizard viewer, it says “Edited with OTDR Wizard” and how many changes were made.
Download
Select Download .sor. The editor saves the file, reads it back and checks that:
- everything you did not edit is byte-for-byte the same;
- every value you changed reads back as you set it;
- the checksum is valid for the scheme the file already used.
The new file is named <name>_edited.sor; your original file is not touched.
Edited files are tested with the open-source pyOTDR and otdrparser readers. Vendor software can keep its own copy of the analysis in its private blocks, so check an edited file in the instrument maker’s software before you rely on it there.
Edit many files at once
With the Business plan, Batch edit changes the test information of many files at once and downloads them as one ZIP. It never changes events: those differ from file to file and are edited one file at a time.
- Cable and fibre: the cable ID, a numbered fibre ID and the fibre type (G.652, G.657 and others).
- Test information: start and end locations, cable code, operator, comment and condition.
- Settings: the group index (IOR) and the backscatter coefficient.
- File names: a pattern for the saved files.
Fields left empty keep each file’s own value. Files are sorted by name (F2 before F10) and numbered in that order, from the number you choose. Any text field and the file name can use:
| Pattern | Becomes |
|---|---|
{n} | the file’s number: 1, 2, … 48 |
{nn}, {nnn} | the number with zeros: 01 or 001 |
{name} | the file name without .sor |
{cable}, {fibre} | the new cable and fibre IDs (file names only) |
For example, a fibre ID of F{nn} and a file name of {cable}_{fibre} save the 48 files of cable CBL-07 as CBL-07_F01.sor to CBL-07_F48.sor. A preview shows each file’s old and new values and its new name before you download. Each file goes through the same checks as a single edit and counts as one export.