Preview data - Revision history

Carl.ridderstolpe: Rewrote the signal preview page to be more structured and reflect the layout in 2.84

2023-07-03T09:29:32Z

Rewrote the signal preview page to be more structured and reflect the layout in 2.84

Show changes

Carl.ridderstolpe: continued rewriting this page to reflect 2.84

2023-06-30T12:58:39Z

continued rewriting this page to reflect 2.84

Show changes

Carl.ridderstolpe: started rewriting this page

2023-06-30T09:33:19Z

started rewriting this page

@@ Line 1: / Line 1: @@
-[[File:Video-in-preview.png|thumb|400x400px| Preview Data Window - Video]]
+THIS PAGE IS IN THE MIDDLE OF EDITING. TOO SEE THE OLD VERSION SCROLL DOWN TO "How to use", TOO SEE A GUIDE TO THE NEW FEATURES WAIT A COUPLE OF HOURS.
 This is a tool used to graph signal values from MDF-files, preview Video and visualize GPS-data.
@@ Line 29: / Line 110: @@
 == Integrated GPS data visualization ==
 By default the map will be set to display a plot, along side of a map. Once a signal is selected and pushed up into the mater signal preview any available GPS data will be visualized in the map, see Figure "Preview Data Window - GPS". If you click on the plot line a marker will be placed in the map which indicates where the car was at that point in time.

Alkitjohan: /* Integrated video and audio preview */

2022-12-21T10:12:21Z

Integrated video and audio preview

← Older revision		Revision as of 10:12, 21 December 2022
Line 23:		Line 23:

	If both audio and video measurements exists (like in the example) one can choose to only play the video measurement by clicking the video measurement bar in the graph. This also applies to when there are multiple overlapping videos.		If both audio and video measurements exists (like in the example) one can choose to only play the video measurement by clicking the video measurement bar in the graph. This also applies to when there are multiple overlapping videos.

			If there are multiple overlapping videos, on of the videos can be viewed in "picture in picture-mode". To enable this, click the three dots in the bottom right corner of the video and select "Picture in picture" in the sub menu appearing.

			This can of course also be used for a single video as well.

	== Integrated GPS data visualization ==		== Integrated GPS data visualization ==

Alkitjohan: /* Integrated video and audio preview */

2022-12-21T09:52:30Z

Integrated video and audio preview

← Older revision		Revision as of 09:52, 21 December 2022
Line 8:		Line 8:
	# In order to inspect a signal more closely, double click or "drag and drop" the signal into the Master signal preview.		# In order to inspect a signal more closely, double click or "drag and drop" the signal into the Master signal preview.
	# If there is any GPS data available, then that data will be visualized in the map.		# If there is any GPS data available, then that data will be visualized in the map.
	# If there is any video data available, then ~~one or more blue fields labelled "video" will be~~ visible in the plot ~~window. To access the video, click on the blue field~~. '''~~From version 2.57, this has changed.~~ See [[Preview data#Integrated video and audio preview\|Preview data#Integrated video and audio]]'''		# If there is any video or audio data available, then a media controller is visible below the main plot. '''See [[Preview data#Integrated video and audio preview\|Preview data#Integrated video and audio]]'''

	== Integrated video and audio preview ==		== Integrated video and audio preview ==
	To see what videos are available a signal needs to be selected and inserted into the master signal preview.		To see what videos are available a signal needs to be selected and inserted into the master signal preview.

	The preview tool will automatically detect if there is any video correlated to the currently selected file. If such video exists, ~~then~~ a blue field will show up in the plot that is labelled "Video". Such a field is visible in the Figure called "The Preview Data Window -Video", which has integrated video support.. If you want to preview that video, simply click on the blue field. The video view will open, and the video will start playing. You can also click on the plot line inside of the video field to jump to an exact timestamp in the video. This means that if you wish to see what happened in the video when a certain signal peak occurred then you can click on that peak and the video will instantly jump to the correct timestamp.		The preview tool will automatically detect if there is any video correlated to the currently selected file. If such video exists, a media controller chart will be visible below the main play. See screenshot "Preview Data Window - Video and Audio".

	~~'''The following affects portal version 2.57 and above:'''~~

	~~From version 2.57 the video field has been moved to a new chart (the~~ media controller chart) below the main ~~plot~~. ~~This charts show all video and audio measurements for the current selected measurement. If no such measurements exists for the selected measurement, the media controller chart is not visible.~~
	~~[[File:Preview video audio.png\|thumb\|Preview Data Window - Video and Audio]]~~
	~~An example of a measurement with both audio and video measurements can be seen in~~ Preview Data Window - Video and Audio.

	=== Control playback of audio and video measurements ===		=== Control playback of audio and video measurements ===
Line 28:		Line 22:
	To stop and revert the playback to the start position, click the stop button. The left and right buttons to the right of the stop buttons are used to jump to the nearest media measurement on the timeline.		To stop and revert the playback to the start position, click the stop button. The left and right buttons to the right of the stop buttons are used to jump to the nearest media measurement on the timeline.

	~~The playback of the video and/or audio file can also be individually controlled via the integrated controllers in the respective windows.~~		If both audio and video measurements exists (like in the example) one can choose to only play the video measurement by clicking the video measurement bar in the graph. This also applies to when there are multiple overlapping videos.

	If both audio and video measurements exists (like in the example) one can choose to only play the video measurement by clicking the video measurement bar in the graph.

	== Integrated GPS data visualization ==		== Integrated GPS data visualization ==

Alkitjohan at 14:01, 28 February 2020

2020-02-28T14:01:45Z

← Older revision		Revision as of 14:01, 28 February 2020
Line 8:		Line 8:
	# In order to inspect a signal more closely, double click or "drag and drop" the signal into the Master signal preview.		# In order to inspect a signal more closely, double click or "drag and drop" the signal into the Master signal preview.
	# If there is any GPS data available, then that data will be visualized in the map.		# If there is any GPS data available, then that data will be visualized in the map.
	# If there is any video data available, then one or more blue fields labelled "video" will be visible in the plot window. To access the video, click on the blue field. '''From version 2.57, this has changed. See [[Preview data#Integrated video and audio]]'''		# If there is any video data available, then one or more blue fields labelled "video" will be visible in the plot window. To access the video, click on the blue field. '''From version 2.57, this has changed. See [[Preview data#Integrated video and audio preview\|Preview data#Integrated video and audio]]'''

	== Integrated video and audio preview ==		== Integrated video and audio preview ==

Alkitjohan: /* Controll playback of audio and video measurements */

2020-02-28T14:01:26Z

Controll playback of audio and video measurements

← Older revision		Revision as of 14:01, 28 February 2020
Line 8:		Line 8:
	# In order to inspect a signal more closely, double click or "drag and drop" the signal into the Master signal preview.		# In order to inspect a signal more closely, double click or "drag and drop" the signal into the Master signal preview.
	# If there is any GPS data available, then that data will be visualized in the map.		# If there is any GPS data available, then that data will be visualized in the map.
	# If there is any video data available, then one or more blue fields labelled "video" will be visible in the plot window. To access the video, click on the blue field.		# If there is any video data available, then one or more blue fields labelled "video" will be visible in the plot window. To access the video, click on the blue field. '''From version 2.57, this has changed. See [[Preview data#Integrated video and audio]]'''

	== Integrated video and audio preview ==		== Integrated video and audio preview ==
Line 21:		Line 21:
	An example of a measurement with both audio and video measurements can be seen in Preview Data Window - Video and Audio.		An example of a measurement with both audio and video measurements can be seen in Preview Data Window - Video and Audio.

	=== ~~Controll~~ playback of audio and video measurements ===		=== Control playback of audio and video measurements ===
	There are several ways of controlling the playback for the found media measurements. By default the playback starts from time = 0 when the user clicks the play icon in toolstrip below the media chart. If there is any media file at the current position (as in the example) the playback of the measurements is automatically started. One can also choose to start from a certain position by either clicking between the audio and video bars in the chart or by ctrl+left mouse click on the plot in the main chart.		There are several ways of controlling the playback for the found media measurements. By default the playback starts from time = 0 when the user clicks the play icon in toolstrip below the media chart. If there is any media file at the current position (as in the example) the playback of the measurements is automatically started. One can also choose to start from a certain position by either clicking between the audio and video bars in the chart or by ctrl+left mouse click on the plot in the main chart.

Alkitjohan: /* Integrated video preview */

2020-02-28T13:59:07Z

Integrated video preview

← Older revision		Revision as of 13:59, 28 February 2020
Line 10:		Line 10:
	# If there is any video data available, then one or more blue fields labelled "video" will be visible in the plot window. To access the video, click on the blue field.		# If there is any video data available, then one or more blue fields labelled "video" will be visible in the plot window. To access the video, click on the blue field.

	== Integrated video preview ==		== Integrated video and audio preview ==
	To see what videos are available a signal needs to be selected and inserted into the master signal preview.		To see what videos are available a signal needs to be selected and inserted into the master signal preview.

	The preview tool will automatically detect if there is any video correlated to the currently selected file. If such video exists, then a blue field will show up in the plot that is labelled "Video". Such a field is visible in the Figure called "The Preview Data Window -Video", which has integrated video support.. If you want to preview that video, simply click on the blue field. The video view will open, and the video will start playing. You can also click on the plot line inside of the video field to jump to an exact timestamp in the video. This means that if you wish to see what happened in the video when a certain signal peak occurred then you can click on that peak and the video will instantly jump to the correct timestamp.		The preview tool will automatically detect if there is any video correlated to the currently selected file. If such video exists, then a blue field will show up in the plot that is labelled "Video". Such a field is visible in the Figure called "The Preview Data Window -Video", which has integrated video support.. If you want to preview that video, simply click on the blue field. The video view will open, and the video will start playing. You can also click on the plot line inside of the video field to jump to an exact timestamp in the video. This means that if you wish to see what happened in the video when a certain signal peak occurred then you can click on that peak and the video will instantly jump to the correct timestamp.

			'''The following affects portal version 2.57 and above:'''

			From version 2.57 the video field has been moved to a new chart (the media controller chart) below the main plot. This charts show all video and audio measurements for the current selected measurement. If no such measurements exists for the selected measurement, the media controller chart is not visible.
			[[File:Preview video audio.png\|thumb\|Preview Data Window - Video and Audio]]
			An example of a measurement with both audio and video measurements can be seen in Preview Data Window - Video and Audio.

			=== Controll playback of audio and video measurements ===
			There are several ways of controlling the playback for the found media measurements. By default the playback starts from time = 0 when the user clicks the play icon in toolstrip below the media chart. If there is any media file at the current position (as in the example) the playback of the measurements is automatically started. One can also choose to start from a certain position by either clicking between the audio and video bars in the chart or by ctrl+left mouse click on the plot in the main chart.

			When the playback is started, the red marker is moving in the two grids and the play button is replaced by the pause button. Simply click the pause button to pause the playback.

			To stop and revert the playback to the start position, click the stop button. The left and right buttons to the right of the stop buttons are used to jump to the nearest media measurement on the timeline.

			The playback of the video and/or audio file can also be individually controlled via the integrated controllers in the respective windows.

			If both audio and video measurements exists (like in the example) one can choose to only play the video measurement by clicking the video measurement bar in the graph.

	== Integrated GPS data visualization ==		== Integrated GPS data visualization ==

Erika at 16:55, 4 November 2019

2019-11-04T16:55:45Z

← Older revision		Revision as of 16:55, 4 November 2019
Line 1:		Line 1:
	[[File:Video-in-preview.png\|thumb\|400x400px\|~~Figure 1:~~		[[File:Video-in-preview.png\|thumb\|400x400px\| Preview Data Window - Video]]
	~~The preview data window with integrated video support.~~
	]]
	This is a tool used to graph signal values from MDF-files, preview Video and visualize GPS-data.		This is a tool used to graph signal values from MDF-files, preview Video and visualize GPS-data.

Line 15:		Line 13:
	To see what videos are available a signal needs to be selected and inserted into the master signal preview.		To see what videos are available a signal needs to be selected and inserted into the master signal preview.

	The preview tool will automatically detect if there is any video correlated to the currently selected file. If such video exists, then a blue field will show up in the plot that is labelled "Video". Such a field is visible in Figure 1. If you want to preview that video, simply click on the blue field. The video view will open, and the video will start playing. You can also click on the plot line inside of the video field to jump to an exact timestamp in the video. This means that if you wish to see what happened in the video when a certain signal peak occurred then you can click on that peak and the video will instantly jump to the correct timestamp.		The preview tool will automatically detect if there is any video correlated to the currently selected file. If such video exists, then a blue field will show up in the plot that is labelled "Video". Such a field is visible in the Figure called "The Preview Data Window -Video", which has integrated video support.. If you want to preview that video, simply click on the blue field. The video view will open, and the video will start playing. You can also click on the plot line inside of the video field to jump to an exact timestamp in the video. This means that if you wish to see what happened in the video when a certain signal peak occurred then you can click on that peak and the video will instantly jump to the correct timestamp.

	== Integrated GPS data visualization ==		== Integrated GPS data visualization ==
	[[File:Map-in-preview.png\|thumb\|~~Figure 2:~~		[[File:Map-in-preview.png\|thumb\|Preview Data Window - GPS
	~~The preview data window with integrated~~ GPS ~~data visualization~~
	]]		]]
	By default the map will be set to display a plot, along side of a map. Once a signal is selected and pushed up into the mater signal preview any available GPS data will be visualized in the map. If you click on the plot line a marker will be placed in the map which indicates where the car was at that point in time.		By default the map will be set to display a plot, along side of a map. Once a signal is selected and pushed up into the mater signal preview any available GPS data will be visualized in the map, see Figure "Preview Data Window - GPS". If you click on the plot line a marker will be placed in the map which indicates where the car was at that point in time.

	== Y-axis scaling ==		== Y-axis scaling ==

Julian: Fixed dated information about signal preview

2019-10-09T12:02:15Z

Fixed dated information about signal preview

← Older revision		Revision as of 12:02, 9 October 2019
Line 1:		Line 1:
	[[File:~~Preview data~~.png\|thumb\|400x400px\|The preview data window.~~\|link=https://wiki.alkit.se/index.php/File:Preview_data.png~~]]This is a tool used to graph signal values from MDF-files.		[[File:Video-in-preview.png\|thumb\|400x400px\|Figure 1:
			The preview data window with integrated video support.
			]]
			This is a tool used to graph signal values from MDF-files, preview Video and visualize GPS-data.

	== ~~Example of usage~~ ==		== How to use ==
	~~One of the main functions is to view signals as graphs and see their route. To do so you first need to select one of the files~~ from the ~~Source List~~ on the left~~. You then select~~ the signals ~~you wish to preview from~~ the list to the right. ~~The signals which you can see are specific to the file you have~~ selected~~. You can change file from the source list at any time, your previous~~ signal ~~selection~~ will ~~remain on screen. The selected signals can then be seen~~ at the bottom of the ~~page under~~ the ~~tab~~ "~~Signal preview~~". ~~By double clicking~~ the ~~thumbnail of~~ the signal ~~at the bottom of the page you will push it up~~ into the master signal preview, ~~where you have enhanced control of how~~ you want to preview ~~your signals~~. You can ~~have up~~ to ~~four signals~~ in ~~any of~~ the ~~master~~ signal preview ~~graphs at once~~. ~~You can also drag and drop~~ the ~~thumbnails~~ to the ~~master~~ signal preview.		# Select a "Source" (file or measurement) from the source list on the left hand side of the screen
			# A list of signals will show up in the signal list on the right hand side of the screen. Select one or more.
			# Each selected signal will show up as a thumbnail at the bottom of the screen
			# In order to inspect a signal more closely, double click or "drag and drop" the signal into the Master signal preview.
			# If there is any GPS data available, then that data will be visualized in the map.
			# If there is any video data available, then one or more blue fields labelled "video" will be visible in the plot window. To access the video, click on the blue field.

			== Integrated video preview ==
			To see what videos are available a signal needs to be selected and inserted into the master signal preview.

			The preview tool will automatically detect if there is any video correlated to the currently selected file. If such video exists, then a blue field will show up in the plot that is labelled "Video". Such a field is visible in Figure 1. If you want to preview that video, simply click on the blue field. The video view will open, and the video will start playing. You can also click on the plot line inside of the video field to jump to an exact timestamp in the video. This means that if you wish to see what happened in the video when a certain signal peak occurred then you can click on that peak and the video will instantly jump to the correct timestamp.

			== Integrated GPS data visualization ==
			[[File:Map-in-preview.png\|thumb\|Figure 2:
			The preview data window with integrated GPS data visualization
			]]
			By default the map will be set to display a plot, along side of a map. Once a signal is selected and pushed up into the mater signal preview any available GPS data will be visualized in the map. If you click on the plot line a marker will be placed in the map which indicates where the car was at that point in time.

	== Y-axis scaling ==		== Y-axis scaling ==
Line 12:		Line 31:
	If any of these conditions are true, then the vertical min/max will be automatically fitted to the curve based on the curves extreme values.		If any of these conditions are true, then the vertical min/max will be automatically fitted to the curve based on the curves extreme values.

	== ~~Features~~ ==		== Plot toolbar ==

	=== Preview modes ===		=== Preview modes ===
	[[File:Preview ~~view modes~~.png\|frameless]]		[[File:Preview-views.png\|frameless]]

	"Master signal preview" has ~~three~~ different preview modes which you can select from the bottom left corner of the "Master signal preview" window~~. The default view is "Map split", which has~~ one ~~graph on the left~~, and a ~~map on the right where the cars route will be shown (if~~ GPS data is ~~available~~). The second mode is the split mode, which splits the window into two graphs. This could be useful for comparing different signals. Finally, there is the "single" mode which allows you to utilize as much space as you can for one single graph.		"Master signal preview" has four different preview modes which you can select from the bottom left corner of the "Master signal preview" window:
			# View only one plot
			# View two plots side by side
			# View a plot, and video side by side
			# View a plot and GPS data visualization side by side (this is the default view)

	=== Window size ===		=== Window size ===
Line 28:		Line 51:
	To zoom in on graphs you drag between two points(not necessarily data points) on the graf and it will zoom in between those two points.To zoom out you press "Reset zoom" for L or R depending on which plot you want to zoom out. Notice that "Zoom out (R)" is only clickable when you show two plots and that is because even if there always are two plots you can only zoom out and clear shown plots.		To zoom in on graphs you drag between two points(not necessarily data points) on the graf and it will zoom in between those two points.To zoom out you press "Reset zoom" for L or R depending on which plot you want to zoom out. Notice that "Zoom out (R)" is only clickable when you show two plots and that is because even if there always are two plots you can only zoom out and clear shown plots.

	=== ~~Map~~ ===		=== Statistics ===
	~~When clicking on~~ a ~~point in~~ the ~~graph you will see where~~ the ~~car was~~ for ~~that given time value on the map~~. Note that ~~this~~ only ~~works~~ if ~~such GPS data~~ is ~~available~~.		You can see statistics for the plots and their signal(s) at the bottom under the tab "Statistics". To the left you have a button for if you want to show the left or right plot. What being showed is the plots signal and x/y min/max, mean value, standard devation, total amount of data samples and shown amount of data samples for each signal. Note that the plot can only show 500 samples for each signal and therefore need to hide samples for bigger signals. The plot will always try to have an as even as possible space between the samples and if it is showing a signal with 502 signals it will show 251 as it will give the smoothest and most accurate view even if its not showing as many samples as it could.

	=== ~~'''Statistical data'''~~ ===		== Other features ==
	You can see statistics for the plots and their signal(s) at the bottom under the tab "Statistics". To the left you have a button for if you want to show the left or right plot. What being showed is the plots signal and x/y min/max, mean value, standard devation, total amount of data samples and shown amount of data samples for each signal. Note that the plot can only show 500 samples for each signal and therefore need to hide samples for bigger signals. The plot will always try to have an as even as possible space between the samples and if it is showing a signal with 502 signals it will show 251 as it will give the smoothest and most accurate view even if its not showing as many samples as it could.

	=== Export options ===		=== Export options ===