How to Use a Weight Created Outside of Displayr

Sometimes you may wish to use a weight for analysis that was not created by Displayr's built-in weighting tool. It's only a matter of checking a box for Displayr to allow a variable to be used as a weight on outputs and analysis. However, there are requirements as to how this variable is structured.

To save time, you can have Displayr automatically tag variables as Usable as a weight. Run the Data Preparation Agent and make sure you have the option to identify and flag weight variable sets turned on.

Requirements

A variable in a data set with a value to use as the weight for each case with a Structure of Numeric.
The weight variable should be in the same data set used for the analysis (you may need to paste in the values as a new variable in the code editor or merge the weighted values into your data set to do this). However, you can also use a variable in a different data set as long as there is a relationship linking the data sets together.

Method

1. Select the weight variable in the Data Sources tree.

2. From the object inspector, tick Usable as a weight under Data > Properties.

Ticking this box makes the variable available as a weight to be applied to an output.

Apply the weight

A weight variable can be applied to outputs that use raw data/variables as their input (such as built-in drag and drop tables, regressions, custom calculations, etc). To apply a weight:

Select the item(s) (e.g., tables, page, etc) to be weighted. Note that when selecting items in the Report tree, the weight will be applied to all applicable items within the Page(s)/Folder(s) selected.
In the object inspector, go to Data > Filters & Weight > Weight and select the weight variable.