sofistik-tools
Commands and integrations for SOFiSTiK structural analysis workflow
asiloisad 79 1 1.4.10 MIT GitHub

sofistik-tools

Commands and integrations for SOFiSTiK structural analysis workflow.

Features

  • Help system: Open PDF manuals in pdf-viewer.
  • Calculation: Run WPS/SPS directly from the editor.
  • File handlers: Open CDB, PLB, GRA files with double-click.
  • Program control: Toggle programs on/off in .dat files.
  • Clean commands: Delete temporary files from tree-view.
  • Child files: Run multiple files with @ child:filename.dat directive.

Installation

To install sofistik-tools search for sofistik-tools in the Install pane of the Pulsar settings or run ppm install sofistik-tools. Alternatively, you can run ppm install asiloisad/pulsar-sofistik-tools to install a package directly from the GitHub repository.

This package requires language-sofistik.

Configuration

Setting Description
SOFiSTiK installation path Path to the SOFiSTiK installation folder (default: C:\Program Files\SOFiSTiK)
Enable keystroke hints Show info message with keystroke hints in selection lists

Version resolution

The package determines which SOFiSTiK version to use in the following priority order:

  1. Shebang in file: @ SOFiSTiK 2026 or @ SOFiSTiK 2024-05 comment in the file (searched backwards from cursor)
  2. Project configuration: sofistik.def file in the same directory with SOF_VERSION = 2026
  3. Package setting: Version configured in language-sofistik settings

Features

Help system

The help view opens PDF manuals directly in Pulsar using pdf-viewer. When cursor is on a command, it jumps to that command's documentation.

File handlers

The package registers handlers for SOFiSTiK file types. Double-clicking these files in tree-view opens them in the appropriate application:

Extension Application
.cdb Animator
.plb Report Viewer
.gra WinGRAF
.results Result Viewer
.sofistik SSD
.dwg SOFiPLUS (if sofistik.def exists)

Child files

Use @ child:filename.dat directive to run multiple files in sequence. Use @ only-children to skip the parent file itself.

Commands

Commands available in atom-text-editor[data-grammar="source sofistik"]:

  • sofistik-tools:current-help: open help for current module in PDF viewer (reuses pane),
  • sofistik-tools:separately-help: open help for current module in new pane,
  • sofistik-tools:calculation-wps: open WPS with current file,
  • sofistik-tools:calculation-wps-immediately: run calculation in WPS,
  • sofistik-tools:calculation-wps-current: run calculation of current program only,
  • sofistik-tools:calculation-sps-immediately: run calculation in SPS,
  • sofistik-tools:open-report: open .plb file in Report Viewer,
  • sofistik-tools:save-report-as-pdf: export report to PDF,
  • sofistik-tools:save-pictures-as-pdf: export pictures from report to PDF,
  • sofistik-tools:open-protocol: open .prt protocol file in editor,
  • sofistik-tools:open-animator: open .cdb in Animator,
  • sofistik-tools:open-animator-2018: open .cdb in Animator 2018,
  • sofistik-tools:open-viewer: open .cdb in Viewer (2024+) or FEA Viewer (2020-2023),
  • sofistik-tools:open-dbinfo: open .cdb in Database Info,
  • sofistik-tools:open-ssd: open .sofistik file in SSD,
  • sofistik-tools:open-wingraf: open .gra file in WinGRAF,
  • sofistik-tools:open-result-viewer: open .results file in Result Viewer,
  • sofistik-tools:open-teddy: open file in Teddy,
  • sofistik-tools:open-teddy-single: open file in Teddy (single instance),
  • sofistik-tools:open-teddy-1: open file in Teddy slot 1,
  • sofistik-tools:open-teddy-2: open file in Teddy slot 2,
  • sofistik-tools:open-teddy-3: open file in Teddy slot 3,
  • sofistik-tools:open-teddy-4: open file in Teddy slot 4,
  • sofistik-tools:open-sofiplus: open .dwg file in SOFiPLUS,
  • sofistik-tools:export-cdb: open CDB export dialog,
  • sofistik-tools:export-plb-to-docx: convert .plb to .docx (2020+),
  • sofistik-tools:program-current-toggle: toggle current program on/off,
  • sofistik-tools:program-all-toggle: toggle all programs,
  • sofistik-tools:program-all-on: turn ON all programs,
  • sofistik-tools:program-all-off: turn OFF all programs,
  • sofistik-tools:program-above-toggle: toggle programs above cursor,
  • sofistik-tools:program-above-on: turn ON programs above cursor,
  • sofistik-tools:program-above-off: turn OFF programs above cursor,
  • sofistik-tools:program-below-toggle: toggle programs below cursor,
  • sofistik-tools:program-below-on: turn ON programs below cursor,
  • sofistik-tools:program-below-off: turn OFF programs below cursor,
  • sofistik-tools:clear-urs-tags: remove all URS tags from programs,

Commands available in atom-workspace scope:

  • sofistik-tools:toggle-help: open help selection list,
  • sofistik-tools:cache-help: rebuild help cache,
  • sofistik-tools:toggle-examples: open examples selection list,
  • sofistik-tools:cache-examples: rebuild examples cache,
  • sofistik-tools:change-version: change SOFiSTiK version,
  • sofistik-tools:ifc-export: open IFC export dialog,
  • sofistik-tools:ifc-import: open IFC import dialog,
  • sofistik-tools:open-cdbase.chm: open database description (CDBASE.CHM),

Commands available in .tree-view scope:

  • sofistik-tools:open-animator: open selected .cdb in Animator,
  • sofistik-tools:open-animator-2018: open selected .cdb in Animator 2018,
  • sofistik-tools:open-report: open selected .plb in Report Viewer,
  • sofistik-tools:save-report-as-pdf: export selected report to PDF,
  • sofistik-tools:save-pictures-as-pdf: export pictures from selected report,
  • sofistik-tools:open-protocol: open selected .prt file,
  • sofistik-tools:open-viewer: open selected .cdb in Viewer,
  • sofistik-tools:open-viewer-2025: open selected .cdb in Viewer 2025,
  • sofistik-tools:open-dbinfo: open selected .cdb in Database Info,
  • sofistik-tools:open-ssd: open selected .sofistik in SSD,
  • sofistik-tools:open-wingraf: open selected .gra in WinGRAF,
  • sofistik-tools:open-result-viewer: open selected .results in Result Viewer,
  • sofistik-tools:open-teddy: open selected file in Teddy,
  • sofistik-tools:open-teddy-single: open in Teddy (single instance),
  • sofistik-tools:open-teddy-n: open in Teddy slot n=1-4,
  • sofistik-tools:open-sofiplus: open selected .dwg in SOFiPLUS,
  • sofistik-tools:export-cdb: open CDB export for selected file,
  • sofistik-tools:clean-1: clean directory from files with extensions .erg .prt .lst .urs .sdb .db-2 .pl .$* .#* .grb .err .error_positions .dwl .dwl2 .cfg,
  • sofistik-tools:clean-2: above + .cdi .cde,
  • sofistik-tools:clean-3: above + .cdb .sqlite,
  • sofistik-tools:clean-4: above + .plb .bak _csm.dat _csmlf.dat,
  • sofistik-tools:clean-glob: Use custom glob pattern,
  • sofistik-tools:wing-fix: fix MSCA issues in .gra files,
  • sofistik-tools:wing-fix-recursively: fix MSCA issues recursively.

Contributing

Got ideas to make this package better, found a bug, or want to help add new features? Just drop your thoughts on GitHub — any feedback's welcome!