T-Stick output namespace

The following is a list of control data that the t-stick presently outputs. These are the outputs that literally ‘fill’ the lefthand space in the Digital Orchestra Tools Mapper (DOTMapper) interface, therefore, we collectively refer to the outputs as the instrument “namespace”. Moreover, because the DOTMapper is designed to send data over a network using the OSC protocol, the outputs are formatted to resemble a URL address (e.g., andrew.stewart/pages/tcw/2010TCW/).

An effort has been made to choose names in the namespace that reflect the tangible manipulation, manoeuvring and physical playing techniques of the soprano t-stick. Please remember that one goal of the 2010TCW is to develop new techniques and subsequently, add new outputs to the soprano t-stick namespace.

The namespace is organised into four data-conditioning layers:


Untreated, unprocessed t-stick data received by the serial object in Max/MSP.


Processed ‘/raw’ t-stick data requiring conditioning in order to extract a meaningful data profile. The treatment of data in this layer consists of operations such as: scaling an output range, smoothing a signal as a means of eliminating inherent sensor jitter, tagging data for processing in the ‘/instrument’ layer.


Processed ‘/raw’ and ‘/cooked’ data, used separately or in combination, with the goal of deriving control data that represents the physical manoeuvring of the instrument. Generally speaking, the names in the ‘/instrument’ layer refer less to the sensing technology of the instrument and more to playing technique.


In the ‘/system’ layer, data from other layers cause a fundamental behaviour change in the t-stick (e.g., masking of specific sensors, affecting a limit on the value of a sensor, state change). This layer is used sparingly because the design and performance philosophy behind the t-stick is based on consistency. That is to say, we have developed the t-stick partially based on an acoustic instrument paradigm, where identifying and playing the instrument remains regular and predictable.

T-Stick Output Namespace ( download as text file)
(13 August, 2010)

/raw/pressure Squeezing with a firm grip or pressing on the 'soft' backside of the instrument.
/raw/piezo Tapping, twisting or any manipulation that causes a vibration along the surface. Note, this sensing modality tends to be effective only in the centre of the instrument and achieving a consistent value in relation to the amount of energy exerted is difficult.
/raw/accelerometer/x Shifting the instrument left and right while holding it in a position parallel to the ground.
/raw/accelerometer/z Shifting the instrument forward and backward while holding it in a position parallel to the ground with the front of the instrument (hard surface) pointing away from the body, toward the audience.
/raw/accelerometer/y Shifting the instrument up and down while holding it in a position parallel to the ground with the front of the instrument (hard surface) pointing away from the body, toward the audience.
/cooked/accelerometer/horizontal Identical movement to /raw/accelerometer/x.
/cooked/accelerometer/frontal_RH Identical movement to /raw/accelerometer/z.
/cooked/accelerometer/vertical_RH Identical movement to /raw/accelerometer/y.
/cooked/touch/top Touching the instrument at the top end, opposite the USB port.
/instrument/compressed/finger_on Framing the contact area of the instrument with the index finger of one hand and the pinky finger of the other hand. This results in creating a compressed range of 10 discrete values (e.g., 10 discrete notes) triggered by fingering/touching between the 'framing' fingers.
/instrument/compressed/finger_off Identical to /instrument/compressed/finger_on with an additional transposition feature as a result of the area being framed. For example, a value range of 1 to 10 can be expanded/transposed to, say, 11 to 20 by moving the 'framing' fingers.
/instrument/frame/upper_pole Upper 'framing' finger, furtherest from the USB port. Refer to /instrument/compressed/finger_on for a description of framing.
/instrument/frame/lower_pole Lower 'framing' finger, nearest the USB port. Refer to /instrument/compressed/finger_on for a description of framing.
/instrument/frame/width Distance between framing fingers.
/instrument/arc/01 A combination of tilting and rotating. '/arc' refers to the implementation of an arc tangent function.
/instrument/arc/02 A combination of tilting while altering the framing width. Refer to /instrument/compressed/finger_on for a description of framing.
/instrument/arc/03 A combination of framing width and lower framing finger. Output depends on the width and location of the frame.
/instrument/swing/strike_number Thrusting identified by a distinct number.
/instrument/swing/RH/point Thrusting or swinging.
/instrument/surface_contact A measure of the surface area being touched.
/instrument/grip/cradle/width Resting the instrument on the forearm, similar to cradling a child.
/system/state_change/01 Maintaining a tight grip (i.e., squeezing) for a specified duration affects a limit on sensor values.
This entry was posted in Mapping. Bookmark the permalink.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s