TM30: Compute ANSI/IES TM-30 data, and Create Color Rendition...

In colorSpec: Color Calculations with Emphasis on Spectral Data

Compute ANSI/IES TM-30 data, and Create Color Rendition Reports

Description

Compute TM-30 data from a colorSpec object with the spectrum of a light source (type() is 'light'). And plot full reports from this data. The full TM-30 standard is in the References.

These functions were guided by the IES Spectral Calculator, and checked against the downloadable .XLSX spreadsheets and .PDF reports available there.

Usage

## S3 method for class 'colorSpec'
computeTM30( x, reference=NULL )

## S3 method for class 'TM30'
plot( x, omi=c(0.75,0.2,1.25,0.25), ... )

## S3 method for class 'TM30'
print( x, ... )

Arguments

x	For computeTM30(), a colorSpec object with a single spectrum whose type is 'light'. For plot() and print(), an object returned by computeTM30(), with class 'TM30'.
reference	a colorSpec object used as the reference light source for x. If it is NULL, this reference is computed from the CCT of x, according to the instructions in ANSI/IES TM-30-20.
omi	a vector of 4 numbers, defining the outer margins of the plot, in inches; for details see par(). For the TM-30 report, text is written in the top and bottom outer margins using title(), so these margins may require some fine tuning.
...	further arguments ignored

Details

computeTM30() follows the recipes in ANSI/IES TM-30-20.

plot() reproduces the full reports at the IES Spectral Calculator.

print prints a short 9-line summary of the important TM-30-20 measures.

Value

computeTM30() returns a list of data with class 'TM30'. The data is designed to be a reflection of the data in the .XLSX spreadsheets created by the IES Spectral Calculator.

plot() and print() return TRUE or FALSE, invisibly.

References

ANSI/IES TM-30-20. Technical Memorandum: IES Method for Evaluating Light Source Color Rendition. https://store.ies.org/product/technical-memorandum-ies-method-for-evaluating-light-source-color-rendition/

IES Spectral Calculator. https://www.ies.org/standards/standards-toolbox/tm-30-spectral-calculator/

See Also

par(), title()

Examples

## Not run: 
F1 = subset( Fs.5nm, 1 )

pdf( "report.pdf", width=8.5, height=11 )
plot( computeTM30(F1) )
dev.off()

svg( "report.svg", width=8.5, height=11 )
plot( computeTM30(F1) )
dev.off()

## End(Not run)

colorSpec documentation built on April 4, 2025, 1:59 a.m.