UPCOMING WEBINAR: Build it once. Use it again: Create reusable charts with AI Users have the ability to adjust the time an RItem is allowed to run, preventing those items from timing out. This will help you not lose time waiting for a Ritem to finish running, only to time out or wait an unexpectedly long amount of time. It also reduces the R-server load, freeing up space for other calculations to run.
R items include R-based calculations, tables, variables, and visualizations. This will also apply to modeling outputs, such as conjoint (choice-based) analysis and MaxDiff, which are computationally heavy and may need to run for an hour or more.
Keep in mind that long-running R items that take many hours to run require the window where the calculation is running to be left open. That means Displayr will cancel the calculations when a user closes their browser tab or window.
- Default and maximum calculation times for types of Ritems
- Allowances for different license and document types (trial vs free vs professional)
- Method
- Calculation warnings and time-outs
Default and maximum calculation times for types of Ritems
Items with editable maximum calculation times
The following Ritems have the option to adjust the maximum calculation time. Find the default execution time and the editable maximum calculation time below. The minimum calculation time setting that can be applied to an Ritem is 1 minute.
-
Custom R Variables (including AI-generated variables)
- Default calculation time is 2 minutes
- Maximum calculation time is 2880 minutes (48 hours)
-
Custom Calculations (including Custom AI calculations)
- Default calculation time is 10 minutes
- Maximum calculation time is 2880 minutes (48 hours)
- R-based tables (most tables created via the Tables
menu in the toolbar)
- Default calculation time is 10 minutes
- Maximum calculation time is 2880 minutes (48 hours)
- R-based visualizations (most visualizations created via Visualization Selector, except for legacy visualizations ("with Tests") and some Number visualizations)
- Default calculation time is 10 minutes
- Maximum calculation time is 2880 minutes (48 hours)
- R-based advanced analysis outputs (e.g., MaxDiff, choice-based conjoint analysis)
- Default calculation time is 2880 minutes (48 hours)
- Maximum calculation time is 2880 minutes (48 hours)
-
Stacking or Combining Data Sets
- Default calculation time is 2880 minutes (48 hours)
- Maximum calculation time is 2880 minutes (48 hours)
Items whose maximum calculation times cannot be edited
The following items have a built-in default maximum calculation time, which cannot be edited by users:
- Data Sets have a maximum calculation time of 1 day
- Calculation Grid Cells have a maximum calculation time of 10 minutes per cell
- Sub calculations (e.g., R code in dropbox selectors in Properties
where Enter a calculation or value appears) have a maximum calculation time of 10 minutes
Allowances for different license and document types (trial vs free vs professional)
Depending on the type of license you have and the document you are working in, you will have a different maximum calculation time for calculations.
If you have a trial license in Displayr, the maximum calculation time is 10 minutes, regardless of calculation type. If you would like to set the maximum calculation time to greater than 10 minutes, you will need to upgrade to a paid Displayr professional license.
If you have a free license, the maximum calculation time is 10 minutes, similar to trial users. If you attempt to adjust the maximum calculation time beyond 10 minutes, you will be prompted to upgrade to a paid Displayr professional license.
If you have a professional license and you are working in a free document, you will be allowed to update the maximum calculation time beyond 10 minutes. If the calculation takes longer than 10 minutes to run, Displayr will attempt to automatically upgrade the document to a professional document. If the document is successfully upgraded to a professional document, it will reattempt the calculation with a maximum calculation time of 48 hours. If the upgrade is unsuccessful, an error will appear with a message indicating the calculation has timed out.
Professional license holders working in professional documents will be allowed to adjust the maximum calculation time and perform a calculation that runs up to 48 hours.
Method
Custom R variables
- Select the variable in the Data Sources tree.
- From Properties
- Enter a number up to 2880 or click the up/down arrow.
- Click Calculate.
Custom calculations, R-based tables, R-based visualizations, and R-based advanced analysis outputs
- Select the object(s) on a page.
- From Properties
- Enter a number up to 2880 or click the up/down arrow.
- Click Calculate.
If you would like to update all outputs on a page or outputs across multiple pages:
- Select the page(s) in the Report tree.
- From Properties
- Enter a number up to 2880 or click the up/down arrow.
- Click Calculate.
Calculation warnings and time-outs
When a calculation takes more than half the maximum allowed calculation time, a warning will appear.
This calculation took {X} to run which is more than half the allowed maximum calculation time. The maximum calculation time can be edited in Data > R Code.
If a calculation exceeds the maximum calculation time, an error will appear letting you know that it took longer than the maximum possible calculation time, and it's been canceled.
If a calculation cannot be executed within its maximum calculation time, we recommend splitting up the calculation into multiple calculations.