--- ray/doc/notes/ReleaseNotes 2020/03/25 01:51:09 1.365 +++ ray/doc/notes/ReleaseNotes 2025/01/21 01:56:27 1.472 @@ -2237,7 +2237,7 @@ Updates to evalglare and gendaylit from Jan Wienold, i colored sky option. ========================= -Version 5.3 +Version 5.3 (Released September 1, 2020) Created radcompare program to compare Radiance tool output to reference outputs during unit-testing. @@ -2314,8 +2314,7 @@ column vector. Also added ability to apply trailing u Added new depth, normal, and ID file types to radcompare. Added BigEndian= header line for automatic byte-swapping in rmtxop -and radcompare. Doesn't work quite as automatically as it should -for pvalue -r, currently. +and radcompare. Added new "turbo" palette to falsecolor (thanks to Taoning). @@ -2329,7 +2328,7 @@ Added support for loading RGBE images into matrices in Added -y option to gensky and gendaylit to support more accurate Michalsky solar position calculation. -Changed rsplit so specifying a space as the separator parses words +Changed rsplit, so specifying a space as the separator parses words between whitespace. Added ability of vwrays, pinterp, and pmblur2 to read encoded depth files. @@ -2340,7 +2339,9 @@ Made it so number of segments in genworm, genrev, and given as expressions of previously defined variables, etc. Added -D and -n option to gendaymtx to output sun description and skip -matrix output on request. +matrix output on request. A -M option was also added to output solar +modifiers for rcontrib. Support also added for leap days in WEA input. +Enhancements sponsored by Ladybug Tools. Updated eplus_uvf to work with IDF version 9.x, checking version number. @@ -2348,3 +2349,422 @@ Fix to glarendx issues with dgi calculation. Made it so rmtxop and dctimestep undo any exposure applied to Radiance pictures they may load. + +Added robjutil utility to manipulate Wavefront .OBJ files. + +Fixed a crash related to rtrace -om or -oM with mesh instances containing +materials. + +Improved rtrace flushing function to handle any value for -x without +deadlock on controlling process. + +Eliminated unnecessary start-up procedures for rtrace when only ray-casting +is needed (i.e., no tracing or value output). + +Improved isotropic sampling method in bsdf2ttree using "zipper" approach +applied in genBSDF. + +Added limit to memory used by high-resolution tensor tree BSDFs for +cumulative cache during MC sampling (rendering). Limit set to 250MBytes +per BSDF for standard architectures. + +Added -n and -s options to bsdf2ttree to provide some user control +over super-sampling. + +Improved surface normal codec used by ambient file to store orthonormal +directions exactly. + +Improved peak extraction method, which was undervaluing transmission +in many cases. + +New version of evalglare from Jan Wienold. + +Added -u option to gendaymtx to elide data columns (time steps) when +the sun is not visible above the horizon. + +========================= +Version 5.4 + +Added rcollate -c option to force operation to continue even if it +seems unnecessary. Made tool more robust. + +Added -t option to rcontrib (and rfluxmtx) to report progress after the +given number of seconds. + +Added "test" target to makeall to run unit tests. + +Modified bsdf2ttree to allow different parameters per input SIR file. + +Fixed issues with very large matrix files (> 2GB) in dctimestep, rmtxop, +and rcollate. + +Added -rf and -rb options to rmtxop to load front or back reflectance +matrix data from XML file rather than transmission. (Lars Grobe suggested.) + +Improved behavior for coincident surfaces with different materials. +Rather than returning one surface or the other based on floating-point +vagaries, opaque materials are now preferred over transparent ones. +If the materials are both transparent or both opaque, then whichever +surface appeared later in the scene description will be selected. +This came of a request for consistent behavior with legal CAD output +from Peter Apian-Bennewitz. + +Added explicit tests for on-edge intersections with polygons. This should +eliminate stray rays and tiny light leaks that often appear even in +well-constructed geometry. + +Added "-s up" option to pabopto2bsdf to allow for 180 degree symmetry, +meaning that data repeats after 180 degree rotation (as distinguished +from "-s bilateral" whose data is mirrored about a vertical plane). +Thanks to Helen Rose Wilson for the suggestion and informing me that +such a thing exists. + +Removed upper limit on number of modifiers in rcontrib. + +Put cap on maximum ambient gradient to avoid over-extrapolation of +poorly computed irradiance cache values. + +Added robjutil +T option to triangulate all faces in .OBJ description. + +Altered BSDF library to have both front and back diffuse transmittance +values, which can be different. This was necessary to avoid issues +caused by measurement and modeling discrepancies. + +Added pabopto2bsdf -g option to cull near-grazing scattering to avoid +issues with noise and negative values. + +Increased default dynamic range from 32 to 100 in pcond and normtiff. + +Added -o and -n options to genbox to create .OBJ output and segment +edges and corners for transparent materials. Also added -s option +to control smoothing for .OBJ and Radiance with segmented rounding. + +Made it so robjutil with the +r option for Radiance output now +produces normal smoothing unless normals are removed with -n. + +Added exposure preservation to pcompos when possible (i.e., when +there is only one input or inputs agree on exposure). + +Added -DSHARP_RGB compile-time option to use sharp RGB color space +rather than historic default. This can make for more accurate color +calculations, but requires that materials be recalibrated. The +PRIMARIES= line is also produced on output from rpict or rvu with +the correct set of primaries based on how the system was compiled. + +Added automatic flushing to the output of total, except when the -r +(running subtotals) option is used. + +Improved behavior of little-used -aw option, so that it avoids sea-level +rise caused by adding its own estimate back into the ambient level remainder. +It ended up being simple enough to derate the final average by the factor +corresponding to average surface absorpition, thus removing the average +from the final bounce estimate. + +Introduced ies2rad upgrades by Randolph Fritz. Randolph says it +fixes the following problems: + + 1. Generates correct Radiance geometry for spheres in 1995, 2002, + and 2019 IES files. + + 2. Generates correct Radiance geometry for vertical cylinders that + are taller than they are wide. + + 3. Ignores the file source ("File Generation Type") field in the + 2019 version of the file, which would otherwise be incorrectly used + as an output multiplier. + + It also offers the following enhancements: + + 1. Shape information is included in the .rad file comments. + + 2. 1995, 2002, and 2019-version luminous opening geometry is + accounted for. + + 3. The 2002 and 2019 IES file versions are recognized and + processed appropriately. + + 4. I have made an attempt to do something intelligent with less + common "luminous opening" shapes in the 1995, 2002, and 2019 versions + of the standard, though I have not implemented any support for new + geometry; approximations are substituted and warning messages issued. + Unfortunately, this code is not tested, since I don't have any IES + files that use these shapes. + +Added support for depth-of-field blurring in vwrays using -pd option. +Also, made -c count work with vwrays -i, producing multiple samples +per indicated pixel position. At the same time, support for the -pd +option was added to rtpict, which calls on vwrays for its samples. + +Fixed issue with BSDFs that didn't obey reciprocity, where direct +sampling wasn't following exactly with indirect sampling. This was +discovered and reported by Jon Sargent. + +Created checkBSDF tool to test XML BSDF reciprocity and perform similar +sanity checks. + +Added -O option to pvalue and pextrem to report watts/sr/m^2 even if +picture is XYZE. + +Made subtle changes to header i/o routines to preserve alignment in +binary file formats to enable memory-mapping. Implemented memory-mapped +matrix loading in rmtxop for binary double files. + +Removed ambient value sorting, which was written when ambient caches +could overwhelm available memory. This is rarely the case these days, +and the added code complexity and updating of cache values with LRU +counts dirties pages that would otherwise remain clean, so it was +often a loss even when VM was an issue. + +Added iso2klems script to compute a Klems BSDF based on specular +and diffuse measurements as a function of incident angle. + +Fixed issue with over-counting diffuse component during aBSDF +peak extraction. + +Added dctimestep -x and -y options to specify image dimensions +for multiple outputs corresponding to result vectors. + +Added -P option to rcalc to pass formatted input when cond is <= 0. + +Created rcrop utility for cropping matrices and pictures more +conveniently, correcting view information. Expect it to be handy +for extracting rows and columns from matrices, mostly. + +Changed pcomb so -o option elides original exposure values +from indented source headers. + +Added getinfo -r option, which is similar to -a except it will +replace indicated lines with new ones. + +Slight change to vwrays -d option to not spit out "-ld-", and to +produce "-ld+" without requiring input picture as argument. + +Added automatic overture calculation to rtpict with -n > 1 if +ambient cache is on and file is named. If straight image output +is requested, we randomize all samples and avoid cache collisions. + +Added cnt -s option to shuffle output. + +Fixed issue with divide-by-zero errors in the ambient super-sampling +routine discovered by Jon Sargent of Solemma. This affected regions +that had zero radiance, such as black backgrounds or unlit areas +with -av 0 0 0, when super-sampling was effectively disabled, causing +some loss in accuracy of the results. + +Updated Klems Half- and Quarter-bases to match angles currently used +in WINDOW. + +Eliminated most aiming failures for triangular light sources, at the +expense of conservative sampling near the centroid. Thanks to +David Geisler-Moroder for his help on this. + +Increased maximum set size to 8191 to avoid set overflow errors. + +Added source obstruction test to statistics being kept on which +sources were visible in adaptive shadow testing code. Previous +behavior was likely over-estimating source contributions. + +Added diffuse components into maximum directional hemispherical +reported by checkBSDF, so comparing to 100% is easier for each +component. + +Fixed incorrect calculations in iso2klems script, thanks to +help from Jacob Jonnson. + +Updated official copyright and license according to new wording +provided by Jean Haemmerle at the LBNL Intellectual Property Office. +Both were copied verbatim from e-mail I received from Taoning Wang +on 8/20/2022. + +Added -features option to rpict, rtrace, and rcontrib to check +which features are present or look for specific feature support. +This addition was suggested by Peter Apian-Bennewitz as an easier +way to determine which version of Radiance is installed and what +it supports, and is timely as we begin our refactoring of the +rendering code. There are no current plans to add this to rvu. + +Added falsecolor -odim, -orct, and -c0 options to overlay grid of +values on image. This was requested by Rob Shakespeare. + +Added -i* and -o* options in rhcopy for reading rays from the +standard input and writing rays from holodeck to standard output. +This will hopefully be useful in combining rholo with rcontrib. + +Added further checking for coincident (overlapping) flat surfaces, +preferring front sides to back sides in the ray intersection +calculation. This only applies to rings and faces, as the other +surface types would have required additional calculations to +make them work. Material transparency is still the primary +consideration, now followed by ray hit side, followed by +modifier definition order in the input. + +Increased octree and object limits to allow scenes with billions +of primitives. + +Made reciprocity averaging default to "off" in bsdf2ttree, as it seems +to create more problems than it solves. + +==================== +Version 6.0 + +Extensive changes to enable spectral rendering, which defaults to "off" +to maintain backwards-compatibility with previous versions, with the +exception of the ambient file format, which is changed. The MAXCSAMP +macro, which defaults to 24, sets the maximum number of spectral samples. +The actual number of samples is set by the "-cs" option, which defaults +to 3 for rpict, rtrace, and rcontrib. The latter two programs support +straight spectral output, but rpict is initially restricted to +tristimulus output pictures. New pattern primitives "spectrum", +"specfile", and "specfunc" have been added as a means to specify +spectral reflectance, emittance, etc. to materials that still have +only 3 color channels. Those RGB channels will still affect the +spectrum if used. Unfortunately photon-mapping is currently broken when +spectral sampling is enabled, but we will fix this as soon as possible. +Calculation overhead appears to be approximately 10-15% for RGB +renderings compared to version 5.4a. + +Added spectral rendering to rvu as well, and made -cs and -cw +options standard across the rendering library. I also brought +mkillum, ranimove, rsensor, and mksource into the fold. These +tools were broken in the initial release. (Hopefully, they are +working now, but none have been tested as yet.) +There was also an indexing bug in the spectral->RGB conversions +that made reds into blues and vice versa, which has been fixed. + +Added i/o for spectral pictures to rmtxop, the first program that can +ingest them. (Only rtrace, rcontrib, and rfluxmtx can render them.) +New symbolic rmtxop -c options, such as RGB, XYZ, S (for scotopic) +and M (for melanopic) make color conversions simpler. Alternatively, +a reference matrix or picture may be given and the color space of +that file will be used. The -C option takes either a symbolic +color space or reference file and is "sticky," so it applies to +all subsequent input files that do not have their own -c right ahead +of them. + +Added spectral picture support to rcrop and radcompare. + +Added new utility, rcomb, which is something like a combination +of rmtxop and pcomb, it works with all the inputs and +outputs that rmtxop handles, but allows for general expressions +like those in pcomb for putting matrices together, working on +an element at a time. (No resizing of matrices or accessing +neighboring elements, as permitted in pcomb.) It saves memory +over rmtxop by operating on a row at a time, so can handle +input and output matrices with any number of rows. It does +provide for a single matrix-multiplication operation at the end, +which only requires memory for that final matrix. + +Added support for filtering hyperspectral images to pfilt. + +Added support for 1- and 3-component float matrix i/o to +pcomb to allow for better interoperability. + +Added support for -co+ option to rtpict, so it can directly +produce hyperspectral images. + +Added new "specdata" and "specpict" primitives to support +interpolated spectral data files and hyperspectral images +as patterns. + +Added support for multispectal sampling in rsensor, which will +put out as many color channels as specified in any -cs option +(default is 3 for RGB). + +Added ability of mgf2rad to convert spectral data at least +for light, glow, plastic, and metal primitive types. Need +to use new '-s' option to get new output. + +Added handling of spectral images to rcode2bmp script. + +Minor change to rcollate to allow explicit byte records to +be any specified length without checks against header input. + +Added new hemisphere type to rfluxmtx, "h=cie" for CIE sky +scanner positions. These are 145 patches with identical +row counts to Tregenza, but starting from a different +azimuth and reversing row directions at adjacent altitudes. + +Added optimization for long argument lists and arrays in +the calcomp routines used for rendering and in rcalc, etc. + +Added error estimate spreading to ambient super-sampling +algorithm (-as) to improve performance especially in +scenes with sharp cut-offs. + +Added -i option to gendaymtx to match -i option of gendaylit. +Thanks to Yongqing for initial implementation. + +Changed rcrop so negative #rows or #cols counts back from end. + +Added rcomb -n option for multi-processing of very large matrices. + +Made it so rsplit and rlam can handle any number of input files +up to active open file descriptor limit. + +Taoning Wang added genssky tool for generating spectral sky +descriptions. + +Taoning added gensdaymtx utility based on gendaymtx, and +added epw2wea -a option to include required information. + +Fixed bug introduced in Auguest 2022 (5.4 release) in distant +light source sampling, which caused aiming failures. (Thanks +to Mike DiPompeo of LightStanza for reporting the issue.) + +Added rxpict rendering tool based on C++ RpictSimulManager class. +Multi-processing and spectral output are supported. + +Wrote rxpiece tool that will render pictures using tiling and +can handle different output formats and hyperspectral pictures. +Only runs on a single machine, however -- now NFS locking on +shared volumes. Mainly a demonstration tool for RpictSimulManager +C++ class, but may have its uses. + +Fixed a bug in BSDF sampling of sources pointed out by +David Geisler-Moroder, which tended to overestimate specular +contributions for some BSDFs. + +Added crude ability to read and convert spectra to RGB in ximage, +ra_bmp, ra_ps, and ra_rgbe programs. Also updated fast tone-mapping +library to handle spectral HSR inputs at the same time. HSR +input handling was added in a similar fashion to pcond and pvalue +for convenience. + +Added handling of hyperspectral images to normtiff, a handy program +for quickly tone-mapping Radiance RGBE, XYZE, and now hyperspectral +pictures, as well as IEEE float or LogLuv TIFFs. + +Added handling of hyperspectral pictures to pextrem, though +results are still reported in RGB. + +Added accurate conversion of hyperspectral pictures to ra_xyze. + +Added hyperspectral picture conversion to ra_tiff, with accurate +color when targeting 16-bit/comp., LogLuv, and float utput, +and the approximate method for 24-bit RGB. + +Taoning added genssky -L option to specify global and diffuse +illuminance values for output calibration. + +Created C++ class for rcontrib and example tool rxcontrib, which +is an optional compile in the src/rt directory. The output +model is more general in some respects and the operations more +efficient, but standard output is not supported, nor is ASCII +results data. + +Added experimental source-skipping method to rpict for scenes +with large number of light sources. Currently works with +rcontrib and separate srcsamp image-processing tool. Controlling +rpict options are -dS for skip bitmap specification and -dC +for correction coefficient image. Compile using -DSSKIPOPT +to include this option. + +Added strnstr.c compatibility module in ray/src/common, since +it isn't present on Linux-derivatives. + +Added WGMDfunc material type with programmable roughness and +separate modifier paths for the different components. + +Added gensurf -i option at the request of Peter Apian-Bennewitz +to reverse surface normals, mostly for data input when it is +a bit more difficult to adjust.