esys.modellib.geometry Package — esys.escript 5.6 documentation

# esys.modellib.geometry Package

## Classes

- `ConstrainerAtBoxVertex`
- `ConstrainerOverBox`
- `DomainReader`
- `FinleyReader`
- `RectangularDomain`
- `ScalarConstrainerAtBoxVertex`
- `ScalarConstrainerOverBox`
- `UpdateGeometry`
- `VectorConstrainerAtBoxVertex`
- `VectorConstrainerOverBox`

class `esys.modellib.geometry.` `ConstrainerAtBoxVertex`(**kwargs)

  Bases: `esys.escriptcore.modelframe.Model`

  Creates a characteristic function for the location of constraints for all components of a value and selects the value from an initial value ate these locations.

  In the case that the spatial dimension is two, the arguments front and back are ignored.

  Note: | Instance variable domain
  Note: | Instance variable tol - absolute tolerance for “x=left, front, bottom vertex” condition, default 1.e-8 (in).

  `__init__`(**kwargs)

    Creates a model.

    Just calls the parent constructor.

  `UNDEF_DT` = 1e+300
  `checkLinkTargets`(models, hash)

    Returns a set of tuples (“<self>(<name>)”, <target model>) if the parameter <name> is linked to model <target model> but <target model> is not in the list of models. If a parameter is linked to another parameter set which is not in the hash list the parameter set is checked for its models. hash gives the call history.

  `declareParameter`(**parameters)

    Declares one or more new parameters and their initial value.

  `declareParameters`(parameters)

    Declares a set of parameters. parameters can be a list, a dictionary or a ParameterSet.

  `doFinalization`()

    Finalizes the time stepping.

    This function may be overwritten.

  `doInitialPostprocessing`()

    Finalises the initialization iteration process. This method is not called in case of a restart.

    This function may be overwritten.

  `doInitialStep`()

    Performs an iteration step in the initialization phase. This method is not called in case of a restart.

    This function may be overwritten.

  `doInitialization`()

    Initializes the time stepping scheme. This method is not called in case of a restart.

    This function may be overwritten.

  `doStep`(dt)

    Executes an iteration step at a time step.

    `dt` is the currently used time step size.

    This function may be overwritten.

  `doStepPostprocessing`(dt)

    Finalises the time step.

    dt is the currently used time step size.

    This function may be overwritten.

  `doStepPreprocessing`(dt)

    Sets up a time step of step size dt.

    This function may be overwritten.

  `finalize`()

    Returns False if the time stepping is finalized.

    This function may be overwritten.

  classmethod `fromDom`(esysxml, node)
  `getAttributeObject`(name)

    Returns the object stored for attribute `name`.

  `getSafeTimeStepSize`(dt)

    Returns a time step size which can be safely used.

    `dt` gives the previously used step size.

    This function may be overwritten.

  `hasAttribute`(name)

    Returns True if self has attribute `name`.

  `location_of_constraint`()

    return the values used to constrain a solution

    Returns: | the mask marking the locations of the constraints
    Return type: | `escript.Scalar`

  `releaseParameters`(name)

    Removes parameter name from the parameters.

  `setUp`()

    Sets up the model.

    This function may be overwritten.

  `showParameters`()

    Returns a description of the parameters.

  `terminateInitialIteration`()

    Returns True if iteration at the inital phase is terminated.

  `terminateIteration`()

    Returns True if iteration on a time step is terminated.

  `toDom`(esysxml, node)

    `toDom` method of Model class.

  `trace`(msg)

    If debugging is on, prints the message, otherwise does nothing.

  `value_of_constraint`()

    return the values used to constrain a solution

    Returns: | values to be used at the locations of the constraints. If `value` is not given `None` is rerturned.
    Return type: | `escript.Scalar`

  `writeXML`(ostream=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='UTF-8'>)

    Writes the object as an XML object into an output stream.

class `esys.modellib.geometry.` `ConstrainerOverBox`(**kwargs)

  Bases: `esys.escriptcore.modelframe.Model`

  Creates a characteristic function for the location of constraints for all components of a value and selects the value from an initial value ate these locations.

  In the case that the spatial dimension is two, the arguments front and back are ignored.

  Note: | Instance variable - domain (in).
  Note: | Instance variable left - True to set a constraint at the left face of the domain (x[0]=min x[0]), default False (in).
  Note: | Instance variable right - True to set a constraint at the left face of the domain (x[0]=max x[0]), default False (in).
  Note: | Instance variable top - True to set a constraint at the left face of the domain (x[1]=min x[1]), default False (in).
  Note: | Instance variable bottom - True to set a constraint at the left face of the domain (x[1]=max x[1]), default False (in).
  Note: | Instance variable front - True to set a constraint at the left face of the domain (x[2]=min x[2]), default False (in).
  Note: | Instance variable back - True to set a constraint at the left face of the domain (x[2]=max x[2]), default False (in).
  Note: | Instance variable tol - absolute tolerance for “x=max x” condition, default 1.e-8 (in).

  `__init__`(**kwargs)

    Creates a model.

    Just calls the parent constructor.

  `UNDEF_DT` = 1e+300
  `checkLinkTargets`(models, hash)

    Returns a set of tuples (“<self>(<name>)”, <target model>) if the parameter <name> is linked to model <target model> but <target model> is not in the list of models. If a parameter is linked to another parameter set which is not in the hash list the parameter set is checked for its models. hash gives the call history.

  `declareParameter`(**parameters)

    Declares one or more new parameters and their initial value.

  `declareParameters`(parameters)

    Declares a set of parameters. parameters can be a list, a dictionary or a ParameterSet.

  `doFinalization`()

    Finalizes the time stepping.

    This function may be overwritten.

  `doInitialPostprocessing`()

    Finalises the initialization iteration process. This method is not called in case of a restart.

    This function may be overwritten.

  `doInitialStep`()

    Performs an iteration step in the initialization phase. This method is not called in case of a restart.

    This function may be overwritten.

  `doInitialization`()

    Initializes the time stepping scheme. This method is not called in case of a restart.

    This function may be overwritten.

  `doStep`(dt)

    Executes an iteration step at a time step.

    `dt` is the currently used time step size.

    This function may be overwritten.

  `doStepPostprocessing`(dt)

    Finalises the time step.

    dt is the currently used time step size.

    This function may be overwritten.

  `doStepPreprocessing`(dt)

    Sets up a time step of step size dt.

    This function may be overwritten.

  `finalize`()

    Returns False if the time stepping is finalized.

    This function may be overwritten.

  classmethod `fromDom`(esysxml, node)
  `getAttributeObject`(name)

    Returns the object stored for attribute `name`.

  `getSafeTimeStepSize`(dt)

    Returns a time step size which can be safely used.

    `dt` gives the previously used step size.

    This function may be overwritten.

  `hasAttribute`(name)

    Returns True if self has attribute `name`.

  `location_of_constraint`()

    return the values used to constrain a solution

    Returns: | the mask marking the locations of the constraints
    Return type: | `escript.Scalar`

  `releaseParameters`(name)

    Removes parameter name from the parameters.

  `setUp`()

    Sets up the model.

    This function may be overwritten.

  `showParameters`()

    Returns a description of the parameters.

  `terminateInitialIteration`()

    Returns True if iteration at the inital phase is terminated.

  `terminateIteration`()

    Returns True if iteration on a time step is terminated.

  `toDom`(esysxml, node)

    `toDom` method of Model class.

  `trace`(msg)

    If debugging is on, prints the message, otherwise does nothing.

  `value_of_constraint`()

    return the values used to constrain a solution

    Returns: | values to be used at the locations of the constraints. If `value` is not given `None` is rerturned.
    Return type: | `escript.Scalar`

  `writeXML`(ostream=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='UTF-8'>)

    Writes the object as an XML object into an output stream.

class `esys.modellib.geometry.` `DomainReader`(domainmodule=None, **kwargs)

  Bases: `esys.escriptcore.modelframe.ParameterSet`

  `__init__`(domainmodule=None, **kwargs)

    initializes the object

  `checkLinkTargets`(models, hash)

    Returns a set of tuples (“<self>(<name>)”, <target model>) if the parameter <name> is linked to model <target model> but <target model> is not in the list of models. If a parameter is linked to another parameter set which is not in the hash list the parameter set is checked for its models. hash gives the call history.

  `declareParameter`(**parameters)

    Declares one or more new parameters and their initial value.

  `declareParameters`(parameters)

    Declares a set of parameters. parameters can be a list, a dictionary or a ParameterSet.

  `domain`()

    returns the domain

    Returns: | the domain
    Return type: | `Domain`

  classmethod `fromDom`(esysxml, node)
  `getAttributeObject`(name)

    Returns the object stored for attribute `name`.

  `hasAttribute`(name)

    Returns True if self has attribute `name`.

  `releaseParameters`(name)

    Removes parameter name from the parameters.

  `showParameters`()

    Returns a description of the parameters.

  `toDom`(esysxml, node)

    `toDom` method of Model class.

  `trace`(msg)

    If debugging is on, prints the message, otherwise does nothing.

  `writeXML`(ostream=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='UTF-8'>)

    Writes the object as an XML object into an output stream.

class `esys.modellib.geometry.` `FinleyReader`(**kw)

  Bases: `esys.modellib.geometry.DomainReader`

  `__init__`(**kw)

    initializes the object

  `checkLinkTargets`(models, hash)

    Returns a set of tuples (“<self>(<name>)”, <target model>) if the parameter <name> is linked to model <target model> but <target model> is not in the list of models. If a parameter is linked to another parameter set which is not in the hash list the parameter set is checked for its models. hash gives the call history.

  `declareParameter`(**parameters)

    Declares one or more new parameters and their initial value.

  `declareParameters`(parameters)

    Declares a set of parameters. parameters can be a list, a dictionary or a ParameterSet.

  `domain`()

    returns the domain

    Returns: | the domain
    Return type: | `Domain`

  classmethod `fromDom`(esysxml, node)
  `getAttributeObject`(name)

    Returns the object stored for attribute `name`.

  `hasAttribute`(name)

    Returns True if self has attribute `name`.

  `releaseParameters`(name)

    Removes parameter name from the parameters.

  `showParameters`()

    Returns a description of the parameters.

  `toDom`(esysxml, node)

    `toDom` method of Model class.

  `trace`(msg)

    If debugging is on, prints the message, otherwise does nothing.

  `writeXML`(ostream=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='UTF-8'>)

    Writes the object as an XML object into an output stream.

class `esys.modellib.geometry.` `RectangularDomain`(domainmodule=None, **kwargs)

  Bases: `esys.escriptcore.modelframe.ParameterSet`

  Generates a mesh over a rectangular domain.

  Variables: | dim – spatial dimension, default =2 (in). l – spatial lengths, default [1.,1.,1.] (in). n – number of elements, default [10,10,10] (in). order – element order, default 1 (in). periodic – flags for periodicity, default [False,False,False] (in). intergrationOrder – integration order, default -1 (in).

  `__init__`(domainmodule=None, **kwargs)

    initializes the object

  `checkLinkTargets`(models, hash)

    Returns a set of tuples (“<self>(<name>)”, <target model>) if the parameter <name> is linked to model <target model> but <target model> is not in the list of models. If a parameter is linked to another parameter set which is not in the hash list the parameter set is checked for its models. hash gives the call history.

  `declareParameter`(**parameters)

    Declares one or more new parameters and their initial value.

  `declareParameters`(parameters)

    Declares a set of parameters. parameters can be a list, a dictionary or a ParameterSet.

  `domain`()

    returns the domain

    Returns: | the domain
    Return type: | `Domain`

  classmethod `fromDom`(esysxml, node)
  `getAttributeObject`(name)

    Returns the object stored for attribute `name`.

  `hasAttribute`(name)

    Returns True if self has attribute `name`.

  `releaseParameters`(name)

    Removes parameter name from the parameters.

  `showParameters`()

    Returns a description of the parameters.

  `toDom`(esysxml, node)

    `toDom` method of Model class.

  `trace`(msg)

    If debugging is on, prints the message, otherwise does nothing.

  `writeXML`(ostream=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='UTF-8'>)

    Writes the object as an XML object into an output stream.

class `esys.modellib.geometry.` `ScalarConstrainerAtBoxVertex`(**kwargs)

  Bases: `esys.escriptcore.modelframe.Model`

  Creates a characteristic function for the location of constraints for a scalar value and selects the value from an initial value ate these locations.

  In the case that the spatial dimension is two, the arguments front and back are ignored.

  Note: | Instance variable domain
  Note: | Instance variable tol - absolute tolerance for “x=left, front, bottom vertex” condition, default 1.e-8 (in).

  `__init__`(**kwargs)

    Creates a model.

    Just calls the parent constructor.

  `UNDEF_DT` = 1e+300
  `checkLinkTargets`(models, hash)

    Returns a set of tuples (“<self>(<name>)”, <target model>) if the parameter <name> is linked to model <target model> but <target model> is not in the list of models. If a parameter is linked to another parameter set which is not in the hash list the parameter set is checked for its models. hash gives the call history.

  `declareParameter`(**parameters)

    Declares one or more new parameters and their initial value.

  `declareParameters`(parameters)

    Declares a set of parameters. parameters can be a list, a dictionary or a ParameterSet.

  `doFinalization`()

    Finalizes the time stepping.

    This function may be overwritten.

  `doInitialPostprocessing`()

    Finalises the initialization iteration process. This method is not called in case of a restart.

    This function may be overwritten.

  `doInitialStep`()

    Performs an iteration step in the initialization phase. This method is not called in case of a restart.

    This function may be overwritten.

  `doInitialization`()

    Initializes the time stepping scheme. This method is not called in case of a restart.

    This function may be overwritten.

  `doStep`(dt)

    Executes an iteration step at a time step.

    `dt` is the currently used time step size.

    This function may be overwritten.

  `doStepPostprocessing`(dt)

    Finalises the time step.

    dt is the currently used time step size.

    This function may be overwritten.

  `doStepPreprocessing`(dt)

    Sets up a time step of step size dt.

    This function may be overwritten.

  `finalize`()

    Returns False if the time stepping is finalized.

    This function may be overwritten.

  classmethod `fromDom`(esysxml, node)
  `getAttributeObject`(name)

    Returns the object stored for attribute `name`.

  `getSafeTimeStepSize`(dt)

    Returns a time step size which can be safely used.

    `dt` gives the previously used step size.

    This function may be overwritten.

  `hasAttribute`(name)

    Returns True if self has attribute `name`.

  `location_of_constraint`()

    return the values used to constrain a solution

    Returns: | the mask marking the locations of the constraints
    Return type: | `escript.Scalar`

  `releaseParameters`(name)

    Removes parameter name from the parameters.

  `setUp`()

    Sets up the model.

    This function may be overwritten.

  `showParameters`()

    Returns a description of the parameters.

  `terminateInitialIteration`()

    Returns True if iteration at the inital phase is terminated.

  `terminateIteration`()

    Returns True if iteration on a time step is terminated.

  `toDom`(esysxml, node)

    `toDom` method of Model class.

  `trace`(msg)

    If debugging is on, prints the message, otherwise does nothing.

  `value_of_constraint`()

    return the values used to constrain a solution

    Returns: | values to be used at the locations of the constraints. If `value` is not given `None` is rerturned.
    Return type: | `escript.Scalar`

  `writeXML`(ostream=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='UTF-8'>)

    Writes the object as an XML object into an output stream.

class `esys.modellib.geometry.` `ScalarConstrainerOverBox`(**kwargs)

  Bases: `esys.escriptcore.modelframe.Model`

  Creates a characteristic function for the location of constraints for a scalar value and selects the value from an initial value ate these locations.

  In the case that the spatial dimension is two, the arguments front and back are ignored.

  Note: | Instance variable domain - domain (in).
  Note: | Instance variable left - True to set a constraint at the left face of the domain (x[0]=min x[0]), default False (in).
  Note: | Instance variable right - True to set a constraint at the left face of the domain (x[0]=max x[0]), default False (in).
  Note: | Instance variable top - True to set a constraint at the left face of the domain (x[1]=min x[1]), default False (in).
  Note: | Instance variable bottom - True to set a constraint at the left face of the domain (x[1]=max x[1]), default False (in).
  Note: | Instance variable front - True to set a constraint at the left face of the domain (x[2]=min x[2]), default False (in).
  Note: | Instance variable back - True to set a constraint at the left face of the domain (x[2]=max x[2]), default False (in).
  Note: | Instance variable tol - absolute tolerance for “x=max x” condition, default 1.e-8 (in).

  `__init__`(**kwargs)

    Creates a model.

    Just calls the parent constructor.

  `UNDEF_DT` = 1e+300
  `checkLinkTargets`(models, hash)

    Returns a set of tuples (“<self>(<name>)”, <target model>) if the parameter <name> is linked to model <target model> but <target model> is not in the list of models. If a parameter is linked to another parameter set which is not in the hash list the parameter set is checked for its models. hash gives the call history.

  `declareParameter`(**parameters)

    Declares one or more new parameters and their initial value.

  `declareParameters`(parameters)

    Declares a set of parameters. parameters can be a list, a dictionary or a ParameterSet.

  `doFinalization`()

    Finalizes the time stepping.

    This function may be overwritten.

  `doInitialPostprocessing`()

    Finalises the initialization iteration process. This method is not called in case of a restart.

    This function may be overwritten.

  `doInitialStep`()

    Performs an iteration step in the initialization phase. This method is not called in case of a restart.

    This function may be overwritten.

  `doInitialization`()

    Initializes the time stepping scheme. This method is not called in case of a restart.

    This function may be overwritten.

  `doStep`(dt)

    Executes an iteration step at a time step.

    `dt` is the currently used time step size.

    This function may be overwritten.

  `doStepPostprocessing`(dt)

    Finalises the time step.

    dt is the currently used time step size.

    This function may be overwritten.

  `doStepPreprocessing`(dt)

    Sets up a time step of step size dt.

    This function may be overwritten.

  `finalize`()

    Returns False if the time stepping is finalized.

    This function may be overwritten.

  classmethod `fromDom`(esysxml, node)
  `getAttributeObject`(name)

    Returns the object stored for attribute `name`.

  `getSafeTimeStepSize`(dt)

    Returns a time step size which can be safely used.

    `dt` gives the previously used step size.

    This function may be overwritten.

  `hasAttribute`(name)

    Returns True if self has attribute `name`.

  `location_of_constraint`()

    return the values used to constrain a solution

    Returns: | the mask marking the locations of the constraints
    Return type: | `escript.Scalar`

  `releaseParameters`(name)

    Removes parameter name from the parameters.

  `setUp`()

    Sets up the model.

    This function may be overwritten.

  `showParameters`()

    Returns a description of the parameters.

  `terminateInitialIteration`()

    Returns True if iteration at the inital phase is terminated.

  `terminateIteration`()

    Returns True if iteration on a time step is terminated.

  `toDom`(esysxml, node)

    `toDom` method of Model class.

  `trace`(msg)

    If debugging is on, prints the message, otherwise does nothing.

  `value_of_constraint`()

    return the values used to constrain a solution

    Returns: | values to be used at the locations of the constraints. If `value` is not given `None` is rerturned.
    Return type: | `escript.Scalar`

  `writeXML`(ostream=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='UTF-8'>)

    Writes the object as an XML object into an output stream.

class `esys.modellib.geometry.` `UpdateGeometry`(**kwargs)

  Bases: `esys.escriptcore.modelframe.Model`

  applies a displacement field to a domain

  Note: | Instance variable displacement - displacements applied to the original mesh coordinates (in).
  Note: | Instance variable displacement - `escript.Vector`
  Note: | Instance variable domain - domain
  Note: | Instance variable domain - `escript.Domain`

  `__init__`(**kwargs)

    set-up the object

  `UNDEF_DT` = 1e+300
  `checkLinkTargets`(models, hash)

    Returns a set of tuples (“<self>(<name>)”, <target model>) if the parameter <name> is linked to model <target model> but <target model> is not in the list of models. If a parameter is linked to another parameter set which is not in the hash list the parameter set is checked for its models. hash gives the call history.

  `declareParameter`(**parameters)

    Declares one or more new parameters and their initial value.

  `declareParameters`(parameters)

    Declares a set of parameters. parameters can be a list, a dictionary or a ParameterSet.

  `doFinalization`()

    Finalizes the time stepping.

    This function may be overwritten.

  `doInitialPostprocessing`()

    Finalises the initialization iteration process. This method is not called in case of a restart.

    This function may be overwritten.

  `doInitialStep`()

    Performs an iteration step in the initialization phase. This method is not called in case of a restart.

    This function may be overwritten.

  `doInitialization`()

    initialize model

  `doStep`(dt)

    applies the current `displacement` to mesh nodes.

  `doStepPostprocessing`(dt)

    marks nodes as beeing updated.

  `doStepPreprocessing`(dt)

    applies the current `displacement` to mesh nodes if required.

  `finalize`()

    Returns False if the time stepping is finalized.

    This function may be overwritten.

  classmethod `fromDom`(esysxml, node)
  `getAttributeObject`(name)

    Returns the object stored for attribute `name`.

  `getSafeTimeStepSize`(dt)

    Returns a time step size which can be safely used.

    `dt` gives the previously used step size.

    This function may be overwritten.

  `hasAttribute`(name)

    Returns True if self has attribute `name`.

  `releaseParameters`(name)

    Removes parameter name from the parameters.

  `setUp`()

    Sets up the model.

    This function may be overwritten.

  `showParameters`()

    Returns a description of the parameters.

  `terminateInitialIteration`()

    Returns True if iteration at the inital phase is terminated.

  `terminateIteration`()

    Returns True if iteration on a time step is terminated.

  `toDom`(esysxml, node)

    `toDom` method of Model class.

  `trace`(msg)

    If debugging is on, prints the message, otherwise does nothing.

  `writeXML`(ostream=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='UTF-8'>)

    Writes the object as an XML object into an output stream.

class `esys.modellib.geometry.` `VectorConstrainerAtBoxVertex`(**kwargs)

  Bases: `esys.escriptcore.modelframe.Model`

  Creates a characteristic function for the location of constraints vector value. In the case that the spatial dimension is two, the arguments front and back as well as the third component of each argument is ignored.

  Note: | Instance variable domain
  Note: | Instance variable comp_mask - list of three boolean. comp_mask[i]==True sets a constraint for the i-th component at the left, front, bottom vertex, default [False,False,False] (in).
  Note: | Instance variable tol - absolute tolerance for “x=left, front, bottom vertex” condition, default 1.e-8 (in).

  `__init__`(**kwargs)

    Creates a model.

    Just calls the parent constructor.

  `UNDEF_DT` = 1e+300
  `checkLinkTargets`(models, hash)

    Returns a set of tuples (“<self>(<name>)”, <target model>) if the parameter <name> is linked to model <target model> but <target model> is not in the list of models. If a parameter is linked to another parameter set which is not in the hash list the parameter set is checked for its models. hash gives the call history.

  `declareParameter`(**parameters)

    Declares one or more new parameters and their initial value.

  `declareParameters`(parameters)

    Declares a set of parameters. parameters can be a list, a dictionary or a ParameterSet.

  `doFinalization`()

    Finalizes the time stepping.

    This function may be overwritten.

  `doInitialPostprocessing`()

    Finalises the initialization iteration process. This method is not called in case of a restart.

    This function may be overwritten.

  `doInitialStep`()

    Performs an iteration step in the initialization phase. This method is not called in case of a restart.

    This function may be overwritten.

  `doInitialization`()

    Initializes the time stepping scheme. This method is not called in case of a restart.

    This function may be overwritten.

  `doStep`(dt)

    Executes an iteration step at a time step.

    `dt` is the currently used time step size.

    This function may be overwritten.

  `doStepPostprocessing`(dt)

    Finalises the time step.

    dt is the currently used time step size.

    This function may be overwritten.

  `doStepPreprocessing`(dt)

    Sets up a time step of step size dt.

    This function may be overwritten.

  `finalize`()

    Returns False if the time stepping is finalized.

    This function may be overwritten.

  classmethod `fromDom`(esysxml, node)
  `getAttributeObject`(name)

    Returns the object stored for attribute `name`.

  `getSafeTimeStepSize`(dt)

    Returns a time step size which can be safely used.

    `dt` gives the previously used step size.

    This function may be overwritten.

  `hasAttribute`(name)

    Returns True if self has attribute `name`.

  `location_of_constraint`()

    return the values used to constrain a solution

    Returns: | the mask marking the locations of the constraints
    Return type: | `escript.Vector`

  `releaseParameters`(name)

    Removes parameter name from the parameters.

  `setUp`()

    Sets up the model.

    This function may be overwritten.

  `showParameters`()

    Returns a description of the parameters.

  `terminateInitialIteration`()

    Returns True if iteration at the inital phase is terminated.

  `terminateIteration`()

    Returns True if iteration on a time step is terminated.

  `toDom`(esysxml, node)

    `toDom` method of Model class.

  `trace`(msg)

    If debugging is on, prints the message, otherwise does nothing.

  `value_of_constraint`()

    return the values used to constrain a solution

    Returns: | values to be used at the locations of the constraints. If `value` is not given `None` is rerturned.
    Return type: | `escript.Vector`

  `writeXML`(ostream=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='UTF-8'>)

    Writes the object as an XML object into an output stream.

class `esys.modellib.geometry.` `VectorConstrainerOverBox`(**kwargs)

  Bases: `esys.escriptcore.modelframe.Model`

  Creates a characteristic function for the location of constraints vector value. In the case that the spatial dimension is two, the arguments front and back as well as the third component of each argument is ignored.

  Note: | Instance variable domain
  Note: | Instance variable left - list of three boolean. left[i]==True sets a constraint for the i-th component at the left face of the domain (x[0]=min x[0]), default [False,False,False] (in).
  Note: | Instance variable right - list of three boolean. left[i]==True sets a constraint for the i-th component at the right face of the domain (x[0]=max x[0]), default [False,False,False] (in).
  Note: | Instance variable top - list of three boolean. left[i]==True sets a constraint for the i-th component at the top face of the domain (x[1]=min x[1]), default [False,False,False] (in).
  Note: | Instance variable bottom - list of three boolean. left[i]==True sets a constraint for the i-th component at the bottom face of the domain (x[1]=min x[1]), default [False,False,False] (in).
  Note: | Instance variable front - list of three boolean. left[i]==True sets a constraint for the i-th component at the front face of the domain (x[2]=min x[2]), default [False,False,False] (in).
  Note: | Instance variable back - list of three boolean. left[i]==True sets a constraint for the i-th component at the back face of the domain (x[2]=max x[2]), default [False,False,False] (in).
  Note: | Instance variable tol - absolute tolerance for “x=max x” condition, default 1.e-8 (in).

  `__init__`(**kwargs)

    Creates a model.

    Just calls the parent constructor.

  `UNDEF_DT` = 1e+300
  `checkLinkTargets`(models, hash)

    Returns a set of tuples (“<self>(<name>)”, <target model>) if the parameter <name> is linked to model <target model> but <target model> is not in the list of models. If a parameter is linked to another parameter set which is not in the hash list the parameter set is checked for its models. hash gives the call history.

  `declareParameter`(**parameters)

    Declares one or more new parameters and their initial value.

  `declareParameters`(parameters)

    Declares a set of parameters. parameters can be a list, a dictionary or a ParameterSet.

  `doFinalization`()

    Finalizes the time stepping.

    This function may be overwritten.

  `doInitialPostprocessing`()

    Finalises the initialization iteration process. This method is not called in case of a restart.

    This function may be overwritten.

  `doInitialStep`()

    Performs an iteration step in the initialization phase. This method is not called in case of a restart.

    This function may be overwritten.

  `doInitialization`()

    Initializes the time stepping scheme. This method is not called in case of a restart.

    This function may be overwritten.

  `doStep`(dt)

    Executes an iteration step at a time step.

    `dt` is the currently used time step size.

    This function may be overwritten.

  `doStepPostprocessing`(dt)

    Finalises the time step.

    dt is the currently used time step size.

    This function may be overwritten.

  `doStepPreprocessing`(dt)

    Sets up a time step of step size dt.

    This function may be overwritten.

  `finalize`()

    Returns False if the time stepping is finalized.

    This function may be overwritten.

  classmethod `fromDom`(esysxml, node)
  `getAttributeObject`(name)

    Returns the object stored for attribute `name`.

  `getSafeTimeStepSize`(dt)

    Returns a time step size which can be safely used.

    `dt` gives the previously used step size.

    This function may be overwritten.

  `hasAttribute`(name)

    Returns True if self has attribute `name`.

  `location_of_constraint`()

    return the values used to constrain a solution

    Returns: | the mask marking the locations of the constraints
    Return type: | `escript.Vector`

  `releaseParameters`(name)

    Removes parameter name from the parameters.

  `setUp`()

    Sets up the model.

    This function may be overwritten.

  `showParameters`()

    Returns a description of the parameters.

  `terminateInitialIteration`()

    Returns True if iteration at the inital phase is terminated.

  `terminateIteration`()

    Returns True if iteration on a time step is terminated.

  `toDom`(esysxml, node)

    `toDom` method of Model class.

  `trace`(msg)

    If debugging is on, prints the message, otherwise does nothing.

  `value_of_constraint`()

    return the values used to constrain a solution

    Returns: | values to be used at the locations of the constraints. If `value` is not given `None` is rerturned.
    Return type: | `escript.Vector`

  `writeXML`(ostream=<_io.TextIOWrapper name='<stdout>' mode='w' encoding='UTF-8'>)

    Writes the object as an XML object into an output stream.

## Functions

## Others

## Packages