Parameters let a user manually input values to dynamically change data in an analysis. Parameters can be used in any card that takes the parameter’s output type as input.
Each parameter has a specific type (for example: numeric, string, date/time, a single object, or a numeric range). The input to a parameter card is usually a user-entered value. In the case of the property value select parameter, the user can pick a value from a dropdown based on values of a chosen object set property.
Parameter cards can be added to an analysis from the parameter panel, by searching for cards with the search bar (via the Search cards button in the top menu), or they can be created inline from many editors.
All parameter cards existing in an analysis are referenced in the parameters panel on the left. From there, you can change parameter values to see how downstream cards in the analysis look with different values. You can also identify which cards are using each parameter.
Learn more about how to parameterize an analysis on the Palantir Developers YouTube channel. ↗
The parameters panel can be found in the left sidebar, under the variable icon (), and is a unified location for managing parameters in your analysis.
The panel allows you to:
Below is the full list of parameters available in Quiver:
You can add a parameter card by one of several ways:
See below for step-by-step instructions for each of the ways listed above.
To add a parameter from the parameters panel:
To add a parameter card by searching for it:
When configuring a card input that you wish to parameterize, you can add a parameter directly from the card editor. For example, the image below shows how you can configure the substring card to take a string parameter as the input string.
To add a parameter from a card configuration editor:
In the analysis below, we have created a bar plot and two numerical aggregations that both read from the Filter Transactions object set. Let’s run through how to control the filtering of objects in the object set using parameters and watch the bar plot and numeric aggregations update accordingly.
To begin, we can add a property filter for Retailer Name. Next, create a new property value select parameter to control this value. You can create the parameter by selecting the Use variable input button next to the filter input box and then Create new parameter. This will both add the new parameter card to your analysis and set it to control the filter.
Only parameters that are the same type as the property being configured can be selected from the parameter dropdown. For example, the parameter added above of type string
does not show up when trying to filter a property of type number
.
You can see what type a property is in the Add filter menu on the right side, as well as after selecting a property when configuring its variable input.