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.
Ritems include R-based calculations, tables, variables, and visualizations. This will also apply to modeling outputs, such as conjoint (choice-based) analysis and MaxDiff.
Keep in mind that long-running Ritems 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 execution 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 execution times for types of Ritems
Items with editable maximum execution times
The following Ritems have the option to adjust the maximum execution time. Find the default execution time and the editable maximum execution time below. The minimum execution time setting that can be applied to an Ritem is 1 minute.
-
Custom R Variables
- Default execution time is 2 minutes
- Maximum execution time is 2880 minutes (48 hours)
-
Custom Calculations
- Default execution time is 10 minutes
- Maximum execution time is 2880 minutes (48 hours)
- R-based tables (most tables created via the Tables
menu in the toolbar)
- Default execution time is 10 minutes
- Maximum execution 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 execution time is 10 minutes
- Maximum execution time is 2880 minutes (48 hours)
- R-based advanced analysis outputs (e.g., MaxDiff, choice-based conjoint analysis)
- Default execution time is 2880 minutes (48 hours)
- Maximum execution time is 2880 minutes (48 hours)
-
Stacking or Combining Data Sets
- Default execution time is 2880 minutes (48 hours)
- Maximum execution time is 2880 minutes (48 hours)
Items whose maximum execution times cannot be edited
The following items have a built-in default maximum execution time, which cannot be edited by users:
- Data Sets have a maximum execution time of 1 day
- Calculation Grid Cells have a maximum execution time of 10 minutes per cell
- Sub calculations (e.g., R code in dropbox selectors in the object inspector where Enter a calculation or value appears) have a maximum execution 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 execution time for calculations.
If you have a trial license in Displayr, the maximum execution time is 10 minutes, regardless of calculation type. If you would like to set the maximum execution 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 execution time is 10 minutes, similar to trial users. If you attempt to adjust the maximum execution 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 execution 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 execution 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 execution time and perform a calculation that runs up to 48 hours.
Method
Custom R variables
- Select the variable in the Data Sources tree.
- From the object inspector, go to Data > R Code - Data > Maximum calculation time (minutes).
- 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 the object inspector, go to Data > Show advanced options > R Code > Maximum calculation time (minutes).
- 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 the object inspector, go to Data > R Code > Maximum calculation time (minutes).
- 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 execution 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 execution time, an error will appear letting you know that it took longer than the maximum possible execution time, and it's been canceled.
If a calculation cannot be executed within its maximum execution time, we recommend splitting up the calculation into multiple calculations.