windowmasker-2-2-22-adapter-py
Quick Start
- Command:
windowmasker_2.2.22_adapter.py [--print-only] /path/to/windowmasker <old-style-options> - Local executable:
/home/vimalinx/miniforge3/envs/bio/bin/windowmasker_2.2.22_adapter.py - Full reference: See
references/help.md
When To Use This Tool
- Translate historical WindowMasker 2.2.22-era command lines into the newer option style.
- Preserve old pipeline invocations while moving to a newer
windowmaskerbinary. - Preview the translated command with
--print-onlybefore executing it. - Handle old
mask,-mk_counts true, and-convert truestyle invocations without manually rewriting every option.
Common Patterns
# 1) Print the translated command without running it
windowmasker_2.2.22_adapter.py \
--print-only \
/home/vimalinx/miniforge3/envs/bio/bin/windowmasker \
-mk_counts true \
-in genome.fa \
-out counts.obinary
# 2) Translate and execute an old masking command
windowmasker_2.2.22_adapter.py \
/home/vimalinx/miniforge3/envs/bio/bin/windowmasker \
-ustat counts.obinary \
-in genome.fa \
-out intervals.txt \
-outfmt interval
# 3) Translate an old convert-mode command
windowmasker_2.2.22_adapter.py \
--print-only \
/home/vimalinx/miniforge3/envs/bio/bin/windowmasker \
-convert true \
-in wm.out \
-out converted.out
Recommended Workflow
- Treat this as a migration helper for old WindowMasker command lines, not as a primary masking tool.
- Start with
--print-onlyand compare the translated command to the currentwindowmasker -helpoutput. - Keep the actual
windowmaskerexecutable path explicit; the adapter passes it through unchanged. - Once translation looks correct, run the real
windowmaskercommand or let the adapter execute it for you.
Guardrails
- This script uses Python 2 syntax; in the current workspace it fails under Python 3, and
python2is not available on PATH. - The first non-flag argument must be the target
windowmaskerexecutable; the adapter does not discover it for you. --print-onlyis the safe default because the adapter will otherwise execute the translated command viaos.system.- The adapter silently drops or preserves old options based on mode (
mask,mk_counts, orconvert), so always inspect the translated command before trusting it. - If you are already on a modern pipeline, prefer calling
windowmaskerdirectly instead of introducing this compatibility shim.