Page 3
Part 4 Version and Legal Information Part 5 Application Modes Part 6 Scaling conventions Part 7 Logging In and Out of K2 Part 8 Live and Offline Modes Part 9 Exiting the Application Part 10 The Patch Browser Part 11...
This manual has been written to guide you intuitively through the K2 software package. It has been laid out in such a way to make understanding K2 as simple as possible. The fundamental principles are explained at the start of each section with the more in depth and advanced features being towards the rear of each section.
It is the responsibility of the user to perform a risk assessment for the whole system and to take appropriate action as a consequence of that assessment. Although K2 provides realistic 3D feedback of the movement of objects a line of sight view of the actual moving pieces should always be ensured. Where necessary additional observers should be employed utilising clear lines of communication to be able to advise the operator of any issues that may arise during the movement of objects.
(shown above). Auto Alignment There is now an Auto Align button on the toolbar of K2. This button aligns the virtual objects in K2 to the real world positions of the objects, allowing K2 to realign itself without any movement in the real world. For more information see the...
Kinesys. There are three modes in total, each offering different functions to the user. Full Full mode is the top level mode for K2. In this mode all features are available to the user, there are no restrictions on moving devices.
Scaling conventions Scaling conventions All World and Construct models should be scaled in millimeters. All movement within K2 is recorded and displayed in whole millimeters. Meters and the decimal point are not used so ten meters would be entered and displayed as 10000.
Page 12
You can log out of K2 without exiting the application. This leaves the application in a safe state where a username and password must be entered before access to K2 is available again.
Live and Offline Modes Live and Offline Modes K2 can operate in two main modes, Live and Offline. In Live mode all motion commands are outputted onto the network for action by the external control Channels and their respective machines. Unaligned Constructs and inhibited Channels are the only reasons that motion commands will be not be outputted.
Auto Alignment harder to achieve, as there are obviously far more variables, but K2 will still do it's best to auto align. The Auto Align feature uses the information that K2 has about the real world positions of Constructs and Channels to match the virtual positions to them.
Finally firmware can be reloaded to the wing from this tab. Click on the Reload Firmware button to have K2 reload the latest version of the firmware to the console.
The advanced tab contains variables relating to the low-level running of the motion and communications software engines. These should not be adjusted unless you are specifically requested to do so by a member of the Kinesys support team or one of their approved K2 partners.
Close cross in the top right hand corner of the window. Password Checking K2 can be set to request password confirmation when exiting Safe mode and also after a period of inactivity. These can be turned on and off individually. Click on Show Properties from the Setup toolbar and then set the check boxes appropriately to set the password protection appropriately.
15.2 Environment Variables K2 has a number of global show variables that can be referenced throughout the application but can only be changed in one place. Anything that references a show variable will therefore be affected whenever the show variable is altered. The system comes with a number of preset variables but new ones can be added if you wish.
15.4 Advanced Settings The Advanced Settings tab allows fine tuning of advanced settings within K2. It is strongly advised that these settings are not altered without prior consultation with Kinesys or associated partners, see the Contact Us section of this manual for contact details.
Construct Building and Editing Construct Building and Editing A Construct represents a moving item within K2. You will need to add one Construct for every item you wish to control. It is important to remember when creating constructs (or entering any information into K2) that the results that K2 produces are only as good the information that is entered.
Page 31
State Multicast K2 has the ability to multicast its positional information out over the network, enabling other services such as media servers to know the exact position of objects on stage. As part of this broadcast it is also possible to "listen in" on just one construct and one parameter of that constructs movement, in the example shown above just the Z parameter.
.3ds files that can be used. The K2 software allows you to build a basic straight or circular object if you don’t have a pre-built file. Select Parametric and then from the drop down box select either Straight or Circle.
Once a model has been chosen, a top down view will be displayed in the Links step.Links are the attachment points for the machines that will move the model. It is very important that the Links are connected at the correct coordinates so that K2 can correctly calculate the movement required by each Channel.
16.4 Drawing Construct and Stage Models in CAD K2 makes extensive use of graphical models for both the Stage Model as well as all the Constructs used within the show. These are all stored in a 3D Studio format (file extension .3ds)
For example a variable speed chain hoist is controlled by an Elevation 1+ controller while a wire rope winch would be controlled via a Velocity drive. K2 does not need to know the exact type of controller being used, it simply needs to know how to communicate with that device in order to send it movement and status commands and requests.
Machine types are stored in personality files that can be added to a system at any time. K2 is shipped with a number of popular machine types included. These include chain hoists from a number of different manufacturers as well as several custom machines.
1 every time a new Channel is added. Length Calculation This defines the Zero Height Reference that K2 uses to work at what height the channel originates, in order to work out how much chain or cable or payed out from that point.
Channel intact but prevents any motion commands being sent out to the controller. The Tracking section defines how much tolerance K2 gives to positions errors while either static or moving. This can either be a figure (in mm) or an Environmental Variable.
17.2.3 Drive Parameters The Drive Parameters tab contains two sections the top section, Scaling contains, two fields. Encoder scaling and Loadcell scaling. These two parameters effect how K2 interprets the information it receives from encoders and loadcells and by default are setup automatically when a channel is added.
18.1 Cue Selection and Display K2 is based on the concept of Cues and Cuelists. A Cue is a collection of actions that can be as small as a single Construct parameter and as large as an action for every parameter on every Construct.
18.2.2 Cue Triggers K2 has two Trigger types, Manual and Follow. To apply or change a Cue’s Trigger open the relevant Cuelist window by either selecting the correct Cuelist in the Cuelist Directory and clicking open or, if the Cuelist is currently loaded onto a Master, by double-clicking...
Rate Override setting for that Master will be reset to the default of 100% 18.2.5 Playback Lookahead One of the advanced features of K2 is the look-ahead engine. This feature enables the system to calculate movement of Constructs into the future and anticipate potential problems and collisions before they happen which in turn allows the user to take corrective action without having to stop and restart all movement.
Construct’ s collision limits. If no action is taken by the user to avert the error condition then K2 will force a stop on the Construct when there is 0.5 seconds remaining until the error condition occurs. This will result in a fast stop being sent to all the relevant Constructs.
18.3.2 Delaying Effects Effects in K2 are sinusoidal in nature. The length of the sine wave effect is specified by the ‘Period’ field in the move information and the position of the parameter is determined by applying a factor between 0 and 1 to the ‘Size’ field and adding that to the ‘Value’...
Working with Cues 18.5 Keyboard Shortcuts Cues can be played back and stopped using the keyboard as well as clicking on buttons on the screen when a K2 Wing is not available. The keyboard shortcuts used are listed below Keyboard Shortcut Action...
Page 67
Action actuator or any other motive engine. Each Machine will have a controller associated with it that will provide the interface to the K2 software. Page A Page is a pre-selected arrangement of Cuelists loaded onto Masters. This means all the Cues for a particular section of a show can be made available quickly without needing to load each Cuelist individually.
Page 68
All K2 programming and visualisation is done within a 3D World. This World can be imported into K2 in the form of a 3D Studio file (.3ds). All co-ordinates for the position and movement of Constructs are based on the origin and scale of the imported World.
Working with Spreadsheets Working with Spreadsheets The spreadsheet view is a common one in K2. It is used in many of the windows to display data and provide status feedback as well as to allow the editing and entry of data.
Page 78
A list cell will display a list box when edited which can be opened to allow a selection from an existing list. The list data is created by K2 from list created in a separate window within K2. For example the ‘Preset’ cell in the Programmer spreadsheet offers a list of all the existing Presets.
Enter key is pressed which causes K2 to evaluate the contents of the command line and either execute the command if the data is correct or inform the user that the command line cannot be decoded correctly.
If the controllers have been discovered and you are happy that the external Channel is physically in the correct position compared to where K2 is expecting it to be then you can enable the Channel.
If a personality file for a Channel type has been updated since the show was first created clicking on Reload Motor or Reload All Motors will force K2 to overwrite its internal copy of the motor details with the new one taken from the personality file. This will not update existing Channels that have already been created.
Page 94
25.9 The Log window provides access to the logging data generated by K2. All log entries are saved to folders which are assigned the same name as the show file but then have the time and date of their creation appended to the name. This ensures that a unique folder is created each time and that no log file data can be overwritten.
Window 25.10 Page Directory The Page Directory offers a means of switching between pages within K2. Its operation is very similar to the other directory windows with a Button and Sheet view. Number (Sheet View) The Number column shows the number of each Page, the numbers can be edited by double-clicking on the cell or selecting it and hitting Insert.
The Safe button turns off all the Playback Controls as well as disabling the Output button in the Programmer. It is not possible to initiate movement in Safe mode. If a K2 Wing is connected then this also has all its buttons disabled. To return the system to an active state press the Safe button again.
Page 100
To clear the Programmer and reset all the Constructs back to their current positions click on the Clear button Calc Cue Limits K2 will work out the shortest and longest cue times for the specified movement. Try Cue To test the movement of all the programmed actions without moving the physical...
Page 101
Window Constructs click on Try Cue. This forces K2 to run an instant simulation of the movement of all the programmed actions and to feedback whether any errors will occur during the movement. E.g. whether the programmed movement will cause any of the Channels to exceed their programmed speeds or position limits.
DMH icon is illuminated constantly the dead man’s handle must be pressed to continue motion. Alarms If K2 detects any alarm, either internally generated or reported back from the external controllers then the Alarm icon will illuminate. Emergency Stop If the emergency stop has been pressed and the controllers are reporting back this state then the Emergency Stop icon will illuminate.
Toolbar Toolbar The following section takes you through all of the windows and menus available from the toolbar at the top of the K2 application window. The top level menu consists of the follow menu options File Operations Show Setup...
K2 software. Save Show Allows you to manually save a show. All K2 show files are saved in a .k2s (K2 Show) file format. Save Copy This feature opens a File Explorer window with a file name for the show set as Copy_of_ShowName.k2s allowing you to save off a copy of the show (useful for taking...
Page 107
K2 show file or loading that show on to another machine and use the .k2s file then K2 will not be able to find any of the 3D objects you may be using. Any K2 show files sent to Kinesys for advice or further consultation need to be sent as a .k2z bundle file.
If a personality file for a Channel type has been updated since the show was first created clicking on Reload Motor or Reload All Motors will force K2 to overwrite its internal copy of the motor details with the new one taken from the personality file. This will not update...
K2 use the Change button to select which interface to use. K2 will then display the IP address details relating to that interface. If you need to change the IP address you need to do that via the Windows Network Settings area.
Page 110
Multicast K2 outputs positional information via a multicast network protocol, allowing media servers (or any other appliance that reads multicast positioning information) to be aware of the positions of objects as they are moved.
Putting the K2 system into Offline Mode blocks all motion commands being sent out on to the network and as a result to the machines. When in Offline Mode K2 prominently displays OFFLINE underneath the Kinesys logo and also in the status bar at the bottom of the screen.
The Channels window displays all the data available relating to each of the Channels. The ‘Position’ column displays the internal K2 position for each Channel. ‘Actual’ displays the position being fed back from the external controllers and these two values should match if all is well.
Page 114
Lookup Tables K2 uses Lookup Tables when there is a particular path that you wish a channel to follow and it is too complex, unique or precise to be able to program it via the position of the construct. K2 needs Lookup Tables to be stored in a comma delimited file format (csv) in order to read them in.
Clicking the Move Window button will switch the window that has focus into a number of different positions. Clicking the button repeatedly will cycle through those different positions. Cycle Focus Cycles the focus of K2 between the windows that are open Close All Closes all open widows Minimize Application Minimize's K2 into the Windows task bar.
26.8 Logout Clicking the Logout button will log the current user out of K2. A dialogue box will appear asking to confirm this action. Logging out of K2 will close the show that is currently open, and leave a login window on the screen, logging back in brings up the Launch Show dialogue.
Contact Information Contact Information If you would like to get in touch with Kinesys then please use any of the following methods. Email: info@kinesys.co.uk Website: www.kinesys.co.uk Tel: +44 (0) 20 8481 9850 Fax: +44 (0) 20 8487 0396 Mail: Unit 2 Kempton Gate Business Centre...
27.1 Feedback We are always keen to hear feedback from the users of Kinesys products. If you have a feature request for the software, any comments about the documentation or just want to say hello, please get in touch. In the unlikely event that this product has not performed to the high standards that we work to and our users expect then please let us know as soon as possible.
Need help?
Do you have a question about the K2 and is the answer not in the manual?
Questions and answers