Skip to content

mef3io-studio v0.1.0.dev5

Pre-release
Pre-release

Choose a tag to compare

@github-actions github-actions released this 21 Oct 21:04
0ef4824

This is a test version for students and researchers who work with MEF 3.0
recordings. It is not the finished app: some features are still missing, and
we would like to hear what is unclear or does not work. It adds a new page to
0.1.0.dev4;
0.1.0.dev2
has the full list of what the app can do.

Installers for Windows, macOS (14 or later) and Linux are attached below.
Check your download against the SHA256SUMS file.

These builds are not code-signed yet. Your computer will ask you to
confirm the first start:

  • Windows: "Windows protected your PC" → More info → Run anyway.
  • Mac: open the app once and close the warning, then go to System
    Settings → Privacy & Security
    and click Open Anyway next to the message
    about mef3io-studio. (On macOS 14: right-click the app → Open.) If
    macOS says the app "is damaged and can't be opened", the download was
    quarantined: move the app to Applications, run
    xattr -dr com.apple.quarantine /Applications/mef3io-studio.app in
    Terminal, then open it again.
  • Linux: make the AppImage executable (Properties → Allow executing),
    then double-click it.

What's new since 0.1.0.dev4

A new page: Join or trim. It makes one new recording from parts of
others; the originals are never changed.

  • Trim: keep only part of one recording, for example its first two
    hours, its last 30 minutes, or everything between two times.
  • Join: keep a part of each of several recordings and put them together,
    one after another or side by side: for example the last hour of one
    recording and the first hour of the next, or two recordings of the same
    hour made with different channels. Three or more work the same way, each
    trimmed at the start, the end or both.
  • From Explore: select recordings in the Explore list and choose Join
    or trim these…
    (a button under the list, or the right-click menu).
  • A preview shows every recording on one timeline with the part you
    keep, so gaps and parts running at the same time are easy to see. Parts
    that would clash are shown in red, with the reason.
  • Leave out channels, give the new recording a name, and protect it with new
    passwords if you want. Check and save checks everything before
    anything is written, then makes the new recording with one progress bar
    and a Stop button, and checks it against the originals before it
    gets its name.
  • "The last hour" is exactly the last hour of signal, whichever program made
    the recording.

Good to know: as before, times are shown in UTC until you choose the
time zone of the place where the recordings were made (View → Time
zone…
). Joining never moves anything in time.

What to try

Please use copies of recordings you are allowed to work with, or test
recordings without patient data.

  1. Trim a recording: keep its last 10 minutes, then open the new
    recording in Explore. Does it hold what you expected?
  2. Join the last hour of one recording with the first hour of the next.
    Is the gap between them where you expected it on the timeline?
  3. Try three recordings, trimming the first at its start and the last at its
    end, and try starting from a selection in Explore.
  4. Tell us which words or steps were confusing. That is as useful to us
    as a bug.

The user guide
explains every step. Settings (File → Settings) and About (Help →
About mef3io-studio
) are in the mef3io-studio menu on a Mac.

Known limitations

  • Not code-signed (see above).
  • Not in this version yet: cutting one recording into several pieces,
    sorting and renaming recordings, viewing and editing their details,
    adding or removing password protection on an existing recording, and
    saving a choice of channels to reuse. A signal viewer comes later.
  • Join or trim: two kept parts that run at the same time must not share
    a channel you keep (leave the shared channels out to join them); the
    recordings must be of the same patient and have the same sampling rate per
    channel. A recording opened only with its basic password cannot be used
    here: open it in Explore with the full-access password. The user guide has
    no picture of this page yet.
  • One choice for all note text: the text of notes is either removed from
    every copy or kept in every copy. Choosing per note is not possible yet.
  • Copies are made one after another, not several at once.
  • One archive for the whole batch cannot be opened in the app directly.
    Extract it first with any archive tool (7-Zip, the one built into Windows
    or macOS, or tar); you then get the recordings back as usual.
  • There is no saved report of an anonymization yet, apart from the list
    of original and new dates (saved only if you ask).
  • Left-out channel names inside longer words: if kept note text holds the
    name of a channel you left out glued into a longer word (for example "a3a3"
    when channel a3 is left out), the app refuses the copy before starting.
    Removing the note text avoids it.
  • Continuing a batch with very short names: when you kept note text or
    descriptions and the patient's name or ID, or the name of a channel you
    left out, has a part only one or two letters long (for example the O in
    O'Brien, or a channel called E), Make them
    again
    may treat another copy of the same recording, with the same name
    and dates but with that text removed, as its own and make it again. Your
    batch's own copies are never affected, and this matters only if such a
    copy appeared at the destination while the batch was stopped
    (#39).

Reporting a problem

Open an issue on GitHub.
Issues are public, so:

  • Never attach a recording, a screenshot that shows patient details, or
    real names, dates or folder names. Describe what you did and what you saw
    instead.
  • Say which version you use (Help → About mef3io-studio; on a Mac, in
    the mef3io-studio menu) and on which computer (Windows, Mac or Linux).
  • If the app itself does not seem to work, Help → Check this
    installation
    tests it with a small made-up recording; tell us what it
    says.
  • The app's log (Help → Open the log folder) leaves out patient details,
    names, folder paths and dates. Still, read it before you attach it.

If you find that an anonymized copy still contains patient details or a real
date, please do not open a public issue. Report it privately instead:
report a privacy problem.