3.13.6 Flow

Method on mglGraph (C++, Python): void Flow (const mglData &x, const mglData &y, const mglData &ax, const mglData &ay, const char *sch="", int num=5, bool central=true, float zVal=NAN)

C function: void mgl_flow_xy (HMGL gr, const HMDT x, const HMDT y, const HMDT ax, const HMDT ay, const char *sch, int num, int central, float zVal)

The function draws flow threads for the plane vector field {ax, ay} parametrically depending on coordinates x, y at level z = zVal. Number of threads is proportional to num. Parameter central sets the thread start from center (if true) or only from edges (if false). From v.1.11 it is ignored and always equal to (num>0). The color of lines is proportional to \sqrtax^2+ay^2. Warm color corresponds to normal flow (like attractor). Cold one corresponds to inverse flow (like source). String sch sets the color scheme. Previous color scheme is used by default. The size of ax and ay must be equal. The minor dimensions of arrays x, y and ax must be equal too. Arrays x and y can be vectors (not matrices as ax). The vector field is plotted for each z slice of ax, ay. See also Pipe, VectC, Vect. See section Flow sample, for sample code and picture.

Method on mglGraph (C++, Python): void Flow (const mglData &ax, const mglData &ay, const char *sch="", int num=5, bool central=true, float zVal=NAN)

C function: void mgl_flow_2d (HMGL gr, const HMDT ax, const HMDT ay, const char *sch, int num, int central, float zVal)

The same as previous with x, y equidistantly distributed in interval [Min, Max].

Method on mglGraph (C++, Python): void Flow (const mglData &x, const mglData &y, const mglData &z, const mglData &ax, const mglData &ay, const mglData &az, const char *sch="", int num=3, bool central=true)

C function: void mgl_flow_xyz (HMGL gr, const HMDT x, const HMDT y, const HMDT z, const HMDT ax, const HMDT ay, const HMDT az, const char *sch, int num, int central)

This is 3D version of the first functions. Here arrays ax, ay, az must be 3-ranged tensors with equal sizes and the color of line is proportional to \sqrtax^2+ay^2+az^2. See section Flow 3D sample, for sample code and picture.

Method on mglGraph (C++, Python): void Flow (const mglData &ax, const mglData &ay, const mglData &az, const char *sch="", int num=3, bool central=true)

C function: void mgl_flow_3d (HMGL gr, const HMDT ax, const HMDT ay, const HMDT az, const char *sch, int num, int central)

The same as previous with x, y equidistantly distributed in interval [Min, Max].