s_curl(3rheolef) [debian man page]

s_curl(3rheolef)						    rheolef-6.1 						  s_curl(3rheolef)

NAME

       s_curl -- curl-like operator for the Stokes stream function computation

SYNOPSIS

	     form(const space M, const space& V, "s_curl");

DESCRIPTION

       Assembly the form associated to the s_curl operator on a finite element space V:

		       /
		       |
	     b(xi,u) = |  u.s_curl(xi) dx
		       |
		       / Omega

       The  M  and  V  space  may be a either P1 or P2 finite element space.  The M space is scalar-valued while the V is vector-valued.  See also
       form(2) and space(2).

       For cartesian coordinate systems, this form coincide with the usual "curl" one (see curl(3)).  In the axisymmetric case:

		       /
		       | (d xi	    d xi   )
	     b(xi,u) = | (---- ur - ---- uz) r dr dz
		       | (d z	    d r    )
		       / Omega

       The b form is denoted as "s_curl", for Stokes stream function computation (see s_grad_grad(3)) as it is closely related to the "curl" oper-
       ator (see curl(3)), but differs by the r and 1/r factors, as:

			  (	  d (r xi)     d xi )
	       curl(xi) = ( (1/r) -------- ; - -----)
			  (	    d r        d z  )

       while

			  ( d xi       d xi )
	     s_curl(xi) = ( ----  ;  - ---- )
			  ( d r        d z  )

       Notice  also that the differentiation is performed on the xi variable here: b(xi,u)=(s_curl(xi),u) while the "curl" form brings the differ-
       entiation on the u vector-valued variable: (curl(u),xi), i.e. a transpose formulation.

ORIENTATION AND SIGN FIX

       The (r,theta,z) coordinate system has positive orientation, thus (z,r,theta) and (z,r) are positive also.  But (r,z,theta)  and	(r,z)  are
       negative : the sign of s_curl is then inverted to obtain the same result as if (z,r) was used.

EXAMPLE

       The following piece of code build the form associated to the P1 approximation:

	       geo g("square");
	       space M(g, "P1");
	       space V(g, "P1", "vector");
	       form a(M, V, "s_curl");

SEE ALSO

       form(2), space(2), curl(3), s_grad_grad(3), curl(3)

rheolef-6.1							    rheolef-6.1 						  s_curl(3rheolef)

mass(3rheolef)							    rheolef-6.1 						    mass(3rheolef)

NAME

       mass -- L2 scalar product

SYNOPSIS

	       form(const space& V, const space& V, "mass");
	       form(const space& M, const space& V, "mass");
	       form (const space& V, const space& V, "mass", const domain& gamma);
	       form_diag(const space& V, "mass");

DESCRIPTION

       Assembly the matrix associated to the L2 scalar product of the finite element space V.

			/
			|
	       m(u,v) = | u v dx
			|
			/ Omega

       The V space may be either a P0, P1, P2, bubble, P1d and P1d finite element spaces for building a form see form(2).

       The  use of quadrature formulae is sometime usefull for building diagonal matrix.  These approximate matrix are eay to invert.  This proce-
       dure is available for P0 and P1 approximations.

       Notes that when dealing with discontinuous finite element space, i.e.  P0 and P1d, the corresponding mass matrix is block diagonal, and the
       inv_mass form may be usefull.

       When two different space M and V are supplied, assembly the matrix associated to the projection operator from one finite element space M to
       space V.

			/
			|
	       m(q,v) = | q v dx
			|
			/ Omega

       for all q in M and v in V.

       This form is usefull for instance to convert discontinuous gradient components to a continuous approximation.  The transpose  operator  may
       also be usefull to performs the opposite operation.

       The following $V$ and $M$ space approximation combinations are supported for the mass form: P0-P1, P0-P1d, P1d-P2, P1-P1d and P1-P2.

EXAMPLE

       The following piece of code build the mass matrix associated to the P1 approximation:

	       geo g("square");
	       space V(g, "P1");
	       form m(V, V, "mass");

       The use of lumped mass form write also:

	       form_diag md(V, "mass");

       The following piece of code build the projection form:

	       geo g("square");
	       space V(g, "P1");
	       space M(g, "P0");
	       form m(M, V, "mass");

SCALAR PRODUCT ON THE BOUNDARY

       Assembly  the  matrix  associated to the L2 scalar product related to a boundary domain of a mesh and a specified polynomial approximation.
       These forms are usefull when defining non-homogeneous Neumann or Robin boundary conditions.

       Let W be a space of functions defined on Gamma, a subset of the boundary of the whole domain Omega.

			/
			|
	       m(u,v) = | u v dx
			|
			/ Gamma

       for all u, v in W.  Let V a space of functions defined on Omega and gamma the trace operator from V into W.  For all u in W and v in V:

			 /
			 |
	       mb(u,v) = | u gamma(v) dx
			 |
			 / Gamma

       For all u and v in V:

			 /
			 |
	       ab(u,v) = | gamma(u) gamma(v) dx
			 |
			 / Gamma

EXAMPLE

       The following piece of code build forms for the P1 approximation, assuming that the mesh contains a domain named boundary:

	       geo omega ("square");
	       domain gamma = omega.boundary();
	       space V	(omega, "P1");
	       space W	(omega, gamma, "P1");
	       form  m	(W, W, "mass");
	       form  mb (W, V, "mass");
	       form  ab (V, V, "mass", gamma);

SEE ALSO

       form(2)

rheolef-6.1							    rheolef-6.1 						    mass(3rheolef)