"Candelas Lumens and Lux" introduction to lighting  terms and calculations
"Candelas Lumens and Lux" introduction to lighting  terms and calculations
     
 

 

 

 

Command line specification for the Photoview photometric viewer

You will probably use these commands in a batch to convert file formats or save the zillion images you need to a catalog. Here is an example:

PhotoView.Exe LOADFILE "C:\TESTDATA\AX412W.LDT"  SHOW_TAB POLAR SAVE_IMAGE "C:\TESTDATA\POLAR-231Q.PNG" 

This will load the Eulumdat file, C:\TESTDATA\AX412W.LDT, show its polar image and then save the polar image as a PNG file here: C:\TESTDATA\POLAR-231Q.PNG. Here is an example of saving vectorial EPS files of a polar diagram:

LOADFILE "C:\TestData\Test-Fotom.LDT" SHOW_TAB POLAR SAVE_IMAGE "C:\OXY\POLAR.EPS"

Since PhotoView can generate many images and data sets from photometric files each image or data set is shown on a separate tab. Hence the command to SHOW_TAB POLAR in the above example. The image which gets saved with the SAVE_IMAGE command depends on which tab is active. Here is the polar tab:

Batch Processing Photometry Files

Here is the US Road Classification tab, which you get with the command SHOW_TAB US_ROADS :

US Road lighting example

One last example of what photometric details you can specify for image saving, the cartesian diagram, SHOW_TAB CARTESIAN :

Cartesian VH lighting example

Here is the complete list of strings which SHOW_TAB accepts:

  • POLAR : the normal polar diagram used for internal luminaires.
  • SOLLNER : the standard glare diagram.
  • CARTESIAN : the normal cartesian diagram used for VH luminaires.
  • CLASSIF : Various classifications, for example CIE Flux codes, efficiency, zonal flux, DLOR, LOR etc.
  • CIE_UTIL : CIE utilizations and utilances.
  • MAIN_DATA : General data but the luminaire, power, flux, efficiency, luminaire and lamp specifications etc.
  • TABLE : Raw data, usually in Cd/Klm format.
  • BEAM : Beam opening , for both CG and VH photometries.
  • UGR : Standard UGR glare rating table, usually for internal luminaires.
  • ISOLUX : Isolux diagrams, you can add lights, rotate them, choose surfaces etc. Direct lighting only.
  • ROAD : Road classification where you can see the effect of tilting the luminaire. Contains spread, throw, SLI etc-
  • ISOCANDLES : The classic isocandles diagrams in the standard 5 projections.
  • LUMINANCE : A table and a diagram showing the luminance of the luminaire.
  • CUSTOM : OxyTech will create the graphics just as you want it for your catalog.
  • SOLID : Photometric solid which is orientable.
  • EMER_SPACING : Emergency luminaire spacing table.
  • US_ROADS : (see above) the US Roads diagram with isocandle classification and BUGS classification

The SAVE_FILE, SAVE_IMAGE and SAVE_TEXT commands assume that you are running in batch mode and that you do not want the photometry to remain in the program after the file or image has been saved. For this reason the window of that document is closed after the save.

In all cases names of files must be complete paths and contained inside double quotes. This is so that paths with spaces in them do not get misinterpreted. This is a good command line even though there are spaces in the paths:

PhotoView.Exe LOADFILE "C:\TEST DATA\AX412W.LDT"  SHOW_TAB POLAR SAVE_FILE "C:\TEST DATA\POLAR-231Q.IES" 

The following example is a bad command line, there are no quotes to say when the path starts and ends:

PhotoView.Exe LOADFILE C:\TEST DATA\AX412W.LDT  SHOW_TAB POLAR SAVE_FILE C:\TEST DATA\POLAR-231Q.IES 

With the SAVE_IMAGE command the format of the image is deduced from the file extension. George.PNG will be saved as a PNG file, Albert.JPG will be saved as a JPG file. You can even save graphics as vector files by specificing the EPS or PS extension.

Note that not all tabs have images to save, for example MAIN_DATA.

SAVE_FILE works in the same way as SAVE_IMAGE, deducing the photometric file format from the extension. .IES will save in IESNA format, and .LDT will save in Eulumdat format etc. This shows how PhotoView can be used to convert between photometric file formats: You load the IESNA file for example and then save it as an Eulumdat file.

For printing there are three commands: PRINT_CUSTOM, PRINT_TITLED and PRINT_CUSTOM_TITLED.

If you put the CLOSE_PROG command at the end of the command line then PhotoView.exe will exit after running the command line.

LOAD_FILE and SAVE_FILE needs a bit more explanation when the files are IESNA (.IES extension). There are options to specify which IESNA to save, whether to rotate the files, and whether it is an absolute (candles) or relative (candles per kilolumen) photometry. The command is SET_IESNA and here is an example:

SET_IESNA NI_NE_RP_LM86

And here is an explanation

  • First pair of characters: NI = Normal unrotated Import, RI = Rotated import
  • Second pair of characters: NE = Normal unrotated Export, RE = Rotated Export
  • Third pair of characters: RP = Relative Photometry, AP = Absolute Photometry
  • Last four characters are the type of IESNA, LM86, LM91, LM95 and LM02

So the example above reads a IESNA file with no import or export rotation and save it as a relative photometry in LM86 format.

If you just want to save a photometry you have read it is not neccessary to have SHOW_TAB in your command line. For example:

PhotoView.exe LOADFILE "C:\TestData\SrcFot\DXSYNO-7534.LDT" SAVE_FILE "C:\DXSYNO-7534.LDT"          

Here is another example using the IESNA setting options:

PhotoView.exe  LOADFILE "C:\Test Data\DIS-7534.OXL" SET_IESNA RI_RE_AP_LM91 SAVE_FILE "C:\IESNA_TEST.IES"

You can load a photometry and simply show a specific tab:

 LOADFILE "C:\TESTDATA\PIPPO.IES" SHOW_TAB CARTESIAN 

In the above case the program and luminaire data stays active and the user can view other things and do other calculations.

Here are the command line options which change data in the saved files.

Here are details of logging options of PhotoView.

For more detail on the terms Candelas, Lumens, and Lux have a look at this book:

Book on lighting

 

 
 
 
 

(c) 2017
Contact me if you have any questions about this page or PhotoView photometric viewer. PhotoView is part of a set of services and programs from OxyTech which can be bought with a 10% discount. Click here to find out more.