Charts

Using the mouse

The x and y scales can be altered by clicking on the or buttons on the respective axes.

The view of the data can be scrolled along the x axis by using the ScrollBar on the bottom of the Trace window.

The left and right arrow buttons on the scroll bar scroll all the traces by one pixel.

Clicking with the left button on either side of the scroll box, the traces are scrolled 3/4 of the visible view. Dragging the scroll box scrolls the traces accordingly.

The y scale can be offset by clicking on the y axis with the left mouse button and dragging up or down. The y axis controls only effects the traces in the same Y group as the currently active trace.

Trace Properties

The trace properties can be altered by clicking the trace with the right mouse button or using the Trace Properties command in the edit menu. A Trace Properties Dialog box allows properties such as the trace name and trace colour to be altered. Note that some colours may not be printed on non-colour printers.

Selecting Trace Data

Click on the trace to select data by using the left mouse button. Drag the mouse whilst holding the left button down. Selected data will be highlighted.

Use the Copy Tool Bar button, <CTRL><Insert> keys or <CTRL>C keys to copy the data into the clipboard. In the current version this is stored in a private format which can only be used by CapiScope.

Use the '=' Tool Bar button to calculate averages etc. the results will be appended to the last activated Results window, or if no results windows are open then a new results file will be created.

Adding a Trace to a File

Use the Paste Tool Bar button or <SHIFT><Insert>, or <CTRL>V keys to insert data from the clipboard into the currently active trace window. If the window contains a marked selection then the data will be copied to that location, otherwise it is copied to the start.

Edit Copy command

Use this command to copy selected data from the active trace onto the clipboard. This command is unavailable if there is no data currently selected.

Copying data to the clipboard replaces the contents previously stored there.

Note that when copying large 2D colour traces, there will be two copies in memory. Also if this is then pasted into another document, there could be three copies in memory. This could cause the system to become very sluggish. It is a good idea to copy a small section of a line trace into the clipboard to release at least one copy from memory.

Shortcuts: Tool Bar ; Keys: CTRLC, CTRLInsert

Edit Cut command

Use this command to remove the currently selected data from the active trace or the whole active trace if there is no data currently selected and put it on the clipboard.

The 'cut' data is set to zero in the trace if a selection was used (ie memory is still used).

The active trace is removed from the chart if no selection was made.

Cutting data to the clipboard replaces the contents previously stored there.

Shortcuts: Tool Bar .Keys: CTRLX; ShiftDelete

Edit Delete Command

Use this command to remove the currently active trace from the chart.

If part of a trace is selected, then the selection is set to zero, no memory is freed.

All unsaved data will be lost forever.

Not available in the monitor window.

Edit Paste command

Use this command to insert a copy of the clipboard contents at the insertion point or the beginning of the Chart (t=0) if there is no selection. This command is unavailable if the clipboard is empty.

Traces cannot be pasted into the Monitor window.

Shortcuts: Tool Bar: Keys: CTRLV,SHIFTInsert

Event Markers

Event Markers are small flags which can be used to mark events, artifacts, or Captured Images using CapiScope during a recording. Markers can also be added later to highlight a feature.

An Event Marker contains a label, which is shown on the flag, and a notelet, which can contain more detailed information. Event Markers are stored with the Chart, and are also Copied / Pasted to/from the clipboard together with the active trace.

Image Markers contain the filename of the captured image in the notelet.

Markers are added to a recording by pressing the space bar. This will generate a marker with a sequential number for the label, and will add the time and date to the notelet.

Alternatively, a marker can be created by pressing any key, the character from that key will be used for the label, and the time and date will be added to the notelet.

Image markers are added by pressing the F4 function key.

Markers can be added to a Chart by switching to Marker Mode and then clicking with the left mouse button to place a marker at the current cursor position.

Any marker can be edited by clicking on it with the right mouse button. This will open the Edit Marker box.

Markers can be edited as soon as they are created by enabling the Edit New Marks option in the Settings menu.

Edit Marker Dialog

This dialog allows the properties of the selected Event Marker to be edited.

The first line is the text displayed on the Event Marker flag, and the large edit box allows more descriptive notes to be added and saved with the marker. (Use <Ctrl> <Return> to add a newline to the note).

The marker is not updated until the Update button is clicked.

The dialog will show the properties of any newly selected marker if a different marker is selected whilst the Edit Marker Dialog is open. This makes it quicker to view the contents of many markers.

Edit New Marks

Enable this option to always open up the Edit Markers dialog box whenever a new marker is created. This is particularly useful if descriptive markers are required during recording. The suggested procedure is:

(i) Press the spacebar to create the new marker. The markers position is set to the time at which the spacebar is pressed.

(ii) Type in the label for the new marker and press return.

The only disadvantages using this method are that one or two data points may be lost whilst Windows creates the Edit Markers dialog box, and that the Doppler Spectrum trace is not redrawn when the dialog box is closed (WCAM1 disables the Doppler trace redrawing whilst recording to minimise lost data).

Note the new marker is not redrawn with the new label until recording is stopped.

Marker Mode

Use this to enable/disable the marker mode. When enabled, clicking the left mouse button will add an Event Marker to that position in the Chart.

Image Markers

If the KK Technology CapiScope™ imaging software is running, then images can be captured and saved to disc automatically from CAM1. A marker is also saved in the CAM1 chart, along with the unique filename of the captured image. Clicking on the marker with the left mouse button will reload the image into CapiScope automatically.

To create an image marker press the F4 function key.

The image will be saved in the current working directory of CapiScope.

The filename is created from the system clock which only has a resolution of 1 second. Therefore attempts to save more than one image in quick succession will result in the second image overwriting the first image.

TEXT

1. Output is in rows, each row corresponding to one pixel on the display x axis.

2. Each trace is output in a separate column(s).

3. Each Doppler spectrum is output in 256 columns (one column for each frequency)

4. Warning: Doppler spectrums will produce very large text files!

5. If 'no selection' is chosen, then data from left to right of the active view is used (even if the trace ends part way through).

BINARY

1. Every point (within selection if applicable) is output irrespective of the x axis scale.

2. If a trace is not in the selection (if applicable) then it will not be output.

3. Each complete trace is output one after the other.

4. Data is always output as 'raw' values.

5. File Format: [HEADER] DATA [HEADER] DATA ..... [HEADER] DATA

6. HEADER FORMAT (total 128 bytes):

7. DATA FORMAT For line traces, the data consists of sequential array of elements, the first being the oldest point, the last is the youngest.

For 2D traces, the data is a sequential array of 256 or 64 point arrays.

Each 256/64 point array being one spectrum (0Hz - bandwidth).

Active Trace Name

The name of the currently active trace is shown here on the status box. Use the TAB key to change the active trace. Use the Trace Properties box to change the name

Trace Name

Name used to describe the active trace. Displayed in the Status Box.

Y units

Y units of the active trace. This is a text string which can be edited by the user.

X units

The x units label. This is a text string which can be edited by the user.

Sample Rate

This shows the interval between samples in x units. Normally this should not be altered since it would have been set when the trace was recorded. (Or in the original trace from which this trace has been derived).

See also Data Rate.

Trace length

This shows the number of samples in the active trace.

Axes X scale

The scaling of the x units to screen pixels.

Trace Start Position

Alter this to shift the trace start position. Don't change the start positions of traces in the Monitor window.

Screen Y scale

The scaling of y units to screen pixels. Note that the Doppler spectrum y scale has to result in the trace being displayed as a power of 2 pixels high.

Screen Y offset

The offset used to shift the active trace in the y axis, in screen pixels. This value does not change with y scale changes. Easier to change by clicking the left mouse button on the y axis and dragging. (Set Y Group to -1 to offset just this trace.)

Y scaling factor

The scaling factor used to scale the stored data to the y axis scale.

Colour / mono Doppler spectrum

Use this command to switch all Doppler traces in all views between colour and monochrome display.

Remember to switch to mono before printing onto a mono printer.

Inverse Colours

This function reverses the colour coding of the Doppler spectrum. Useful for printing out onto non-colour printers, either to save ink or toner, or to improve the visual appearance.

Minimum to background

Use this set the colour of the lowest values to the same colour as the background. This is sometimes useful for printouts in order to either improve the appearance, or to conserve printer ink or toner.

Artifact Limit

Enter a value here for the limit of acceptable values. Either absolute values or percent of the last valid value can be used.

Filter Action