regnpts

 

Generates points in a region previously defined by the region command. The points are generated by shooting rays through a user specified set of points from an origin point, line, or plane and finding the intersection of each ray with the surfaces that define the region.

Format

regnpts / region_name / ptdist / ifirst, ilast, istride / geom / ray_origin / irratio, rrz / maxpenetr

regnpts / region_name / ptdist / pset, get, setname / geom / ray_origin / irratio, rrz / maxpenetr

 

regnpts Parameters

Parameters

Type/Value

Description/Default

region_name

char*32

 

ptdist

 

The point distribution is determined by the data in ptdist.

 

integer

That many points are evenly distributed along the ray in the region. The variables irratio and rrz determine ratio zoning when ptdist is an integer.

 

real

Points are distributed at that distance along the ray, up to a maximum of maxpenetr points along the ray (in addition to any interface points that may be created). note: If the ray encounters a region more than once, multiple sets of points are layed down. Points are distributed on the region ís material interfaces and external boundaries if the region definition includes the interfaces or boundaries -- usually ge or le means that the region includes the interface or boundary.

 

in

inside

out

outside

both

Only surface intersection points are created if ptdist is inside, in, out, outside, or both. In this case, surface points are created regardless of region ownership of the interface or boundary surface -- if a ray encounters a region more than once, the appropriate surface intersection point(s) is generated for each encounter.
If another region intrudes upon the regnpts region so that the regnpts region is divided into more than one piece, points that fall inside the intruding region are not distributed.

ifirst, ilast, istride

integers

Define the set of points to shoot rays through.

 

geom

xyz

Points 1, 2, 3 define the plane to shoot rays from that are normal to the plane.

 

rtz

Points 1, 2 define the line from which to shoot perpendicular rays.

 

rtp

xcen, ycen, and zcen define a point from which to shoot rays.

 

points

2 point sets have the same length and rays are constructed between pairs of elements, one from each point set.

ray_origin

 

 

 

x1, y1, z1 / x2, y2, z2 / x3, y3, z3

Used with xyz geom.

 

x1, y1, z1 / x2, y2, z2

Used with rtz geom.

 

xcen, ycen, zcen

Used with rtp geom.

 

iffirst,iflast,ifstride

Used with points geom.

irratio, rrz

 

If ptdist is an integer, irratio and rrz determine the ratio zoning.

If irratio =1, ratio zoning is on and the point distribution is adjusted so that the ratio between successive pairs of points is rrz

If irratio = 3, ratio zoning is calculated on the longest ray; then this length distribution is applied to all rays.
See the description of the command surface for a discussion of point distributions with respect to sheet surfaces.

maxpenetr

 

If ptdist is a real, it can distribute up to a maximum of maxpenetr points along the ray.

pset get pset_name

 

Define the set of points to shoot rays through. See pset command.

Rules

The points and the plane must lie outside the enclosing volume and on opposite sides.

The normal to the plane must point toward the point.

As rays are created, if they do not pass through the specified region, no points are distributed.

Points may be spaces evenly along the ray or they may be spaced according to a ration.

Specific Geometric Formats

regnpts / region_name / ptdist / ifirst, ilast, istride / xyz / x1, y1, z1 / x2, y2, z2 / x3, y3, z3 / irratio, rrz / maxpenetr

Where points 1, 2, 3 define the plane to shoot rays from that are normal to the plane.

 

regnpts / region_name / ptdist / ifirst, ilast, istride / rtz / x1, y1, z1 / x2, y2, z2 / irratio, rrz

Where points 1, 2, define the line from which to shoot perpendicular rays

 

regnpts / region_name / ptdist / ifirst, ilast, istride / rtp / xcen, ycen, zcen / irratio, rrz / maxpenetr

Where xcen,ycen,zcen define a point from which to shoot rays .

 

regnpts / region name / ptdist / ifirst, ilast, istride / points /iffirst, iflast, ifstride / irratio, rrz / maxpenetr

Where the 2 point sets have the same length and rays are constructed between pairs of elements, one from each point set.

Examples