Tellius
  • 🚩Getting Started
    • 👋Say Hello to Tellius
      • Glossary
      • Tellius 101
      • Navigating around Tellius
      • Guided tours for quick onboarding
    • ⚡Quick Start Guides
      • Search
      • Vizpads (Explore)
      • Insights (Discover)
    • ✅Best Practices
      • Search
      • Vizpads (Explore)
      • Insights (Discover)
      • Predict
      • Data
    • ⬇️Initial Setup
      • Tellius architecture
      • System requirements
      • Installation steps for Tellius
      • Customizing Tellius
    • Universal Search
    • 🏠Tellius Home Page
  • Kaiya
    • ♟️Understanding AI Agents & Agentic Flows
      • Glossary
      • Composer
      • 🗝️Triggering an agentic workflow
      • The art of possible
      • Setting up LLM for Kaiya
    • 🤹Kaiya conversational AI
      • ❓FAQs on Kaiya Conversations
      • Triggering Insights with "Why" questions
      • Mastering Kaiya conversational AI
  • 🔍Search
    • 👋Get familiar with our Search interface
    • 🤔Understanding Tellius Search
    • 📍Search Guide
    • 🚀Executing a search query
      • Selecting a Business View
      • Typing a search query
      • Constructing effective search queries
      • Marketshare queries
    • 🔑Analyzing search results
      • Understanding search results
      • Search Inspector
      • Time taken to execute a query
      • Interacting with the resulting chart
    • 📊Know your charts in Tellius
      • Understanding Tellius charts
      • Variations of a chart type
      • Building charts from Configuration pane
      • List of chart-specific fields
      • Adding columns to fields in Configuration pane
      • Absolute and percentage change aggregations
      • Requirements of charts
      • Switching to another chart
      • Formatting charts
      • Advanced Analytics
      • Cumulative line chart
    • 🧑‍🏫Help Tellius learn
    • 🕵️‍♂️Search history
    • 🎙️Voice-driven search
    • 🔴Live Query mode
  • 📈Vizpads (Explore)
    • 🙋Meet Vizpads!
    • 👋Get familiar with our Vizpads
    • #️⃣Measures, dimensions, date columns
    • ✨Creating Vizpads
    • 🌐Applying global filters
      • Filters in multi-BV Vizpads
      • Filters using common columns
    • 📌Applying local filters
    • 📅Date picker in filters
      • Customizing the calendar view
    • ✅Control filters
      • Multi-select list
      • Single-select list
      • Range slider
      • Dropdown list
    • 👁️Actions in View mode
      • Interacting with the charts
    • 📝Actions in Edit mode
      • 🗨️Viz-level actions
    • 🔧Anomaly management for line charts
      • Instance level
      • Vizpad level
      • Chart level
    • ⏳Time taken to load a chart
      • Instance level
      • Vizpad level
      • Chart level
    • ♟️Working with sample datasets
    • 🔁Swapping Business View of charts
      • Swapping only the current Vizpad
      • Swapping multiple objects
      • Configuring the time of swap
    • 🤖Explainable AI charts
  • 💡Insights (Discover)
    • 👋Get familiar with our Insights
    • ❓Understanding the types of Insights
    • 🕵️‍♂️Discovery Insights
    • ➕How to create new Insights
      • 🔛Creating Discovery Insight
      • 🔑Creating Key Driver Insights
      • 〰️Creating Trend Insights
      • 👯Creating Comparison Insights
    • 🧮The art of selecting columns for Insights
      • ➡️How to include/exclude columns?
  • 🔢Data
    • 👋Get familiar with our Data module
    • 🥂Connect
    • 🪹Create new datasource
      • Connecting to Oracle database
      • Connecting to MySQL database
      • Connecting to MS SQL database
      • Connecting to Postgres SQL database
      • Connecting to Teradata
      • Connecting to Redshift
      • Connecting to Hive
      • Connecting to Azure Blob Storage
      • Connecting to Spark SQL
      • Connecting to generic JDBC
      • Connecting to Salesforce
      • Connecting to Google cloud SQL
        • Connecting to a PostgreSQL cloud SQL instance
        • Connecting to an MSSQL cloud SQL instance
        • Connecting to a MySQL Cloud SQL Instance
      • Connecting to Amazon S3
      • Connecting to Google BigQuery
        • Steps to connect to a Google BigQuery database
      • Connecting to Snowflake
        • OAuth support for Snowflake
        • Integrating Snowflake with Azure AD via OAuth
        • Integrating Snowflake with Okta via OAuth
        • Azure PrivateLink
        • AWS PrivateLink
        • Best practices
      • Connecting to Databricks
      • Connecting to Databricks Delta Lake
      • Connecting to an AlloyDB Cluster
      • Connecting to HDFS
      • Connecting to Looker SQL Interface
      • Loading Excel sheets
      • 🚧Understanding partitioning your data
    • ⏳Time-to-Live (TTL) and Caching
    • 🌷Refreshing a datasource
    • 🪺Managing your datasets
      • Swapping datasources
    • 🐣Preparing your datasets
      • 🤾Actions that can be done on a dataset
      • Data Pipeline
      • SQL code snippets
      • ✍️Writeback window
      • 🧩Editing Prepare → Data
      • Handling null or mismatched values
      • Metadata view
      • List of icons and their actions
        • Functions
        • SQL Transform
        • Python Transform
        • Standard Aggregation
        • Creating Hierarchies
      • Dataset Scripting
      • Fusioning your datasets
      • Scheduling refresh for datasets
    • 🐥Preparing your Business Views
      • 🌟Create a new Business View
      • Creating calculated columns
      • Creating dynamic parameters
      • Scheduling refresh for Business Views
      • Setting up custom calendars
    • Tellius Engine: Comparison of In-Memory vs. Live Mode
  • Feed
    • 📩What is a Feed in Tellius?
    • ❗Alerts on the detection of anomalies
    • 📥Viewing and deleting metrics
    • 🖲️Track a new metric
  • Assistant
    • 💁Introducing Tellius Assistant
    • 🎤Voice-based Assistant
    • 💬Interacting with Assistant
    • ↖️Selecting Business View
  • Embedding Tellius
    • What you should know before embedding
    • Embedding URL
      • 📊Embedding Vizpads
        • Apply and delete filters
        • Vizpad-related actionTypes
        • Edit, save, and share a Vizpad
        • Keep, remove, drill sections
        • Adding a Viz to a Vizpad
        • Row-level policy filters
      • 💡Embedding Insights
        • Creating and Viewing Insights
      • 🔎Embedding Search
        • Search query execution
      • Embedding Assistant
      • 🪄Embedding Kaiya
      • Embedding Feed
  • API
    • Insights APIs
    • Search APIs
    • Authentication API (Login API)
  • ✨What's New
    • Release 5.4
      • Patch 5.4.0.x
    • Release 5.3
      • Patch 5.3.1
      • Patch 5.3.2
      • Patch 5.3.3
    • Release 5.2
      • Patch 5.2.1
      • Patch 5.2.2
    • Release 5.1
      • Patch 5.1.1
      • Patch 5.1.2
      • Patch 5.1.3
    • Release 5.0
      • Patch 5.0.1
      • Patch 5.0.2
      • Patch 5.0.3
      • Patch 5.0.4
      • Patch 5.0.5
    • Release 4.3 (Fall 2023)
      • Patch 4.3.1
      • Patch 4.3.2
      • Patch 4.3.3
      • Patch 4.3.4
    • Release 4.2
      • Patch 4.2.1
      • Patch 4.2.2
      • Patch 4.2.3
      • Patch 4.2.4
      • Patch 4.2.5
      • Patch 4.2.6
      • Patch 4.2.7
    • Release 4.1
      • Patch 4.1.1
      • Patch 4.1.2
      • Patch 4.1.3
      • Patch 4.1.4
      • Patch 4.1.5
    • Release 4.0
Powered by GitBook

© 2025 Tellius

On this page
  • Indicators
  • Signatures
  • Indicators vs Signatures

Was this helpful?

Export as PDF
  1. Data
  2. Preparing your datasets
  3. List of icons and their actions

Functions

Build custom transformations into your dataset with Indicators and Signatures

PreviousList of icons and their actionsNextSQL Transform

Last updated 4 months ago

Was this helpful?

Functions refer to advanced, formula-based transformations you can apply to your datasets. They let you create custom columns or modify existing columns by writing expressions—without needing a separate tool or code editor. Under “Functions”, you’ll find two main categories: Indicators and Signatures

Typically, you’ll pick an Indicator whenever your expression is primarily numeric or aggregator-based, and a Signature when you need more robust, conditional logic (especially if you want to return non-numeric labels).

Indicators

Indicators allow you to create mathematical expressions that transform your data, letting you compute new values or combine existing columns. They are reusable, formula-based calculations you can apply to each row in your dataset. They typically involve arithmetic or aggregations—like avg(SumOfQty_Avail) or (cost - revenue) + profit. Think of them as custom fields that you define using existing columns, so you can enrich your dataset with new metrics on the fly.

Why use Indicators?

  1. By creating a derived metric (e.g., (cost - revenue) + profit), you might uncover patterns you’d miss if you only looked at raw fields.

  2. After applying your indicator, you can keep your newly enriched dataset in memory (for faster querying) or push it back to a database if you need a persistent record.

How to use Indicators

Under Data → Prepare → Data, click on the Functions (f) icon and select Indicators from the menu. The Signatures pop-up features two tabs: Existing and New.

  1. Select the required Indicator from the Select Indicator dropdown.

  2. The text field below shows the formula. It can be adjusted, if required.

  3. Alternatively, you can create a new Indicator by typing the expression in the text field, referencing fields in your dataset. Example: (cost - revenue) + profit).

  4. Provide a name for the Indicator. Based on your requirement, save or apply the expression.

    1. Save: Saves the Indicator in your library but does not immediately apply it to the dataset.

    2. Save & Apply: If you chose “Save & Apply,” the dataset’s pipeline now includes a new column or a transformed set of values derived by your indicator.

    3. Delete: Removes the Indicator entirely if you no longer need it.

If you need complex branching logic (IF-THEN-ELSE), consider whether a Signature is more suitable. Indicators excel at arithmetic or aggregator-based expressions.

Signatures

Signatures are formula-like definitions based on columns in your dataset. They help you classify or calculate values for each row on the fly. You can define conditions (e.g., "if" statements), arithmetic, or more advanced logic. Then you can save and apply these expressions, either storing your new dataset in memory or in a database.

For example:

sqlCopy codeif age < 20 then "youth"
elseif (age < 25) then "teenage"
else "adult"

This expression categorizes each row’s “age” column into youth, teenage, or adult.

Why use Signatures?

  • You can apply conditional statements (IF, ELSEIF) or arithmetic (like (revenue - cost) / cost * 100).

  • Once created, the same signature can be applied to multiple analyses or dashboards.

  • No need to switch tools—perform these custom calculations inline directly in Tellius.

How to create Signatures?

Under Data → Prepare → Data, click on the Functions (f) icon and select Signatures from the menu. The Signatures pop-up features two tabs: Existing and New.

  1. Select the required Signature from the Select Signature dropdown.

  2. The expression will be loaded into the text field below.

  3. Alternatively, you can create a new Signature by typing the expression in the text field, referencing fields in your dataset. Example: if SCHEDULED_DEPARTURE < 100 then 0 elseif SCHEDULED_DEPARTURE < 200 then 1 else 2.

  4. Provide a name for the Signature. Based on your requirement, save or apply the expression.

    1. Save: Saves the signature in your library but does not immediately apply it to the dataset.

    2. Save & Apply: Saves changes and applies the logic to your dataset, so you see the transformed column right away.

    3. Delete: Removes the signature entirely if you no longer need it.

If you only want to update a small part of the logic, open an existing signature, edit the text, then “Save & Apply” to see immediate changes.

  1. A new signature-based column appears in your data pipeline, letting you slice, filter, or visualize that new field in subsequent steps.

After finishing your changes, Tellius may prompt whether you want the final dataset in memory or a database.

  • Memory: Faster to query; suitable for agile exploration or smaller datasets.

  • Database: If your organization needs the new columns/logic available to a broader audience or wants to keep it in a persistent store.

You typically choose this storage option after you finish transformations, either in the pipeline settings or during final “Publish” steps.

Indicators vs Signatures

When to use Indicators

  • If you want to produce a straightforward numeric calculation (averages, sums, differences, ratios).

  • If you need quick aggregator-based expressions (like avg or sum) over columns.

  • If you’re mostly dealing with numeric fields and want derived measures or KPIs.

  • Typical output is a numeric field that can be charted, pivoted, or used in further transformations.

When to use Signatures

  • If you want to classify or label rows, or apply multi-branch logic (conditional or categorical expressions).

  • If your expression is a chain of complex conditions or text-based logic, especially where the result might be a string label.

  • If you’re segmenting data or assigning categories based on certain thresholds or conditions (row-by-row logical checks).

  • Typical output is a string or label for each row (e.g., “youth,” “adult,” “profit,” “loss”). But it can also produce numeric values if your if/else conditions return numbers.

🔢
🐣
Indicators
Signatures