📖 LS-DYNA Manual Integration & Interactive Hover (Click to expand)
Interactive Hover Cards: Keyword and field hover tooltips provide direct links to the corresponding page in the LS-DYNA PDF manual.
Fast Search: Powered by a custom binary PDF bookmark engine for fast retrieval.
Field-level Tooltips: Hover cards explain the keyword and detail the type, length, and default values of each specific field.
⚡ Autocomplete & Formatting (Click to expand)
Keyword Coverage: Data is extracted from the official ansys/pydyna database, supporting over 3100+ keywords.
Snippets: Offers formatted snippet templates for rapid keyword insertion.
Path Autocomplete: Type / to autocomplete included files in the same directory, filtering invalid paths.
Auto Comment Generation: Use $ or # to trigger automatic generation of field comments, right-aligned with no trailing spaces.
Tab Navigation: Press Tab to jump between fields distributed across 10-character widths, with auto line wrapping.
Formatting: Format to align data into the 10-column / 8-column layout. Supports auto-format on save.
Feature Demos:
🔑 Keyword Completion
🛤️ Path Completion
📝 Quick Comment
📐 Tab Jumping
✨ Formatting
📂 Include Management & Fast Preview (Click to expand)
Status Highlight & Relative Paths:*INCLUDE paths are highlighted in blue (resolved) or orange (missing). Resolves relative paths like *INCLUDE_PATH and ../.
Large File Preview: Hover over include paths to utilize an internal O(1) async streaming reader to show header previews.
Project Include Tree: Presents the nested hierarchy reference tree of the main model and all sub-included files in the sidebar.
Keyword Index Outline: The sidebar provides an overview tree of all used keywords in the current file, with jump-to-definition.
Include Tree & Index
Hover Preview
🛠️ Navigation & Parameter (*PARAMETER) Tracking (Click to expand)
Interactive CodeLens:
Renders "N references" CodeLens above parameter definitions; click to open the reference list.
Offers formatting and option swapping for keywords (e.g., appending _TITLE to *PART).
Parameter Resolution: Hovering over ¶meter variables parses their evaluated values.
Global Rename: Rename parameters globally across the document using the F2 key.
Editing Shuttle: Use Ctrl+Alt+Up / Ctrl+Alt+Down to warp to the previous/next keyword start; supports syntax highlighting and code folding for .k, .key, .dyna, .cfile formats.
⚙️ Extension Settings
In VS Code's settings.json, you can customize the following exclusive configurations:
Setting
Default
Description
lsdyna.additionalExtensions
[".txt"]
Dynamically add custom file extensions you want the extension to highlight.
lsdyna.hover.previewMaxLines
20
Controls the maximum number of lines displayed when hovering over an included file.
lsdyna.format.enableOnSave
true
Enables auto-formatting of data fields on the line where the cursor is located when saving (Ctrl+S).
lsdyna.index.enableIncludeTree
true
Enables the *INCLUDE nested hierarchy tree view in the sidebar.
[!TIP]
File Associations & Icons
By default, this extension targets .k, .key, .dyna, .asc files. If you want your custom files to not only be highlighted but also display the exclusive blue engineering icon in the file explorer, use the global setting:
"files.associations": { "*.my_ext": "lsdyna" }
Credits & Contributors
This project is a deeply customized and refactored version maintained by hqyyqh.
Special thanks to the following upstream open-source projects and original authors, without whose outstanding work this project would not exist:
Upstream Project: This project is forked from osullivryan/vscode-lsdyna. Huge thanks to the original author and core contributors:
Database Source: The powerful keyword and field intelligent autocomplete data heavily references and extracts from the official open-source project ansys/pydyna.
Other References: Excellent ecosystem works like vim-lsdyna.
Thank you to all developers who have contributed to the LS-DYNA editor ecosystem!
