.\"
.de Id
..
.de Sp
.if n .sp
.if t .sp 0.4
..
.TH domain_indirect 7rheolef "rheolef-6.5" "rheolef-6.5" "rheolef-6.5"
.\" label: /*Class:domain_indirect
.SH NAME
\fBdomain_indirect\fP - a named part of a finite element mesh
.\" skip: @cindex  mesh boundary
.\" skip: @clindex domain_indirect
.SH DESCRIPTION

The \fBdomain_indirect\fP class defines a container for a part of a
finite element mesh.
This describes the connectivity of edges or faces.
This class is usefull for boundary condition setting.
.SH IMPLEMENTATION NOTE

The \fBdomain\fP class is splitted into two parts.
The first one is the \fBdomain_indirect\fP class, that contains the main
renumbering features: it acts as a indirect on a \fBgeo\fP class(see geo(2)).
The second one is the \fBdomain\fP class, that simply contains two
smart_pointers: one on a \fBdomain_indirect\fP and the second on the
\fBgeo\fP where renumbering is acting.
Thus, the domain class develops a complete \fBgeo\fP-like interface,
via the \fBgeo_abstract_rep\fP pure virtual class derivation,
and can be used by the \fBspace\fP class (see space(2)).
The split between domain_indirect and domain is necessary,
because the \fBgeo\fP class contains a list of domain_indirect.
It cannot contains a list of \fBdomain\fP classes, that refers
to the geo class itself: a loop in reference counting
leads to a blocking situation in the automatic deallocation.
.PP
.\" skip start:DATE:
.\" END
.SH IMPLEMENTATION
.\" begin_example
.Sp
.nf
template <>
class domain_indirect_basic<sequential> : public smart_pointer<domain_indirect_rep<sequential> > {
public:

// typedefs:

    typedef domain_indirect_rep<sequential> rep;
    typedef smart_pointer<rep>        base;
    typedef rep::size_type            size_type;
    typedef rep::iterator_ioige       iterator_ioige;
    typedef rep::const_iterator_ioige const_iterator_ioige;

// allocators:

    domain_indirect_basic ();

    template <class T>
    domain_indirect_basic (
        const geo_basic<T,sequential>&  omega,
        const std::string&              name,
        size_type                       map_dim,
        const communicator&             comm,
        const std::vector<size_type>&   ie_list);

    template <class U>
    domain_indirect_basic (
        array<geo_element_auto<heap_allocator<size_type> >,sequential, heap_allocator<size_type> >&
                                        d_tmp,
        const geo_basic<U, sequential>& omega,
        std::vector<index_set>*         ball);

    void resize (size_type n);

// accessors:

    size_type size()     const;
    size_type dis_size() const;
    const distributor& ownership() const;

    const_iterator_ioige ioige_begin() const;
    const_iterator_ioige ioige_end()   const;
          iterator_ioige ioige_begin();
          iterator_ioige ioige_end();

    const geo_element_indirect& oige (size_type ioige) const;

    void set_name (std::string name);
    void set_map_dimension (size_type map_dim);
    std::string name ()    const;
    size_type map_dimension () const;

// i/o:

    odiststream& put (odiststream&) const;
    template <class T>
    idiststream& get (idiststream& ips, const geo_rep<T,sequential>& omega, std::vector<index_set> *ball);
};
.Sp
.fi
.\" end_example
.SH IMPLEMENTATION
.\" begin_example
.Sp
.nf
template <>
class domain_indirect_basic<distributed> : public smart_pointer<domain_indirect_rep<distributed> > {
public:

// typedefs:

    typedef domain_indirect_rep<distributed>  rep;
    typedef smart_pointer<rep>            base;
    typedef rep::size_type                size_type;

// allocators:

    domain_indirect_basic ();
    template<class T>
    domain_indirect_basic (
        const geo_basic<T,distributed>& omega,
        const std::string&            name,
        size_type                     map_dim,
        const communicator&           comm,
        const std::vector<size_type>& ie_list);

// accessors/modifiers:

    size_type size()     const;
    size_type dis_size() const;
    const distributor& ownership() const;

    const geo_element_indirect& oige (size_type ioige) const;

    void set_name (std::string name);
    void set_map_dimension (size_type map_dim);
    std::string name () const;
    size_type map_dimension () const;

// distributed specific acessors:

    const distributor& ini_ownership() const;
    size_type ioige2ini_dis_ioige (size_type ioige) const;
    size_type ini_ioige2dis_ioige (size_type ini_ioige) const;

// i/o:

    template <class T>
    idiststream& get (idiststream& ips, const geo_rep<T,distributed>& omega);
    template <class T>
    odiststream& put (odiststream& ops, const geo_rep<T,distributed>& omega) const;
};
.Sp
.fi
.\" end_example

.\" LENGTH = 2
.SH SEE ALSO
geo(2), space(2)