User Guide
Welcome to the Sigilweaver User Guide. This documentation covers everything you need to build data transformation workflows.
Getting Started
Sigilweaver is a visual data pipeline tool that lets you build complex data transformations through an intuitive drag-and-drop interface. Under the hood, it uses Polars for fast, efficient data processing with lazy evaluation.
If you're switching from Tableau Prep, Alteryx, Power Query, KNIME, Orange, or Excel, check out our Crash Courses to quickly map what you already know to Sigilweaver's approach.
Documentation Sections
Interface
Learn how to navigate Studio:
- Canvas - The main workspace where you build workflows
- Tool Palette - Find and add tools to your workflow
- Wiring - Connect tools to create data flows
- Configuration Panel - Configure tool settings
- Data Preview - Inspect data at any point in your workflow
- Keyboard Shortcuts - Work faster with shortcuts
- Managing Connections - Set up database connections securely
- Using Hub - Connect to Hub for team features
Expressions
Master the expression language used in Filter and Formula tools. Don't worry - the editor has full autocomplete, so you don't need to memorize anything:
- Basics - Autocomplete, column references, and operators
- Syntax Rules - Parentheses, multi-line expressions, and gotchas
- Common Operations - String manipulation, dates, casting, and null handling
Data Types
Understand the data types Sigilweaver supports and when to use each.
Tools
Reference documentation for every tool:
| Category | Tools |
|---|---|
| Input/Output | Input, Output |
| Preparation | Filter, Select, Sort, Formula |
| Join | Union, Join |
| Aggregate | Summarize |
Core Concepts
Lazy Evaluation
Sigilweaver uses Polars' lazy evaluation model. This means:
- Operations are not executed immediately when you build the workflow
- The entire pipeline is optimized before execution
- Data is processed efficiently in a streaming fashion when possible
This allows you to work with datasets much larger than your available memory.
Workflows
A workflow is a directed acyclic graph (DAG) of tools connected by wires:
- Tools perform operations on data (filtering, joining, aggregating, etc.)
- Wires connect tool outputs to tool inputs, defining data flow
- Sockets are the connection points on tools (inputs on the left, outputs on the right)
Expressions
Many tools use Polars expressions for configuration. Expressions let you:
- Reference columns:
pl.col("column_name") - Apply transformations:
pl.col("price") * 1.1 - Filter rows:
pl.col("status") == "active" - Combine conditions:
(pl.col("a") > 10) & (pl.col("b") < 20)
See the Expressions section for a complete guide.
External Resources
- Polars User Guide - Full Polars documentation
- Polars Expression Reference - Complete expression API
- GitHub Repository - Source code and issue tracker
For Administrators
If you're managing a Sigilweaver Hub deployment for your team, see the Administrator Guide for:
- Roles and Permissions - Understanding access control
- User Management - Creating and managing user accounts
- Groups - Organizing users and controlling access
- Hub Connections - Providing secure database access
- Server Management - Managing execution infrastructure
- Security Model - Zero-trust credential handling