honeybee_radiance_command.options.rpict module

class honeybee_radiance_command.options.rpict.RpictOptions

Bases: OptionCollection

rpict command options.

Also see: https://floyd.lbl.gov/radiance/man_html/rpict.1.html

to_file(folder, file_name, mkdir=False)

Write options to a file.

to_radiance()

Translate options to Radiance format.

update_from_string(string)

Update options from a standard radiance string.

If the option is not currently part of the collection, it will be added to additional_options.

property aE

ambient excluded modifiers file

Same as −ae, except read modifiers to be excluded from file. The RAYPATH environment variable determines which directories are searched for this file. The modifier names are separated by white space in the file.

property aI

ambient included modifiers file

Same as −ai, except read modifiers to be included from file.

property aa

0.200000

Set the ambient accuracy. This value will approximately equal the error from indirect illuminance interpolation. A value of zero implies no interpolation.

Type:

ambient accuracy - default

property ab

0

Set the number of ambient bounces to N. This is the maximum number of diffuse bounces computed by the indirect calculation. A value of zero implies no indirect calculation.

Type:

ambient bounces - default

property ad

512

Set the number of ambient divisions to N. The error in the Monte Carlo calculation of indirect illuminance will be inversely proportional to the square root of this number. A value of zero implies no indirect calculation.

Type:

ambient divisions - default

additional_options

property ae

ambient excluded modifier.

Append mod to the ambient exclude list, so that it will not be considered during the indirect calculation. This is a hack for speeding the indirect computation by ignoring certain objects. Any object having mod as its modifier will get the default ambient level rather than a calculated value. Any number of excluded modifiers may be given, but each must appear in a separate option.

property af

ambient cache file (.amb)

This is where indirect illuminance will be stored and retrieved. Normally, indirect illuminance values are kept in memory and lost when the program finishes or dies. By using a file, different invocations can share illuminance values, saving time in the computation. Also, by creating an ambient file during a low resolution rendering, better results can be obtained in a second high resolution pass. The ambient file is in a machine-independent binary format which may be examined with lookamb.

The ambient file may also be used as a means of communication and data sharing between simultaneously executing processes. The same file may be used by multiple processes, possibly running on different machines and accessing the file via the network (ie. nfs). The network lock manager lockd is used to insure that this information is used consistently.

If any calculation parameters are changed or the scene is modified, the old ambient file should be removed so that the calculation can start over from scratch. For convenience, the original ambient parameters are listed in the header of the ambient file. Getinfo(1) may be used to print out this information.

property ai

ambient included modifier.

Add mod to the ambient include list, so that it will be considered during the indirect calculation. The program can use either an include list or an exclude list, but not both.

property am

0.0

Type:

max photon search radius - default

property ar

64

Set the ambient resolution. This number will determine the maximum density of ambient values used in interpolation. Error will start to increase on surfaces spaced closer than the scene size divided by the ambient resolution. The maximum ambient value density is the scene size times the ambient accuracy (see the −aa option) divided by the ambient resolution. The scene size can be determined using getinfo(1) with the −d option on the input octree. A value of zero is interpreted as unlimited resolution.

Type:

ambient resolution - default

property as_

128

Set the number of ambient super-samples to N. Super-samples are applied only to the ambient divisions which show a significant change.

Type:

ambient super-samples - default

property av

0.000000 0.000000 0.000000

Set the ambient value to a radiance of red grn blu. This is the final value used in place of an indirect light calculation. If the number of ambient bounces is one or greater and the ambient value weight is non-zero (see -aw and -ab), this value may be modified by the computed indirect values to improve overall accuracy.

Type:

ambient value - default

property aw

0

Set the relative weight of the ambient value given with the -av option to N. As new indirect irradiances are computed, they will modify the default ambient value in a moving average, with the specified weight assigned to the initial value given on the command and all other weights set to 1. If a value of 0 is given with this option, then the initial ambient value is never modified. This is the safest value for scenes with large differences in indirect contributions, such as when both indoor and outdoor (daylight) areas are visible.

Type:

ambient value weight - default

property bv

True

Boolean switch for back face visibility. With this switch off, back faces of opaque objects will be invisible to all rays. This is dangerous unless the model was constructed such that all surface normals on opaque objects face outward. Although turning off back face visibility does not save much computation time under most circumstances, it may be useful as a tool for scene debugging, or for seeing through one-sided walls from the outside. This option has no effect on transparent or translucent materials.

Type:

back face visibility - default

property command

Command name.

property dc

0.500000

Set the direct certainty to frac. A value of one guarantees that the absolute accuracy of the direct calculation will be equal to or better than that given in the −dt specification. A value of zero only insures that all shadow lines resulting in a contrast change greater than the −dt specification will be calculated.

Type:

direct certainty - default

property dj

0.000000

Set the direct jittering to frac. A value of zero samples each source at specific sample points (see the −ds option), giving a smoother but somewhat less accurate rendering. A positive value causes rays to be distributed over each source sample according to its size, resulting in more accurate penumbras. This option should never be greater than 1, and may even cause problems (such as speckle) when the value is smaller. A warning about aiming failure will issued if frac is too large. It is usually wise to turn off image sampling when using direct jitter by setting −ps to 1.

Type:

direct jitter - default

property dp

512

Set the secondary source presampling density to D. This is the number of samples per steradian that will be used to determine ahead of time whether or not it is worth following shadow rays through all the reflections and/or transmissions associated with a secondary source path. A value of 0 means that the full secondary source path will always be tested for shadows if it is tested at all.

Type:

direct pretest density - default

property dr

1

Set the number of relays for secondary sources to N. A value of 0 means that secondary sources will be ignored. A value of 1 means that sources will be made into first generation secondary sources; a value of 2 means that first generation secondary sources will also be made into second generation secondary sources, and so on.

Type:

direct relays - default

property ds

0.250000

Set the direct sampling ratio to frac. A light source will be subdivided until the width of each sample area divided by the distance to the illuminated point is below this ratio. This assures accuracy in regions close to large area sources at a slight computational expense. A value of zero turns source subdivision off, sending at most one shadow ray to each light source.

Type:

direct sampling - default

property dt

0.050000

Set the direct threshold to frac. Shadow testing will stop when the potential contribution of at least the next and at most all remaining light source samples is less than this fraction of the accumulated value. (See the −dc option) The remaining light source contributions are approximated statistically. A value of zero means that all light source samples will be tested for shadow.

Type:

direct threshold - default

property dv

True

Boolean switch for light source visibility. With this switch off, sources will be black when viewed directly although they will still participate in the direct calculation. This option may be desirable in conjunction with the −i option so that light sources do not appear in the output.

Type:

direct visibility - default

property i

False

Boolean switch to compute irradiance rather than radiance values. This only affects the final result, substituting a Lambertian surface and multiplying the radiance by pi. Glass and other transparent surfaces are ignored during this stage. Light sources still appear with their original radiance values, though the −dv option (above) may be used to override this.

Type:

irradiance calculation - default

property lr

7

Limit reflections to a maximum of this value, if the value is a positive integer. If the value is zero, then Russian roulette is used for ray termination, and the -lw setting must be positive. If the value is a negative integer, then this sets the upper limit of reflections past which Russian roulette will be used. In scenes with dielectrics and total internal reflection, a setting of 0 (no limit) may cause a stack overflow.

Type:

limit reflection - default

property lw

1.00e-03

Limit the weight of each ray to a minimum of frac. During ray-tracing, a record is kept of the estimated contribution (weight) a ray would have in the image. If this weight is less than the specified minimum and the -lr setting is positive, the ray is not traced. Otherwise, Russian roulette is used to continue rays with a probability equal to the ray weight divided by the given frac.

Type:

limit weight - default

property ma

0.000000 0.000000 0.000000

Set the global medium albedo to the given value between 0 0 0 and 1 1 1. A zero value means that all light not transmitted by the medium is absorbed. A unitary value means that all light not transmitted by the medium is scattered in some new direction. The isotropy of scattering is determined by the -mg option.

Type:

mist scattering albedo - default

property me

0.00e+00 0.00e+00 0.00e+00

Set the global medium extinction coefficient to the indicated color, in units of 1/distance (distance in world coordinates). Light will be scattered or absorbed over distance according to this value. The ratio of scattering to total scattering plus absorption is set by -ma option.

Type:

mist extinction coefficient - default

property mg

0.000000

Set the medium Heyney-Greenstein eccentricity parameter. This parameter determines how strongly scattering favors the forward direction. A value of 0 indicates perfectly isotropic scattering. As this parameter approaches 1, scattering tends to prefer the forward direction.

Type:

mist scattering eccentricity - default

property ms

0.000000

Set the medium sampling distance, in world coordinate units. During source scattering, this will be the average distance between adjacent samples. A value of 0 means that only one sample will be taken per light source within a given scattering volume.

Type:

mist sampling distance - default

property options

Print out list of options.

property pa

1.000000

Set the pixel aspect ratio (height over width). Either the x or the y resolution will be reduced so that the pixels have this ratio for the specified view. If this value is zero, then the x and y resolutions will adhere to the given maxima.

Type:

pixel aspect ratio - default

property pd

0.000000

Set the pixel depth-of-field aperture to a diameter of dia (in world coordinates). This will be used in conjunction with the view focal distance, indicated by the length of the view direction vector given in the −vd option. It is not advisable to use this option in combination with the pdfblur(1) program, since one takes the place of the other. However, it may improve results with pdfblur to use a very small fraction with the −pd option, to avoid the ghosting effect of too few samples.

Type:

pixel depth-of-field - default

property pj

0.670000

Set the pixel sample jitter to frac. Distributed ray-tracing performs anti-aliasing by randomly sampling over pixels. A value of one will randomly distribute samples over full pixels. A value of zero samples pixel centers only. A value between zero and one is usually best for low-resolution images.

Type:

pixel jitter - default

property pm

0.000000

Set the pixel motion blur to frac. In an animated sequence, the exact view will be blurred between the previous view and the next view as though a shutter were open this fraction of a frame time. (See the −S option regarding animated sequences.) The first view will be blurred according to the difference between the initial view set on the command line and the first view taken from the standard input. It is not advisable to use this option in combination with the pmblur(1) program, since one takes the place of the other. However, it may improve results with pmblur to use a very small fraction with the −pm option, to avoid the ghosting effect of too few time samples.

Type:

pixel motion - default

property ps

4

Set the pixel sample spacing to the integer size. This specifies the sample spacing (in pixels) for adaptive subdivision on the image plane.

Type:

pixel sample - default

property pt

0.050000

Set the pixel sample tolerance to frac. If two samples differ by more than this amount, a third sample is taken between them.

Type:

pixel threshold - default

property slots

Return slots including the ones from the baseclass if any.

property ss

1.000000

Set the specular sampling to samp. For values less than 1, this is the degree to which the highlights are sampled for rough specular materials. A value greater than one causes multiple ray samples to be sent to reduce noise at a commmesurate cost. A value of zero means that no jittering will take place, and all reflections will appear sharp even when they should be diffuse. This may be desirable when used in combination with image sampling (see −ps option above) to obtain faster renderings.

Type:

specular sampling - default

property st

0.150000

Set the specular sampling threshold to frac. This is the minimum fraction of reflection or transmission, under which no specular sampling is performed. A value of zero means that highlights will always be sampled by tracing reflected or transmitted rays. A value of one means that specular sampling is never used. Highlights from light sources will always be correct, but reflections from other surfaces will be approximated using an ambient value. A sampling threshold between zero and one offers a compromise between image accuracy and rendering time.

Type:

specular threshold - default

property t

0

Set the time between progress reports to sec. A progress report writes the number of rays traced, the percentage completed, and the CPU usage to the standard error. Reports are given either automatically after the specified interval, or when the process receives a continue (−CONT) signal (see kill(1)). A value of zero turns automatic reporting off.

Type:

time between reports - default

property u

False

Boolean switch to control uncorrelated random sampling. When “off”, a low-discrepancy sequence is used, which reduces variance but can result in a brushed appearance in specular highlights. When “on”, pure Monte Carlo sampling is used in all calculations.

Type:

correlated quasi-Monte Carlo sampling - default

property va

0.000000

Set the view aft clipping plane at a distance of “va” from the view point. Like the view fore plane, it will be perpendicular to the view direction for perspective and parallel view types. For fisheye view types, the clipping plane is actually a clipping sphere, centered on the view point with radius “va”. Objects behind this imaginary surface will not be visible. A value of zero means no aft clipping, and is the only way to see infinitely distant objects such as the sky.

Type:

view aft clipping plane - default

property vd

0.000000 1.000000 0.000000

Set the view direction vector to xd yd zd . The length of this vector indicates the focal distance as needed by the -pd option.

Type:

view direction - default

property vh

45.000000

Set the view horizontal size. For a perspective projection (including fisheye views), this size is the horizontal field of view (in degrees). For a parallel projection, this size is the view width in world coordinates.

Type:

view horizontal size - default

property vl

0.000000

Set the view lift. This is the amount the actual image will be lifted up from the specified view, similar to the -vs option.

Type:

view lift - default

property vo

0.000000

Set the view fore clipping plane at a distance from the view point. The plane will be perpendicular to the view direction for perspective and parallel view types. For fisheye view types, the clipping plane is actually a clipping sphere, centered on the view point with radius “vo”. objects in from of this imaginary surface will not be visible. This may be useful for seeing through walls (to get a longer perspective from an exterior view point.) or for incremental rendering. A value of zero implies no foreground clipping. A negative value produces some interesting effects, since it creates an inverted image for objects behind the viewport. This possibility is provided mostly for the purpose of rendering stereographic holograms.

Type:

view fore clipping plane - default

property vp

0.000000 0.000000 0.000000

Set the view point to x y z . This is the focal point of a perspective view or the center of a parallel projection.

Type:

view point - default

property vs

0.000000

Set value to shift the view. This is the amount the actual image will be shifted to the right of the specified view. This is option is useful for generating skewed perspectives or rendering an image a piece at a time. A value of 1 means that the rendered image starts just to the right of the normal view. A value of −1 would be to the left. Larger or fractional values are permitted as well.

Type:

view shift - default

property vt

vtv

• ‘v’ sets a perspective view.

• ‘l’ sets parallel view.

• ‘c’ sets a cylindrical panaroma. This view is like a standard perspective vertically, but projected on a cylinder horizontally, like a soupcan’s eye-view.

• ‘h’ sets a hemispherical fisheye view. This is a projection of the hemisphere onto a circle. The maximum view angle for this type is 180 degrees.

• ‘a’ sets an angular fisheye view. An angular fisheye view is defined such that distance from the center of the image is proportional to the angle from the central view direction. An angular fisheye can display a full 360 degrees.

• ‘s’ sets a planisphere (stereographic) view. A planisphere fisheye view maintains angular relationships between lines, and is commonly used for sun path analysis. This is more commonly known as a stereographic projection.

Type:

view type perspective - default

property vu

0.000000 0.000000 1.000000

Set the view up vector (vertical direction) to xd yd zd.

Type:

view up - default

property vv

45.000000

Set the view vertical size.

Type:

view vertical size - default

property w

True

Boolean switch for warning messages. The default is to print warnings, so the first appearance of this option turns them off.

Type:

warning messages - default

property x

512

Set the maximum x resolution.

Type:

x resolution - default

property y

512

Set the maximum y resolution.

Type:

y resolution - default