Orbit Functions Support
The Fractal Science Kit fractal generator Orbit functions provide access to the orbit points within a single orbit.
During the fractal iteration, the Fractal Science Kit maintains the set of points visited during the orbit thus far, called the orbit points. This set of points is available to selected programs; i.e., Fractal Equations, Orbital Equations, Alternate Values, and some Transformations. Programs access the orbit points using the functions:
The semantics of these functions depends on whether you are processing a Mandelbrot fractal or an Orbital fractal.
When accessing a Mandelbrot fractal's orbit points, Orbit.Point(index) is used to access the orbit points. If index > 0, we treat it as a 1-based index that corresponds to the dwell. For example, Orbit.Point(3) is the 3rd orbit point. If index <= 0, we treat index as a relative offset from the current dwell; Orbit.Point(0) is equal to Orbit.Point(dwell), Orbit.Point(-1) is equal to Orbit.Point(dwell-1), Orbit.Point(-2) is equal to Orbit.Point(dwell-2), and so on.
Orbit.Count() is the number of orbit points. During the iteration, Orbit.Count() equals the current dwell and points can be accessed via 0 < index <= Orbit.Count() (absolute) or -Orbit.Count() < index <= 0 (relative).
At the end of the iteration:
Orbit.Z0() is the initial z value for Mandelbrot fractals and the pixel value for Julia fractals.
Orbit.C() is the pixel value for Mandelbrot fractals and the Julia Constant for Julia fractals.
When accessing an Orbital fractal's orbit points, things are a little different. Rather that generating an orbit per pixel as is done for Mandelbrot fractals, Orbital fractals have a single orbit, but the orbit is very long, sometimes numbering in the millions. That being said, we do not maintain the entire collection of orbit points but only the last N points, where N is defined by the Orbit Buffer Size property set on the Orbital / IFS / Strange Attractor page. Orbit.Count() is set to 0 at the beginning of the orbit. During the iteration, Orbit.Count() is incremented until it reaches Orbit Buffer Size, and is unchanged during the remainder of the iteration. The orbit array holds the last Orbit.Count() points in the orbit and orbit points prior to those points are not accessible.
As with Mandelbrot fractals, orbit points are accessed using absolute or relative indexing. However, since the orbit array holds the last Orbit.Count() points in the orbit, the absolute index values are relative to the beginning of the array and are rarely used. Absolute index values range from 0 < index <= Orbit.Count() and relative index values range from -Orbit.Count() < index <= 0.
Orbit.Z0() and Orbit.C() are not applicable for Orbital fractals and simply return 0.
The following is provided for quick reference.
Orbit.Point(dwell) = z
Orbit.Point(0) = z
In both Mandelbrot and Orbital fractals, if the index is outside the valid range, Orbit.Point(index) returns 0.
Copyright © 2004-2016 Hilbert, LLC