Difference between revisions of "Membrane models"

From Dynamo
Jump to navigation Jump to search
Line 10: Line 10:
 
# Extraction of the table points.
 
# Extraction of the table points.
 
The property <tt>center</tt> must have been defined.
 
The property <tt>center</tt> must have been defined.
[[File:.png|thumb|center|300px| User points (plot with method <tt>plotPoints</tt>]]
+
 
 +
{|style="margin: 0 auto;"
 +
| [[File:membraneWorkflowUserPoints.png|thumb|upright|250px| User points]]
 +
| [[File:membraneWorkflowControlPoints.png|thumb|upright|250px| Control points]]
 +
| [[File:membraneWorkflowMesh.png|thumb|upright|250px| Coarse depiction mesh]]
 +
|}
 +
 
 +
{|style="margin: 0 auto;"
 +
| [[File:membraneWorkflowRefinedMesh.png|thumb|upright|250px| Refined depiction mesh]]
 +
| [[File:membraneWorkflowCropMesh.png|thumb|upright|250px| Cropping mesh points]]
 +
| [[File:membraneWorkflowTableSketch.png|thumb|upright|250px| Cropping points and angles]]
 +
|}
 +
 
 
== Control points==
 
== Control points==
 
Control points are equispaced points distributed along all user points defined for a same level (typically ''z''). They are used as vertices for the initial triangulation that will be used to represent the continuous surface. <br>
 
Control points are equispaced points distributed along all user points defined for a same level (typically ''z''). They are used as vertices for the initial triangulation that will be used to represent the continuous surface. <br>
 
The original points need to have been picked in the right order on each z-level.<br>
 
The original points need to have been picked in the right order on each z-level.<br>
 
They are stored in the <tt>crop_points</tt> property of the model.
 
They are stored in the <tt>crop_points</tt> property of the model.
 
{|style="margin: 0 auto;"
 
| [[File:membraneWorkflowUserPoints.png|thumb|upright|300px| Click on anchor 1]]
 
| [[File:membraneWorkflowControlPoints.png|thumb|upright|300px| Click on anchor 2]]
 
| [[File:membraneWorkflowMesh.png|thumb|upright|300px| Click on anchor 2]]
 
|}
 
  
  
 
[[File:membraneWorkflowUserPoints.png|thumb|center|300px| Control points]]
 
  
  
Line 30: Line 34:
 
== Supporting mesh ==
 
== Supporting mesh ==
 
The continuous membrane will be represented by a triangulation, stored in the <tt>mesh</tt> property of the model.
 
The continuous membrane will be represented by a triangulation, stored in the <tt>mesh</tt> property of the model.
[[File:.png|thumb|center|300px| Control points]]
+
 
 +
 
 
== Refining the supporting mesh==
 
== Refining the supporting mesh==
 
Each refinement step subdivides the triangulation stored in the <tt>mesh</tt> property of the model.
 
Each refinement step subdivides the triangulation stored in the <tt>mesh</tt> property of the model.
[[File:.png|thumb|center|300px| Control points]]
+
 
 +
 
 
==  Cropping mesh ==
 
==  Cropping mesh ==
 
A new triangulation (property <tt>crop_mesh</tt>) will be defined on top of the membrane defined in the previous step. The final cropping points will be located in the centers of these triangles. The triangulation procedure will try to create these points on a regular distribution with a given average distance. This average distance is provided in pixels as property <tt>crop_mesh_parameter</tt>  
 
A new triangulation (property <tt>crop_mesh</tt>) will be defined on top of the membrane defined in the previous step. The final cropping points will be located in the centers of these triangles. The triangulation procedure will try to create these points on a regular distribution with a given average distance. This average distance is provided in pixels as property <tt>crop_mesh_parameter</tt>  
Line 39: Line 45:
 
# Refine the supporting triangulation one (or more)  step(s) further, or
 
# Refine the supporting triangulation one (or more)  step(s) further, or
 
# Provide a smaller value for <tt>crop_mesh_parameter</tt>
 
# Provide a smaller value for <tt>crop_mesh_parameter</tt>
[[File:.png|thumb|center|300px| Control points]]
+
 
 +
 
 
==  Table points ==
 
==  Table points ==
 
This is merely a formatting step. In this point is crucial that the <tt>center</tt> property in the model has been already defined.
 
This is merely a formatting step. In this point is crucial that the <tt>center</tt> property in the model has been already defined.
[[File:.png|thumb|center|300px| Control points]]
+
 
  
 
= Command line =
 
= Command line =

Revision as of 17:56, 1 February 2017

The input of a membrane model is a set of points defined typically in several z-slices of a tomogram. Through the workflow specific for this model geometry, Dynamo will create a smooth continuous surface that represents the membrane. The output is a set of crop points and orientations. Each orientation will point in the direction of the outwards normal. The membrane model needs to have a center defined, which is merely used to defined the laterality of the surface (which side is "inward" and which side is "outward" )

Workflow description

The procedural steps after the input of the user points are the same both from the GUI and the command line:

  1. Creation of control points.
  2. Creation of a supporting mesh.
  3. Refinement of the supporting mesh.
  4. Creation of the cropping mesh.
  5. Extraction of the table points.

The property center must have been defined.

User points
Control points
Coarse depiction mesh
Refined depiction mesh
Cropping mesh points
Cropping points and angles

Control points

Control points are equispaced points distributed along all user points defined for a same level (typically z). They are used as vertices for the initial triangulation that will be used to represent the continuous surface.
The original points need to have been picked in the right order on each z-level.
They are stored in the crop_points property of the model.



Supporting mesh

The continuous membrane will be represented by a triangulation, stored in the mesh property of the model.


Refining the supporting mesh

Each refinement step subdivides the triangulation stored in the mesh property of the model.


Cropping mesh

A new triangulation (property crop_mesh) will be defined on top of the membrane defined in the previous step. The final cropping points will be located in the centers of these triangles. The triangulation procedure will try to create these points on a regular distribution with a given average distance. This average distance is provided in pixels as property crop_mesh_parameter A failure to create a cropping mesh normally indicates that the supporting surface (in 'mesh') is too coarse for the expected distance between the particles. You have thus two options:

  1. Refine the supporting triangulation one (or more) step(s) further, or
  2. Provide a smaller value for crop_mesh_parameter


Table points

This is merely a formatting step. In this point is crucial that the center property in the model has been already defined.


Command line

The methods that represent the steps are:

  • createControl
  • createMesh
  • refineMesh
  • createCropMesh
    whose main parameter is crop_mesh_parameter
  • updateCrop

An example can be found in Example of membrane model workflow through the command line