i2 V1.1.

4 API
USER GUIDE

Version 1.2 March 2019

 TABLE OF CONTENTS

 Introduction.................................................................................................. 2

 The i2 API Licence ......................................................................................... 2

 About the MoTeC i2 API ............................................................................... 2

MoTeC i2 API Samples ................................................................................... 2

 i2 API Installation and Activation.................................................................. 3

Installation .................................................................................................... 3
Activation ...................................................................................................... 4

 Using the Samples ........................................................................................ 5

C#.................................................................................................................. 5
MATLAB ........................................................................................................ 5

 i2 Namespace Object Definitions .................................................................. 6

 Overview ...................................................................................................... 7

 Types ............................................................................................................ 8

 Classes ........................................................................................................ 10

 Interfaces.................................................................................................... 11

 Example ...................................................................................................... 36

 Appendix .................................................................................................... 37
i2 Math API.................................................................................................. 37
Range Groups .............................................................................................. 41
Object Model Reference .............................................................................. 42

Page 1
 INTRODUCTION
This document provides an overview of the MoTeC i2 API Licence installation, activation and general use.

 THE i2 API LICENCE

The i2 API Licence allows a user to programmatically interact with logged data via i2 Pro. Some of the functionality of the
i2 API Licence includes:
 Loading any MoTeC pro enabled log file (.ld file)
 Extracting data including channels, laps, beacons and details
 Creating new channels programmatically
 Exporting data to i2 Pro log files

 ABOUT THE MOTEC i2 API

Users can write their own custom software with any programming language that supports COM technology, such as MS
Excel, MATLAB and .NET (VB.NET, C#).
The MoTeC i2 API is an intermediate layer between the i2 application and the third party software that can be used to:
 Get data from an external source, process it and send it to i2; e.g. from simulation software or conversion from
another logging format.
 Get data from a MoTeC log file (.ld), then transform that data for another system (e.g. so it can be used as an input
to a seven-post rig to replicate the suspension movements of an actual race using real vehicle data).

MoTeC i2 API Samples

When i2 Pro is installed, a folder containing i2 API samples is supplied. The samples are simple, but they outline how to
interact with the i2 API in order to get or set data from i2 Pro.

On installation (x64), the sample files are located in the following folder:
C:\Program Files\MoTeC\i2\1.1\Samples\i2API

Page 2
 i2 API INSTALLATION AND ACTIVATION

Installation
1. Install the latest release version of i2 Pro from http://www.motec.com/software/latestreleases/.
2. Start i2 Pro and open a Workspace. If no Workspaces exist in i2 Pro, create a new one via the File > Workspace > New
Workspace… menu.
3. Once a Workspace is open, go to the Help > Licences menu and click on the Request button.
4. In the Request a Licence window, enter your Name and Company, select i2 API and select OK. See Figure 1.

Figure 1: Request a Licence example

Note: The i2 Licence is issued for the specific computer and will need to be updated if the computer hardware
changes.

Page 3
 If you are using an email client (like Outlook or similar), the Licence request email is created automatically after
clicking Yes in the Confirmation window.
Note: If there is no email client running on your computer, a file with instructions will open. Create an email by
following the instructions given.

5. Verify that the Licence request file i2.mtcreq is attached to the email.
6. Send the email to your MoTeC dealer.
The dealer will respond by sending you a Licence Activation file.

Activation
7. On receiving the Licence Activation file from your dealer, save the file to your computer.
8. Start i2 Pro and open a Workspace.
9. Go to the Help > Licences menu. The Feature Licences window displays.
10. Select the Load button and select the Licence Activation file.
After the Licence is activated, i2 API appears in the Feature Licences list with the number of days for which the Licence is
valid. Ensure the Activation Serial No is shown at the top of the window.

Figure 2: Feature Licences Window example

Page 4
 USING THE SAMPLES

C#
1. To select the C# sample file, go to: C:\Program Files\MoTeC\i2\1.1\Samples\i2API\C#.
2. Double click on the i2API.sln file.
If Visual Studio is installed and associated with *.sln files, the sample file will open in the Visual Studio IDE.
Note: If i2 Pro is installed properly and the i2 API Licence is activated, you will be able to compile and run the sample
program.

MATLAB
1. To select the MATLAB sample file, go to: C:\Program Files\MoTeC\i2\1.1\Samples\i2API\MATLAB.
2. Double click on the i2API.m file.
If MATLAB is installed and associated with *.m files, the sample file will open in the MATLAB editor.
Note: If i2 Pro is installed properly and the i2 API Licence is activated, you will be able to compile and run the sample
program.

Troubleshooting
The most common error relates to MATLAB being unable to create the OLE Automation server for the i2 Pro API.
The error usually occurs at the line i2 = actxserver('MoTeC.i2Application'); and the error message is something like
“ActiveX - Invalid ProgID ‘MoTec.i2Application’”.
This issue may be caused by:
 incomplete i2 API registration (may require administrator privileges)
 32/64 bit interop failure
If the error persists, or support is required, please send an email to [email protected]. It is always helpful to attach
screenshots and an example of the code that highlights the problem.

Note: By default, the i2 API loads the most recently used i2 Pro Workspace.

Page 5
 i2 NAMESPACE OBJECT DEFINITIONS
Introduction
This section outlines the object and interface definitions within the “i2” namespace.
Note: Parts of the i2 API are also used by i2 Pro External Maths Plug-ins and External Maths Functions which are discussed
at the end of this document.

Scope
The definitions below are written against “MoTeC i2 2.3 Type Library” unless specified otherwise.
Items marked as “Internal Use Only” are not expected to be used by third parties and are thus not fully documented.
Some programming knowledge is expected. Terms such as Instantiation, Namespace, Class, Method and Property are used
throughout this section.

Notes
 Be sure to add the latest i2 Type Library as a reference to all .NET based projects.
 All time values (unless stated otherwise) are in microseconds [ µs ].

Page 6
 OVERVIEW
The following diagram illustrates the main interfaces and connections associated with the i2 API.

Page 7
 TYPES
The following enumerations are used by the classes and interfaces described throughout this document.

AntiAliasFilterType
 aaNone
 aaAvg
 aaMin
 aaMax

This type is only available with i2 Type Library v2.4 or higher.

ChannelStatus
 Valid
 Invalid

Dimension
 Array
 Scalar

EDataExtent
 deMainRange
 deMainRangeOuting
 deMainRangeZoom

ESampleRateOpt
 srCustom
 srDefault
 srFastest

Page 8
The following types provide string constants to be used by some API methods:

DataType
 Integer = “MoTeC.Integer”
 Real = “MoTeC.Float”
 String = “MoTeC.String”

Layer
 Burst0 = “Burst0”
 Burst1 = “Burst1”
 Details = “Details”
 Fastest = “Fastest”
 Normal = “”
 SetupSheet = “SetupSheet”

Page 9
 CLASSES
The following classes represent the primary entry point into the i2 API. Once instantiated, these instances will provide the
ability to create, read and update data within i2.

Application
Class denoting an instance of the i2 application. It connects to an already running instance of the i2 application, or starts
one if not.

Example ( C# )
var i2 = new i2.Application();
i2.Visible = true;
i2.Exit();

Implements the IMtcI2Application interface.

ApplicationSingle
Class denoting an instance of the i2 application. Unlike the Application class, it always creates a new instance of an i2
application. It implements same properties and methods as the Application class.

Example ( C# )
var i2 = new i2.ApplicationSingle();
i2.Visible = true;
i2.Exit();

Implements the IMtcI2Application interface.

Page 10
 INTERFACES
The following interfaces, in combination, make up what is known as the i2 API.

IMtcApplication
The generic MoTeC application interface.

Properties
Name Type Description
Name string Get the application name

Version string Get the application version

Visible boolean Get the application’s visibility. COM

Server usually starts invisible and must
be explicitly made visible

Methods
Name Parameters Description
void
Exit()

Exit the i2 application

void
ShowHelp()

Show the i2 Help Window

void
ShowHelpAbout()

Show the i2 Help About window

Page 11
IMtcChannel
Represents a channel in i2.

Properties
Name Type Description
DataArray IMtcDataArray Get/Set the data array (samples)
associated with this channel

Descriptor IMtcChannelDescriptor Get the descriptor for this channel

Id string Get the channel display name

Status ChannelStatus Get/Set the data array validity status

StatusText string Get/Set the data array validity

message. This text is displayed in the
"Tools|Channel Status" dialogue of i2

Methods
Name Parameters Description
IMtcDataArray SampleRate: usually between 1 – 1000
CreateDataArray( Hz

double SampleRate
) A buffer is created with enough space
to store samples at this rate for the
time extent of the data source
Creates a DataArray for this channel definition, based on
the sample rate required

void DataArray: the new data to be set

SetData(
Status: the new channel status to be
IMtcDataArray DataArray, set
ChannelStatus Status,
StatusText: the new message to be set.
string StatusText When the status is invalid, it can
) indicate the reason

Updates the channel’s data state

Page 12
IMtcChannel2
Extends the IMtcChannel interface with the following properties. These properties are a shortcut to the same properties
exposed via the Descriptor.

Properties
Name Type Description
Color long Get the color (RGB)

ColorIndex long Get/Set the color index. This specifies a

color as an index into the color theme
palette for channels (see
“Tools|Options|Colors” in i2)

DPS long Get/Set the number of decimal places

to be shown for any value

Interpolate boolean Get/Set the interpolation mode for the

channel data. When true, the linear
interpolation is used, otherwise
previous value is retained

ScaleMin double Get/Set the minimum expected value.

Its units must be based on the current
“Unit” settings

ScaleMax double Get/Set the maximum expected value.

Its units must be based on the current
“Unit” settings

Unit string Get/Set the display unit. The unit string

must match an i2 text unit as shown in
“Tools|View Units…”

IMtcChannel3
Extends the IMtcChannel2 interface with additional properties and methods.

This type is only available with i2 Type Library v2.4 or higher.

Page 13
Methods
Name Parameters Description
IMtcDataArray StartIndex: an index to start resampling
DataArraySegmentFromIndexes ( Count: the number of samples to be
int StartIndex, resampled
int Count,
SampleRate [Hz]: the new sampling
double SampleRate, rate (can be higher or lower than the
int AntiAliasFilterType original rate)

) AntiAliasFilterType [enum]: when

Generates a resampled data array over the interval decimating, it is applied to the source
defined by the start/count indexes samples

IMtcDataArray StartTime [µs]: time to start resampling

DataArraySegmentFromInterval (
EndTime [µs]: time to stop resampling
double StartTime,
SampleRate [Hz]: the new sampling
double EndTime,
rate (can be higher or lower than the
double SampleRate, original rate)
int AntiAliasFilterType
AntiAliasFilterType [enum]: when
) decimating, it is applied to the source
Generates a resampled data array over the interval samples
defined by the start/end times

IMtcChannelDescriptor
Defines some basic properties that describe a channel (without the channel necessarily existing).

Properties
Name Type Description
Color long Get the color (RGB)

ColorIndex long Get/Set the color index. This specifies a

color as an index into the color theme
palette for channels (see
“Tools|Options|Colors” in i2)

DPS long Get/Set the number of decimal places

to be shown for any value

Page 14
 Name Type Description
Id string Get the display name

Interpolate boolean Get/Set the interpolation mode for the

channel data. When true, the linear
interpolation is used, otherwise
previous value is retained

ScaleMin double Get/Set the minimum expected value.

Its units must be based on the current
“Unit” settings

ScaleMax double Get/Set the maximum expected value.

Its units must be based on the current
“Unit” settings

Unit string Get/Set the display unit. The unit string

must match an i2 text unit as shown in
“Tools|View Units…”

IMtcChannelDescriptors
A collection of IMtcChannelDescriptor objects.

Properties
Name Type Description
Count long Get the number of arguments in the
collection

Page 15
Methods
Name Parameters Description
IMtcChannelDescriptor Id: display name
Add ( Type: the DataType of the channel
string Id,
Unit: the default display unit
string Type,
string Unit
)

Add a new descriptor to the collection. The Id must be

unique

void Id: display name

Remove (
string Id
)

Remove the named channel descriptor from the

collection

IMtcChannelDescriptor Nth: arguments index

Index[long Nth]

Get the Nth descriptor

IMtcChannelDescriptor Name: arguments name (same as Id)

Item(string Name)
Get the named descriptor

Page 16
IMtcChannels
A collection of IMtcChannel objects.

Properties
Name Type Description
Count long Get the number of channels in the
collection

Methods
Name Parameters Description
IMtcChannel Id: display name
Add ( Type: the DataType of the channel
string Id,
string Type
)

Add a new channel to the collection. The Id must be

unique

IMtcChannel Nth: arguments index

Index[long Nth]

Get the Nth channel

IMtcChannel Name: arguments name

Item(string Name)
Get the named channel

Page 17
IMtcChannelSource
Represents the channels available from a data source. All interfaces from here are read-only.

Properties
Name Type Description
Channels IMtcChannels Get the channels associated with this
source

Details IMtcDetails Get the details associated with this

source

Name string Get the name of this source

IMtcDataArray
The main interface for dealing with data samples in i2.

Properties
Name Type Description
Count long Get the number of samples of the data

EndTime double Get the end time (µs) of the data

Rate double Get the sample rate (Hz) of the data

SampleFlags object [ array ] Get/Set the actual sample flags. Each

sample contains a flag indicating
validity:
 0 = invalid
 1 = valid

Samples object [ array ] Get/Set the actual samples

StartTime double Get the start time (µs) of the data

Unit string Get/Set the data unit. The unit string

must match an i2 text unit as shown in
“Tools|View Units…”

Note: This does not perform any unit

conversion but simply labels the data
as being in this unit

Page 18
Methods
Name Parameters Description
Object Time [µs]: time

GetValue (
double Time
)
Return the sample value at the given time. Depending on
the channel’s interpolation mode, it may return an
interpolated value

long Time [µs]: time

SampleIndex (
double Time
)
Return the sample index for a given time

double
SampleTime (
long Index
)
Return the sample time [µs] for a given index. The index
may be beyond the interval of the actual samples
available

IMtcDataLayer
Represents a time interval of logging. Typically used to represent Normal and Burst logging groups.
Properties
Name Type Description
Channels IMtcChannels Get the channels collection

MarkerGroups IMtcMarkerGroups Get the marker groups collection

Name string The name of the layer (see Layer)

An empty name implies “Normal”

RangeGroups IMtcRangeGroups Get the range groups collection

Page 19
IMtcDataLayers
A collection of IMtcDataLayer objects.

Properties
Name Type Description
Count long Get the number of data layers in the
collection

Methods
Name Parameters Description
IMtcDataLayer Nth: data layer index
Index[long Nth]

Get the Nth data layer

IMtcDataLayer Name: data layer name. Valid names

Item(string Name) are defined in the Layer enumeration
Get the named data layer

IMtcDataSelection
Represents a data selection in i2.
Properties
Name Type Description
CursorTimeDatum double Get the datum cursor time [µs]

CursorTimeMain double Get the main cursor time [µs]

CursorTimeRealTime double Get the real-time cursor time [µs]. Only

available when the data selection is
tracking a live telemetry data source

DataSource IMtcDataSource Get the active data source

Name string Get the data selection name

Page 20
Methods
Name Parameters Description
void StartTime: out parameter, receives the
GetZoomTime( zoom start time [µs]
double StartTime, [out]
double EndTime [out] EndTime: out parameter, receives the
) zoom end time [µs]

Get the current zoom start/end extent

IMtcDataSelection2
Extends the IMtcDataSelection interface with the following properties.
Properties
Name Type Description
ChannelSource IMtcChannelSource Get the associated channel source

IMtcDataSelections
Represents the main and (optional) reference IMtcDataSelection interfaces currently active in i2.

Properties
Name Type Description
Main IMtcDataSelection Get the main data selection for the
active component in i2

Reference IMtcDataSelection Get the reference data selection for the

active component in i2. This may be
null when no reference is selected.

Name string Get the name

IMtcDataSource
A data source can represent:
 An LD representing logged data
or
 An active telemetry stream

Page 21
Properties
Name Type Description
Date date Get the date of the data source

Descriptors IMtcChannelDescriptors No longer used by i2

Details IMtcDetails Get the details associated with the data

source

Layers IMtcDataLayers Get the data layers existing within the

data source

Name string Get the name of the data source

Quantities IMtcQtys Get the quantities available in i2

SetupSheet IMtcSetupSheet Get the setup sheet associated with the

data

Time date Get the time of this data source

Units IMtcUnits Get the units available in i2

Methods
Name Parameters Description
IMtcDataArray Type: the DataType of the array. One
CreateDataArray( of:

string Type, DataType.Integer

double StartTime, DataType.Real
double EndTime,
DataType.String
double SampleRate
) StartTime [µs]: start time of data
(usually 0)
Create an unbound data array
EndTime [µs]: end time of data

SampleRate [Hz]: sample rate of the

data

Page 22
IMtcDataSources
A collection of IMtcDataSource objects.

This interface and methods can only be accessed if you have a valid i2 API Licence

Properties
Name Type Description
Count long Get the number of data sources in the
collection

Main IMtcRange Get the currently active main range

Reference IMtcRange Get the currently active reference

range

Methods
Name Parameters Description
IMtcDataSource Nth: data layer index
Index[long Nth]

Get the Nth data layer

Source: A fully qualified file name to an

IMtcDataSource LD file, or the telemetry source,
Open( prefixed with t2://
string Source
)
Open a new data source into i2

void
Close(
IMtcDataSource DataSource
)
Close the supplied data source

void
CloseAll()
Close all data sources currently loaded

Page 23
 Name Parameters Description
IMtcDataSource Duration [µs]: the amount of time
Create( represented by the data source
double Duration
)
Create a data source that represents an interval of time

void FileName: the destination file name of

ExportMain( the export
string FileName,
EDataExtent DataExtent DataExtent: amount of data to be
) exported (for example, the selected
lap, the entire outing or just the
Export the main selection logged channels as an LD file currently zoomed extent)

Note: Maths channels are not included

void FileName: the destination file name of

ExportMainAsMAT( the export
string FileName,
EDataExtent DataExtent
DataExtent: amount of data to be
ESampleRateOpt SampleRateOption
exported (for example, the selected
double CustomSampleRate
lap, the entire outing or just the
)
currently zoomed extent)
Export the main selection logged channels as a MATLAB
(type 5) file SampleRateOption: specify a sample
rate export option

Note: Maths channels are not included CustomSampleRate: specify a sample

rate if SampleRateOption is set to
srCustom

void DataSource: the data source to be

Refresh( updated
IMtcDataSource DataSource
)
Refresh any derived details and UI for this data source.
Typically it is called after details have been updated.

Page 24
IMtcDataSources2
Extension of the IMtcDataSource interface.

This type is only available with i2 Type Library v2.4 or higher.

Methods
Name Parameters Description
void FileName: the destination file name of
ExportMainAsCSV( the export
string FileName,
EDataExtent DataExtent DataExtent: amount of data to be
) exported (for example, the selected
lap, the entire outing or just the
Export the main selection logged channels as a MoTeC currently zoomed extent)
CSV file

Note: Maths channels are not included

IMtcDetail
Represents a detail (named value).

Properties
Name Type Description
Id string Get the name of the detail

Unit string Get the unit of the numeric value

Value object Get/Set the value. It will either be a

string or a double based on the
IsNumeric property

Page 25
Methods
Name Parameters Description
string
ToString()

Get the value as a string

bool
IsNumeric()

Returns if the value is interpreted as a number or string

IMtcDetails
Represents a collection of IMtcDetail objects.
Properties
Name Type Description
Count long Get the number of details in the
collection

Methods
Name Parameters Description
IMtcDetail Nth: details index
Index[long Nth]

Get the Nth detail

IMtcDetail Name: details name

Item(string Name)
Get the named detail

void Id: details name

AddDateTime(
string Id, Value: the date or time value
date Value
)
Add a date detail

Page 26
 Name Parameters Description
void Id: details name
AddNumeric(
string Id, Value: the numeric value
double Value, Unit: the i2 unit
string Unit,
int DPS DPS: the decimal places
)
Add a numeric detail

void Id: details name

AddString(
string Id, Value: the string value
string Value
)
Add a string detail

IMtcI2Application
The primary entry point into using the i2 API (extends the IMtcApplication interface).

Properties
Name Type Description
QueryAPI IMtcQueryAPI Internal Use Only

DataSources IMtcDataSources Get the data sources interface. You

must have a valid i2 API Licence in
order to retrieve this interface

Methods
Name Parameters Description
void
WorkspaceNew()

Launch the new Workspace dialogue

void
WorkspaceOpen()

Launch the open Workspace dialogue

Page 27
 Name Parameters Description
void File: fully qualified file name to be
WorkspaceLoad( loaded
string File
)
Load the Workspace from the file

void
WorkspaceLoadRecent()

Load the most recently used Workspace

void Internal Use Only

WorkspaceLoadTemplate( template)

void
CheckForUpdates()
Launch the checks for update dialogue

IMtcMarker
Represents a point in time or distance within the data (layer).
Properties
Name Type Description
ClassName string Get the marker class. Marker classes
differ depending on the type of
Workspace that opens. Examples (for
circuit) include:
 BCN (main lap beacon)
 SPLTBCN (split beacon)
 IGRDBCN (ignored beacon)
 RESET (device reset)
 SOL (start of logging)
 EOL (end of logging)

Comment string Get the comment associated with the

marker

Page 28
 Name Type Description
MarkerGroup IMtcMarkerGroup Get the marker group that contains the
marker

Name string Get the unique name of the marker

Parent IMtcMarker Get the parent marker. Markers are

stored relative to their parent

Time double Get the absolute time of the marker

[µs]

IMtcMarkerGroup
Represents a collection of IMtcMarker (usually of the same class).

Properties
Name Type Description
Count long Get the number of markers in the
collection

Name string Get the name of the group

Methods
Name Parameters Description
IMtcMarker Nth: marker index
Index[long Nth]

Get the Nth marker

IMtcMarker Name: marker name

Item(string Name)

Get the named marker

IMtcMarker Name: marker name

Add(string Name)

Add a new marker

Page 29
 Name Parameters Description
void
Clear()
Clear all the markers from the group

IMtcMarkerGroup2
Extends the IMtcMarkerGroup interface with the following methods.

Methods
Name Parameters Description
IMtcMarker Parent: parent marker
AddDistMarker(
IMtcMarker Parent,
ClassName: the class of marker
string ClassName
string Name,
double Distance, Name: unique name of the marker
string Comment
)
Distance [m]: distance relative to the
Add a distance [m] based marker (relative to the parent parent marker
marker) to the group
Comment [optional]

IMtcMarker Parent: parent marker

AddTimeMarker(
IMtcMarker Parent,
string ClassName ClassName: the class of marker
string Name,
double Distance,
Name: marker name
string Comment
)
Add a time [µs] based marker (relative to the parent Time [µs]: time relative to the parent
marker) to the group marker

Comment [optional]

Page 30
IMtcMarkerGroups
A collection of IMtcMarkerGroup objects

Properties
Name Type Description
Count long Get the number of marker groups in
the collection

Methods
Name Parameters Description
IMtcMarkerGroup Nth: marker group index
Index[long Nth]

Get the Nth marker group

IMtcMarkerGroup Name: marker group name

Item(string Name)
Get the named marker group

IMtcRange
Represents a range (defined between two markers) in i2.

Properties
Name Type Description
Abbrev string Get/Set the range name abbreviation
(e.g. “L1” for “Lap 1”)

Enabled boolean Get/Set the enable state of the range

Start IMtcMarker Get the range start marker

End IMtcMarker Get the range end marker

Name string Get the range name (e.g. “Lap 1”)

RangeGroup IMtcRangeGroup Get the range group this range is

associated with

Trusted boolean Get/Set the trust state of the range.

Untrusted ranges are optionally
excluded from i2 calculations (e.g.
In/Out laps for auto scale)

Page 31
IMtcRangeGroup
A collection of IMtcRange objects.

Properties
Name Type Description
Count long Get the number of ranges in the
collection

Name string Get the name of the range group

SupportsReporting boolean Get/Set if report generation can be

performed for ranges within the group

SupportsTrackGeneration boolean Get/Set if track generation can be

performed for ranges within the group

Methods
Name Parameters Description
IMtcRange Nth: range index
Index[long Nth]

Get the Nth range

IMtcRange Name: range name (e.g. “Lap 1”)

Item(string Name)
Get the named range

IMtcRange Start, End: markers defining the extent

Add( of the range
IMtcMarker Start,
IMtcMarker End, Name: range name
string Name
)

Add a new range

void
Clear()
Clear all the ranges from the group

Page 32
IMtcRangeGroups
A collection of IMtcRangeGroup objects.

Properties
Name Type Description
Count long Get the number of range groups in the
collection

Methods
Name Parameters Description
IMtcRangeGroup Nth: range group index
Index[long Nth]

Get the Nth range group

IMtcRangeGroup Name: range group name

Item(string Name)
Get the named range group

IMtcSetupSheet
Represents a Microsoft Excel based setup sheet in i2.
Properties
Name Type Description
Details IMtcDetails Get the details from the setup sheet

FileName string Get the file name of the setup sheet

IMtcQty
Represents a quantity in i2.

Properties
Name Type Description
DisplayName string Get the quantity name (e.g.
Acceleration)

Symbol string Get the quantity symbol (e.g. m/s²)

Page 33
 Name Type Description
Units IMtcUnits Get the units associated with the
quantity

IMtcQtys
A collection of IMtcQty objects.

Properties
Name Type Description
Count long Get the number of quantities in the
collection

Methods

Name Parameters Description

IMtcQty Nth: quantity index
Index[long Nth]
Get the Nth quantity

IMtcQty Name: quantity name

Item(string Name)
Get the named quantity

IMtcUnit
Represents a unit in i2. The full set of units available in i2 can be seen in “Tools|View Units…”.

Properties

Name Type Description

DisplayName string Get the unit name (e.g. Celsius)

DisplaySymbol string Get the unit symbol (e.g. ºC)

Symbol string Get the text-only symbol (e.g. C)

Qty IMtcQty Get the quantity this unit belongs to

Page 34
Methods
Name Parameters Description
void Value: [in] SI value, [out] unit value
FromSI(
object Value [in/out]
)

Convert value from SI to this unit

void Value: [in] unit value, [out] SI value

ToSI(
object Value [in/out]
)

Convert value from this unit to SI

IMtcUnits
A collection of IMtcUnit objects.

Properties
Name Type Description
Count long Get the number of units in the
collection

Methods
Name Parameters Description
IMtcUnit Nth: unit index
Index[long Nth]
Get the Nth unit

IMtcUnit Name: unit name

Item(string Name)
Get the named unit

Page 35
 EXAMPLE
The following C# example iterates through channels from a pre-loaded data source in i2 and output name and display unit
information.
For the “Engine RPM” channel (if it exists), it will also output 2 seconds of samples from the start of the data.

Example ( C# )

static double SecondsToTimeBase = 1e6;

static double TimeBaseToSeconds = 1/SecondsToTimeBase;

// Print out all channels in the first data source loaded,

// For “Engine RPM” channel, print out the samples covering the first 2 seconds
var i2 = new i2.Application();
i2.Visible = true;
if (i2.DataSources != null && i2.DataSources.Count > 0)
{
var ds = i2.DataSources[0];
var dl = ds.Layers[Layer.Normal];
if (dl != null)
{
foreach (IMtcChannel2 channel in dl.Channels)
{
Console.Write("name = {0,30}, display unit = {1,6}\n", channel.Id,
channel.Unit);

if (channel.Id == "Engine RPM") {

var da = channel.DataArray;
var s = da.Samples as double[];
var i0 = da.SampleIndex(0 * SecondsToTimeBase);
var i1 = da.SampleIndex(2 * SecondsToTimeBase);
for (var i = i0; i < i1; i++)
{
var v = s[i];
var t = da.SampleTime(i) * TimeBaseToSeconds;
Console.Write("t = {0,5} v = {1,8} {2,6}\n", t, v, da.Unit);
}
}
}
}
}
i2.Exit();

Note: You may need to set the “Embed Interop Types = False” property on the i2 Reference in your Visual Studio solution.

Page 36
 APPENDIX

i2 Math API
Unlike the i2 API interfaces mentioned previously, the i2 Math API are a set of interfaces that you can implement to
provide i2 with hooks into your own custom code.
Note: Math plug-ins may need to be registered under administrative privileges (i.e. start i2 with 'Run as Administrator').

IMtcArgs
Represents the i2 Math function arguments passed into your custom Math function.

Properties
Name Type Description
Count long Get the number of arguments in the
referenced collection

Methods

Name Parameters Description

IMtcMathArray
CreateResultArray()
Creates a suitable Math array to store any generated
samples.

object Nth: arguments index

Index[long Nth]
Get the Nth argument

object Name: arguments name

Item(string Name)
Get the named argument

Page 37
IMtcMathArray
Extends the IMtcDataArray interface with additional properties.

Properties
Name Type Description
MathEndTime double Get the end time for this Math based
array [µs]

MathStartTime double Get the start time for this Math based
array [µs]

IMtcMathFunction
Implement this interface to add your own Math functions into i2.
Methods

Name Parameters Description

object Args: The arguments collection passed
Evaluate( into this function
IMtcArgs Args
)

Implement this method and return back with a single

value or a data array

IMtcMathPlugin
Implement this interface to add your own Math results into i2.
Properties
Name Type Description
InputChannels string [ array ] Get the channel names this plug-in
requires

OutputChannels string [ array ] Get the channel names this plug-in

generates

Settings string Get/Set the plug-in settings as a string

(e.g. JSON)

Page 38
 Name Type Description
Summary string Get the high level description of the
plug-in

Methods

Name Parameters Description

object Args: The arguments collection passed
Execute( into this plug-in
IMtcMathPluginArgs Args,
IMtcChannels Results Results: the collection of channels that
) the plug-in generates

Implement this method and perform whatever

calculations you require, returning to i2 multiple results

void Descs: Register the name and type

Register( (color etc.) of the channels that are to
IMtcChannelDescriptors Descs be generated
) Since i2 generates Maths on demand,
Implement this method to register the details of the plug-ins must register their intent to
channels this plug-in generates generate channels before they are
required to actually perform the
calculations

void
UnRegister(
IMtcChannelDescriptors Descs
)
Implement this method to unregister the channels this
plug-in generates

void
ShowSettings()
Implement this method to show any UI required for the
user to edit settings

Page 39
IMtcMathPluginArgs
Represents the i2 Math plug-in arguments.

Properties
Name Type Description
DataLayerName string Get the data layer name this plug-in is
currently executing in (within the
supplied data source context)

DataSource IMtDataSource Get the data source context this plug-in

is currently executing in

Page 40
Range Groups
Range groups are collections of ranges. A range defines a time or distance extent (based on markers) within the normal
data layer.
The following range groups are available in i2 (based on their Workspace type):

Circuit
“Outings:Laps” – A collection of lap ranges
“Outings:Laps:Splits” - A collection of splits

Drag
“Outings:Runs” – Typically a single run range

Rally
“Outings:Stages” – Stage and transport ranges

Engine
“Outings:Data” – Typically a single extent of data

Page 41
Object Model Reference

Page 42