IWP6 Help

1.1 Introduction 1.2 Quick Start 4. Website Navigation 5. System and Browser Support

2. Animator

This tutorial discusses the various aspects of the animation player and how the user can interact with them to change the animation. The IWP6 animation player consists of two central components:

  • Output panel (left)
  • Input panel (right)
The 'Output' panel features the primary animation, which the user can modify by adjusting the parameters in the input panels. The 'Output' panel includes just one tab, the player. The 'Input' panel includes four tabs, which can be toggled by clicking the panel headers at the top of the input panel: The 'Animate', 'Time', and 'Axes' input panels hold parameters which allow the user to change the behavior of the animation. The 'Graph' tab, on the other hand, is independent of the main animation, but displays additional data which complement the main display.

2.1. Player

Output Display

The output display shows the animated graphs of the primary objects of the animation. The screenshot below shows a snapshot of the animator player for the damped-1.iwp animation. In the top left, the current time of the animation is indicated next to the clock symbol (). The user can interact with the animation using the time functions at the top right:

  • : Step back one frame
  • : Play
  • : Step forward one frame
  • : Reset
The behavior of these buttons is determined by the time parameters in the 'Time' tab. For instance, will continously progress the animation at a pace proportional to the 'Time Step,' stopping once the animation once the current time reaches the 'Stop Time.' / will change the animation by a single time step, and will set the time of the animation back to the 'Start Time.'

2.2. Animate

Animate Panel

The 'Animate' user panel has four components:

  • Title
  • Description
  • Inputs
  • Outputs
The 'Inputs' section contains visible constant parameters of the animation, which the user can adjust to influence the main animation. In damped-1.iwp above, the user can adjust the 'initial position' of the oscillation, the 'mass of the object,' the 'spring constant,' and 'damping coefficient.' The 'Outputs' section shows selected information about the current state of the animation. damped-1.iwp, for instance, shows the undamped and damped frequencies of the current state of the animation. Note: Some animations do not have inputs (or outputs), in which case the 'Input' (or 'Output') section will be absent.

User-accessible parameters (from the 'Input' section, 'Axes' tab, and 'Time' tab) fall into two categories:

  • Initializers: Take effect only once the player has restarted
  • Non-initializers: Take effect immediately, but reset the player when deselected
Initializers include:
  • All 'Axes' settings
  • 'Start Time' and 'Stop Time' in 'Time'
Non-initializers include:
  • 'Time Step' in 'Time'
  • All 'Inputs'
Note: Deselecting any parameter will cause the animation to reset. Suppose, for instance, the user changes the mass of the object in damped-1.iwp while the animation is playing: the animation will continue using the new mass until the user clicks away from the mass input box.

When updating the input parameters of the animation, some changes will only take effect once the player has restarted, whereas others will cause the player to update immediately. Initializers require the player to reset before taking effect, so modifying these parameters will not affect the animation until it has been reset. For damped-1.iwp, 'Initial Position' is an initializer parameter, but the other three parameters are non-initializers. Changing these parameters will immediately affect the animation and cause a noticeable discontinuity in the behavior of the animation.

2.3. Graph

Graph Panel

If appropriate, some animations may have a 'Graph' panel which displays supplementary visual information in addition to the main display. Like the 'Player' tab, the 'Graph' panel updates continuously, showing graphs of certain variables vs time. These variables may include:

  • xPos
  • yPos
  • xVel
  • yVel
  • xAccel
  • yAccel
The user may toggle these variables by clicking on their labels to the right of the graph. As shown in the animation for planetary-system-retrograde.iwp above, when the variable is highlighted, it appears in the 'Graph' section.

2.4. Time

Time Panel

The 'Time' tab holds three parameters:

  • Time Step: time difference between frames
  • Start Time: time of animation upon reset
  • Stop Time: length of animation
These parameters affect how the time functions on the main display ( ) behave (see 'Player'). The time step of the animation determines the accuracy of the animation and the speed of the animation. In the animation above for planetary-system-02.iwp, the large time step causes the animation to show visibly polygonic orbits, instead of the expected circular orbits of a planetary system. Increasing the time step will also increase the speed of the animation proportionally; e.g. a 2x larger time step will play the animation 2x faster.

Note: Typically, the 'Time Step' is only used to control the speed of an animation. For Euler's method animations, however, the 'Time Step' also determines the accuracy of the animation.

The 'Start Time' determines the current time of the animation immediately after a reset, and is usually zero by default. The 'Stop Time', on the other hand, determines when the length of time that the animation will play before stopping.

Note: The 'Stop Time' represents the relative stop time, rather than the absolute stop time.

For instance, an animation with a 'Start Time' of 1 second and a 'Stop Time' of 2 seconds will finish at a Time of 3 seconds, 2 seconds after the 'Start Time'. Once the current time of the animation reaches the 'Stop Time', the animation will automatically pause. It is impossible to progress the animation past the 'Stop Time' without increasing the 'Stop Time'. will immediately repause the animation, and will do nothing.

2.5. Axes

Axes Panel

The 'Axes' tab contains two axes scales: the 'Animation Axes Scale' and the 'Grid Axes Scale.' The 'Animation' scale controls the window of the main animation in the 'Player' tab and the 'Grid' scale controls the window of the graph in the 'Graph' tab. Each scale includes:

  • X Min
  • X Max
  • X Grid: Horizontal between gridlines
  • Y Min
  • Y Max
  • Y Grid: Vertical between gridlines
X and Y values are separated into two columns, as shown in the animation above for cp-efield-02.iwp. For each of the X- and Y-axes, there are three parameters: Min, Max, and Grid. The Min value determines the lowest value visible on the respective axis in the main display, and similarly for the Max value. The Grid parameter represents the spacing between grid lines along each axis. For instance, an X-Grid spacing of .02 will produce vertical lines .02 units apart.