Products / Player / Learn

DPSIM Player · Reference

Player reference manual

A detailed reference for workspaces, controls, data behavior and common problems. Use the tutorials for a checked step-by-step exercise.

Recorded data and presentation

Player opens a .dpsplay recording and replays its saved states. It does not execute equipment models or scripts, interpolate unrecorded process states or edit numerical simulation results. Layout, chart configuration, the selected analysis interval and chart library are presentation data saved with the local recording.

Interface reference by task

Player recording tools and process-route layout tools
The recording toolbar concerns files and analysis; the route toolbar concerns presentation and selection.
TaskControl / panelRead alongside it
Choose the resultOpen local or Online → Open onlineRun details and the study identity.
Find the itemRoute selection, equipment/stream selector, Find variableOwner, port, unit and SIM/EXP provenance.
Inspect an instantPlayback controls and Recorded timeState index and original recording interval.
Choose data for analysisAnalysis range start/end or blue handlesInclusive endpoints and displayed time unit.
Navigate the timelineShow all, Fit selection, Playhead, zoom and panVisible window; separate from data selection.
Compare variablesRecorded trend → Add seriesUnits and left/right axes.
Calculate distribution statisticsAnalysis → Generate histogramIncluded/missing/out-of-range counts.
Keep a reviewAdd to library, Chart library / Chart studio, Save localCurrent local filename and save success message.

Open and save commands

CommandBehavior
Open local / Ctrl+OOpen a local recording.
Online → Open onlineRetrieve an available online result, validate and save it locally, then open it.
Save local / Ctrl+SWrite layout, selected interval and chart library into the current local recording.
Save local as / Ctrl+Shift+SMake a complete local recording copy with the current presentation.
Load layoutImport a separate .dpslayout presentation file; it is not a process recording.
Chart libraryKeep and revisit configured plots; save the recording to retain changes.

Save online is not exposed in the current desktop workflow. Online result storage is temporary delivery. Keep a local recording for later review and distribution. If a save fails, pending changes remain open so you can correct the problem.

Playback, time and intervals

Control / markerMeaning
Play / pause, previous / next, speed, LoopNavigate recorded states; speed changes playback, not simulation settings.
Recorded timeTime of the state actually loaded into the inspector. Seeking chooses the state at or before the requested time.
Green / grey timeline markersRecorded states / calculation cycles without saved values. Dense markers may be reduced at wide zoom.
Analysis range and blue handlesInterval used by recorded trends, histograms and CSV analysis.
Show all / Fit selection / PlayheadNavigate the visible timeline window. This is separate from choosing a state or analysis interval.
Time unitChange the displayed time unit, not the recording cadence.

Timeline wheel zooms; Shift+drag or middle-button drag pans. A time interval does not imply data exists at every instant in it. Changes between recorded cycles may be missed.

Route and inspector

Fit, zoom and Layout organize the view. Show analysis panel and Reset panel sizes restore a useful split. Select equipment or a stream to inspect its available recorded variables; search and the item selector help locate data.

SIM identifies simulation output; EXP identifies experimental/input data where supplied. A file can contain no EXP data. Size distribution and component views use the current recorded state. Aperture display can switch between µm and mm. Values remain read-only. Events and warnings and Run details provide recorded context, where present.

Trends and chart library

Double-click a variable, drag it to the recorded trend or use Add series. Series controls let you edit, hide, remove and choose the left or right Y axis. Keep labels and units explicit, especially when mixing quantities or SIM and EXP. The playhead cursor relates the time-series chart to the selected process state.

Chart configuration changes appearance. Add to library stores a configured plot in the current workspace; Chart library retrieves it. Save local retains the library in the recording. Export chart image produces a report figure. The chart may reduce points for display; this does not create or delete recorded samples.

Histograms, statistics and CSV

Analysis / Histogram–CSV provides a series selector, optional EXP inclusion and an inclusive From/To interval. Histogram settings include bin count, automatic or specified value range, Count/Percent/Density and cumulative distribution. Generate histogram reads the recorded data in that interval.

The summary reports included, missing/non-numeric and out-of-range sample counts, the included-sample mean and sample standard deviation. Frequencies count samples, not elapsed duration. Review exclusions before interpreting a statistic; it is not automatically a time-weighted process average.

Export series CSV uses all recorded rows in the selected time range, including missing values, rather than only chart display points. Select the separator and decimal-comma convention before export. A CSV or chart image does not retain the complete recording or editable project.

Optional script source

Scripts is enabled only when source was included by Developer before execution. The source viewer is read-only and permits reading and copying. It includes script metadata and can include disabled scripts. Player does not execute the code.

Omitted source cannot be recovered by Player. To provide a recording without source, generate it with source inclusion disabled in Developer; the documented Player workflow does not offer removal of included source. This choice does not conceal the recording’s remaining process data.

Local sharing and unsaved work

Use Save local as to keep a reviewed copy, reopen it to check the presentation, then send that file through an appropriate transfer method. Recipients need Player and access to the file. Include the study identity, relevant interval and Player version used. A managed or revocable sharing link is not part of this desktop save workflow.

On open/close with pending presentation changes, Save local retains them, Discard abandons them and Cancel returns to the workspace. This is an unsaved-work guard, not file encryption or access control. Keep your original recording when you need a baseline.

Troubleshooting

SymptomCheck
Recording fails to openFile format, complete transfer and compatible Player version; retain the original.
Inspector is missingLayout → Show analysis panel, then Reset panel sizes.
No EXP comparisonWhether the producing recording includes EXP data; SIM is shown by default.
No script sourceWhether Developer included source before sending; Player cannot reconstruct it.
Event absent at high zoomRecording interval, recorded markers and actual recorded time. Zoom does not create samples.
Wrong histogram or CSV periodInclusive From/To and analysis range, not just the visible chart window.
Saved chart is missing after reopenAdd it to Chart library and successfully Save local in the intended copy.
Online recording no longer availableUse your archived local copy; temporary server delivery is not permanent storage.

Chart editor and Chart studio are different stages

Series properties in Edit displayed chart
Select the curve before editing its legend or axis assignment.
StageMain controlsPersistence
Displayed chart previewChart, Series, Axes and Legend; Apply to chart / CancelApply changes the displayed plot. It does not automatically create a library entry.
Add to libraryChart context menu or chart optionsCreates an entry in the current workspace.
Chart studioSaved charts list; Chart settings, Series, Time range; Apply chart settingsEdits retained chart definitions in the open workspace.
Save in recording / Save localWrites the workspace into the current local .dpsplayRequired to retain changes after reopening.
Export imageExports a plotted figureDoes not save the complete recording or library.

Library name is the saved-entry label; Chart title is the displayed title. Axis labels, limits, legend position and notes help make a saved review interpretable. A changed label is not a unit conversion.

Analysis fields and statistical population

Analysis time interval, bins, automatic limits and frequency-scale controls
The inclusive interval applies to histogram and CSV; the automatic range or chosen value limits additionally define the histogram population.
FieldBehavior / interpretation
Scope and SearchFilter selected item, equipment, streams, tags or all recorded series. Check retained selection.
Include EXPAvailable only when the recording contains the relevant input/experimental data.
From / To (inclusive)Both endpoints are included when recorded samples exist there.
Number of binsControls histogram grouping, not the recorded data cadence.
Automatic / manual value rangeManual limits can exclude finite numeric values; inspect below/above counts.
Count / Frequency (%) / Probability densityDifferent normalization of the same included samples. Frequencies are sample based, not elapsed-time weighting.
Cumulative distributionAccumulates counts or normalized frequency across bins.
Mean / sample standard deviationDescribe the included histogram samples. Missing values and range exclusions affect the population.
CSV separator / Decimal commaControl exported text conventions; match them on import.
Cancel operationStops a running analysis/export operation where enabled; it is not a simulation cancel command.

Histogram and CSV may use different populations when manual histogram value limits exclude samples: CSV keeps all recorded rows in the chosen time range, including missing values. The chart display may reduce dense points, while analysis/export scans the recorded series.

A checked five-sample reference

The existing practice recording used for these new captures lasts 120 s and saves every 10 s. An inclusive 40–80 s interval produces five samples. Its feeder dry-solids series gives a mean of 9,916.9497074 t/h and sample standard deviation of 241.1289276 t/h, with no missing or out-of-range samples in automatic range. The native CSV export was checked independently and reproduced these statistics.

This reference checks the procedure. It is not a promised output of a fresh random run or evidence that the illustrative model is calibrated. Follow the full analysis exercise for the five rows and delimiter/decimal examples.