You are here: Adding Content to Your Projects > Adding Luminaires > Defining Luminaires > Luminaire Definition - Concepts

Luminaire Definition - Concepts

AGi32 requires that a luminaire type be defined before it is located in the project file. The luminaire definition includes photometric information as well as a symbolic representation of the luminaire. Each occurrence of the luminaire will access these parameters in addition to the aiming information specified by the user. AGi32 places no limits on the number of luminaire definitions available in a job file.

The primary element in the luminaire definition is the photometric file associated with the luminaire. It is important to realize that without luminaire photometric information, AGi32 cannot perform any electric lighting computations. Therefore, photometric files are essentially the catalyst required to make the software function! A substantial database of photometric information provided by several dozen manufacturers of lighting equipment can be found from within AGi32 using the Instabase option. Photometric information is also readily available from the luminaire manufacturer or representative.

Photometric files are distributed in standardized formats. In North America, the photometric file format is determined by the Illuminating Engineering Society (IES). The extension for the IES format is .IES. More information on IES Standard File Format can be found here. In other parts of the world, there are two other commonly used standardized formats: CIBSE (which utilizes the .CIB, .CC, .CLS and .TML extensions) and EULUMDAT (which utilizes the .EXL and.LDT extensions).

Relative photometry: AGi32 supports relative photometry in IES, EULUMDAT or CIBSE format. AGi32 supports CIBSE/1 format only.

Absolute photometry: AGi32 supports absolute photometric files in IES or EULUMDAT format only.

The first step in defining a luminaire type to be used in AGi32 is the retrieval of the specific luminaire photometric information. Once the photometric file has been opened and a definition created, it is available to that job file until deleted. There is no need to redefine it to use it repeatedly. The defined luminaires represent a catalog of luminaires that can be conveniently located on the drawing by AGi32. It is often convenient to define all of the desired luminaires at the beginning of the project. However, additional luminaire types may be defined at any time.

Selecting a Photometric File

The first thing you will do upon entry to the Define Luminaire dialog is select a photometric file.

Instabase In The Cloud (IITC)

Instabase In The Cloud (IITC) is a database of photometric data compiled from luminaire manufacturers' databases uploaded to Lighting Analysts' server. It is designed specifically to display participating luminaire manufacturers' photometry in an organized manner and to enable effective search functions to aid in luminaire selection in the lighting design process.

Manufacturers who provide photometry for AGi32 have taken the time to include photographic or graphic images of their luminaires within the tree structure created for their files. These images can be used elsewhere in AGi32 for presentation purposes and make browsing the Instabase fun and more informative. All luminaire manufacturers are invited to participate in the AGi32 Instabase without charge.

More information can be found in the separate IITC Help.

Luminaire Collections

Most users tend to use the same luminaires or arrangements over and over again. AGi32 provides a method to access your favorite or most commonly used luminaire definitions without having to redefine them for every job file. We call it a Collection. Simply, luminaire collections are lists of predefined luminaire definitions.

AGi32 will allow you to create as many collections as you like, each with a unique set of definitions. For example, specifiers may wish to create collections associated with particular jobs, and agents might like collections for individual manufacturers they represent, while a utility could simply create a collection of particular luminaires they have approved and stock. Any way you decide to establish your collections, they can be a dramatic time saver when you know what luminaires you need, and how they should be represented, without having to think through this process every time. For example, a collection could be called "My Favorite Roadway Luminaires" or "Chatfield Arena Project."

All luminaires added to a collection must carry unique text Descriptions. It is by these Descriptions that they will be listed in the luminaire collections. If no Description was entered when the luminaire was defined, you will be prompted to enter one when you add it to a Collection. Descriptions cannot contain the characters *, ? or " (asterisk, question mark, or quote) and may be up to 255 characters long.

To access luminaire collections, press the Collection button located at the left side of the Define Luminaire dialog. This will invoke the Luminaire Collection dialog. This dialog allows you to add defined luminaires to a collection and/or add predefined luminaires from a collection to the current Defined Luminaire List. You need only assign a unique label to a predefined luminaire from a collection to add it to the Defined Luminaire List in the current job file.

When retrieving luminaires that are already part of a collection, AGi32 provides an automatic labeling feature that can save time. If you normally label luminaires using an alphanumeric or numeric scheme, AGi32 can do this for you as you pull the luminaires from the collection. Or if you prefer, you can assign any label manually. When you select the luminaire and click on the up arrow to add it to the defined list, the Label dialog opens. To use the Automatic Label you need only click the OK button. To manually label the luminaire select the radio button above Manual Labeling and enter your label. Then click OK to return.

Select Photometric File

The Select Photometric File button opens a common Windows Browse dialog with the file type set to *.IES, *.CIB, *.TML, *.CC, *.CLS *.EXL, *.LDT formats. This dialog is used to navigate to the drive or directory where the desired photometric file is located. Select one or more files and then click OK to return to the Define Luminaire dialog. See the topic Select Photometric File(s) for more information on this dialog box.

If there is an associated symbol and/or image, they will be automatically loaded (if found).

For more information on this dialog, see Select Photometric File(s) topic.

Find File

The Find File button opens the MultiUse dialog used to search for files on your computer system or network. Simply enter the search criteria (specific filename or wildcard), select the drive to search and navigate to a folder from which to start your search. All files found matching the criteria will be displayed. Select any file and click OK to return to the Define Luminaire dialog.

If there is an associated symbol and/or image, they will be automatically loaded (if found).

Drag and Drop Photometric files

Photometric files may be dragged and dropped into the Defined Luminaires section of the Define Luminaire dialog. Two primary drag-and-drop operations are available:

1. Drag photometric files into AGi32 from Instabase In The Cloud if IITC was opened with the Default Browser option (drop-down menu next to IITC button). For additional information, please see the separate IITC Help.

Technical Details:

2. Drag photometric file from a folder on any device/drive (e.g., drag photometric files from your photometric folders instead of using the Select Photometric File method). If the selected photometric file is valid, AGi32 will also look for an image file (JPG) and symbol file (SYM) in the same folder. Files must have the same filename as the photometric file.

Technical Details:

Notes regarding drag-and-drop method:

General Notes

Smart Symbols

Smart Symbols assist you in selecting symbols within your luminaire definition by recommending a symbol for the selected photometric file. Smart Symbols are chosen using the luminaire's shape, size and distribution specified in the photometric file. In addition, the selected symbol is automatically scaled to match the luminaire's luminous box.

You may select different mounting types for the selected file. Symbols shown for these mounting types will differ based on the distribution and application and may be undefined if the combination doesn't make sense (for example, you wouldn't want to recess an indirect luminaire in the ceiling plenum).

Smart Symbols are recommended using the Smart Symbol Logic database. You may change the recommended symbols or add custom symbols by appending to the Smart Symbol Logic database. Access it from the System Settings-Defaults tab.

Luminaire Label

The luminaire Label references the photometric definition whenever a luminaire is placed in the job file. By default, the luminaire Label is specified per the settings in the Label and Description Defaults. To change the Default settings for future definitions, click the Defaults button. This label will reference the complete luminaire definition as assembled in the Define Luminaire dialog, including the photometric file, lumens, light loss factor, watts, pole information, arrangement and symbol specifics.

The luminaire Label is limited to 32 characters in length and cannot contain the characters * ? " or {} (asterisk, question mark, quote, bracket).

Because the luminaire Label references the complete photometric definition, not just the photometric file, it is entirely feasible that you could have several different labels that will reference the same photometric file. For example, you may need to locate several different arrangements of an area lighting fixture. The label Single may be assigned to the single arrangement option, and Double would be assigned to the dual-headed arrangement. Other possibilities include assigning different labels to use prorated lamp lumens, for different wattages, or different arm lengths. Put simply, different labels may call the same photometric file but represent different applications.

Luminaire groups constructed from individual luminaires must be assigned a unique label as well. In other words, the group label must carry a different label than any of the luminaires contained within the group.

Luminaire Tag

The luminaire Tag is an optional field. Tag allows you to assign a non-unique identifier to one or more labels. Tag can be used when labeling and to summarize all locations by Tag. Tag is most useful for different arrangements or groups using the same luminaire type.

Example: Zlroad-Single, Zlroad-BackBack and Zlroad-Quad all use the same luminaire (Zlroad). If you wanted to summarize all of these locations by luminaire, simply assign the same Tag to all of them and place a Luminaire Tag Summary schedule. This might be especially for luminaire manufacturers, for an inventory count on a project.

The Tag option is also available for Luminaire Groups, after the Group has been defined.

Luminaire Description

By default, the luminaire Description is specified per the settings in the Label and Description Defaults. To change the Default settings for future definitions, click the Defaults button. The Luminaire Description text box allows user input of up to 80 characters. This text string is also shown in the Defined Luminaires list along with the label to help identify the variety of luminaires defined in the job file. The description contents are entirely up to the user (although they may not contain the characters * ? "). Possibilities include catalog numbers, mounting arrangement, group explanations, specifications, etc. Once a description has been associated with a luminaire definition, that description will be included in Text Prints and Luminaire Schedules.

Poles and Pendants

As part of the luminaire definition, a luminaire may reference a pole or pendant that is attached to its insertion point. In Plan view, the poles or pendants are not visible and do not change the appearance of the drawing. In Elevation or Isometric view, poles and pendants will make your work appear much more "real." Luminaires without poles or pendants will appear to be floating in space. To use the same photometric file with and without poles (or pendants), simply create two definitions.


A "dynamic" pole or pendant will always be attached to the same Z coordinate and will vary in length according to the mounting height of the luminaire. Example: A luminaire with a dynamic pendant attached at 12 feet and mounting height of 8 feet will have a pendant length of 4 feet. The same luminaire with a mounting height of 9 feet will have a pendant length of 3 feet.


Luminaires with "static" poles or pendants will always have the same pole/pendant length regardless of the mounting height. Example: A luminaire with a static pole length of 30 feet, inserted at a mounting height of 25 feet, will have 5 feet of the pole below the Z=0 datum. The same luminaire inserted at a mounting height of 35' will appear to have the pole base floating 5 feet off the ground.

Light Loss Factor

The Light Loss Factor is a multiplier used to simulate a reduction in lumen output due to factors such as dirt depreciation, lumen depreciation over time, ballast factor and others. The factors are multiplied together to achieve the total light loss factor. In its simplest form, the light loss factor is composed of many components, which will vary with any given project.

AGi32 allows for the enumeration of several light loss factors. Click here for more information.

Prorating Lumens per Lamp

When a luminaire has been selected, the Lumens Per Lamp value that appears in the Define Luminaire dialog is extracted from the photometric file and is the basis for the photometric report. Should this test lumen value not be the desired one, it can be changed by simply clicking the mouse in the Lumens Per Lamp cell and changing the lumens. This is often necessary when prorating from one lamp output to another or when using a photometric file that is based upon a derated value such as 1000 lumens. For example, it is often necessary to prorate the lumen output to represent a lamp of different wattage or variety. AGi32 allows you to insert virtually any value for the lamp's lumen output, although it is recommended that the manufacturer be consulted with regard to the accuracy of the proration. In the case of luminaire photometry reported per 1000 lumens, the figure of 1000 will appear in the Lumens Per Lamp cell. Simply change this to the rated lamp lumens.

Generally, the lumen figure refers to a single lamp's lumen rating. Luminaires containing multiple lamps will be treated appropriately, provided the photometric format is followed. Luminaires containing multiple lamps of different varieties, such as metal halide and high-pressure sodium, will use a lumen value that averages the single lamp lumens of every lamp contained within the luminaire.

Regarding LER and LCS and BUG ratings:

Linking to Photometric Toolbox from within the Luminaire Define dialog will include the lumen and watts values specified in the luminaire definition (not the original test data) to ensure that all generated reports in Photometric Toolbox are based on these modified values (this has changed from previous versions).

There is an exception to the above when opening a file based on absolute photometry. In this case you cannot change the lumen figure. The Lumens for a file based on absolute photometry will appear as –1. Absolute photometry is often used for testing LED luminaires.

Luminaire Watts

As with lamp lumens, the luminaire test watts are also extracted from the photometric file. We recommend verifying that this value is accurate, as this is the value used to calculate Lighting Power Density. Typically, this figure should reflect the combination of lamp and ballast watts. As with lamp lumens, this value can be changed to represent luminaires of different wattage and variety.

Regarding LER, LCS and BUG ratings:

Linking to Photometric Toolbox from within the Luminaire Define dialog will include the watts values specified in the luminaire definition (not the original test data) to ensure that all generated reports in Photometric Toolbox are based on these modified values (this has changed from previous versions).

Luminaire Efficiency

Luminaire Efficiency is the ratio of Luminaire Lumens to Total Lamp Lumens (number of lamps x lumens per lamp). If the calculated Efficiency is greater than 100%, an Error message is displayed indicating that there is something seriously wrong with the file and that it should not be used. The luminaire manufacturer or supplier should be contacted for a corrected file.

S/P Ratio

S/P Ratio is the ratio of source Scotopic luminous flux to Photopic luminous flux. It is used to rank the effectiveness (for visual performance) of light sources and is derived from the source Spectral Power Distribution data. The source S/P Ratio is required for calculation of Mesopic Illuminance and/or Luminance.

Some representative S/P Ratios of various sources can be found in IES document TM-12-12. S/P Ratios for a specific lamp type may also be obtained from the lamp manufacturer, and will often be found in their lamp catalog and/or online.

See Photopic, Mesopic, Scotopic - Concepts for additional information.

Luminous Box

AGi32 uses the dimensions of the luminous box when performing lighting calculations using the Full Radiosity Method. With the Direct Only Method, the luminaire is assumed to be a point source. If the luminous dimensions found in the photometric file are incorrect, the lighting calculations may not be accurate. For example, if the distribution of a 1x4 luminaire is emitted from a point source instead of an appropriately sized luminous area, the luminous area will not be discretized appropriately. The effect is most noticeable when the luminaire is placed close to a reflective surface.

In addition, care should be taken that the luminous box does not extend outside of the room and is not truncated by any objects. Most importantly, the luminous height (Z) should not be above the ceiling. If the photometric file has luminous height, the luminaire should be mounted such that the entire luminaire is below the ceiling. If the Z coordinate of the URHC (upper right-hand corner) is 0, the luminaire may be mounted flush against the ceiling.

The luminous box is associated with the luminous area in the Render symbol. Specifically, the Z=0 portion of the luminous box is aligned with the center of the luminous area of the Render symbol. This association may place the luminous box at some distance away from the insertion point of the luminaire (mounting height). For example, if the Shoebox-Yoke symbol is selected, the luminous area is located 1 foot above the insertion point of the luminaire. If a 15 foot mounting height is specified, the calculations will actually consider the luminous source at 16 feet above grade.

The luminous box is circumscribed using the luminous opening data in the photometric file. The X, Y and Z coordinates of the lower left hand corner (LLHC) and upper right hand corner (URHC) are given relative to the center of the luminous opening. The X dimension corresponds to the distance across the luminous opening along the 0-180 photometric plane. The Y dimension corresponds to the distance across the luminous opening along the 90-270 photometric plane.

Note: Please see the IESNA document, LM-63, for more information about the luminous dimensions given in IES format photometric files.

Rotate Photometry to conform to IES Standards

European roadway luminaires are typically tested (but not always) such that the zero degree horizontal plane of photometry (C0) is on the right side of the luminaire parallel to an imaginary curb line. IES standard data specifies the zero degree photometric plane such that the zero degree horizontal plane is in front of the luminaire or perpendicular to the curb.

This function allows you to rotate the photometry to conform to IES standards. This has the affect of rotating the photometric data negative 90 degrees (or 90 degrees clockwise). Use this function with caution as it should not be applied to all European photometric data. It is up to the user to determine when and if this function should be used. Hint: In IES format, the horizontal cone trace (red line) should appear in polar plot like image on the right, below:

Before Rotation

After Rotation and Redefining

Luminaire Arrangements

AGi32 provides a number of common Luminaire Arrangements already constructed for your use. A luminaire arrangement consists of a multiple occurrence (or single) of one photometric file arranged in a common configuration about a central location. For example: two luminaires back-to-back or four luminaires rotated 90 degrees apart (quad).

The luminaire arrangement selection process is similar to the one described in the luminaire symbols discussion above. Simply click in the Arrangements window to display the variety of possibilities. The default luminaire arrangement type is a single luminaire with an arm length of zero.

AGi32 Factory Arrangements

With the exception of "Single," luminaire arrangements cannot be aimed at a point (cannot use Locate and Aim option).

All occurrences of the luminaires within the luminaire arrangement are inserted at the same point when Arm Length and/or Offset are equal to zero. Depending on the arrangement type, it is possible to change the arrangement's Arm Length and Offset. These variables specify the distance between the luminous center of the luminaire and the insertion point of the luminaire. The numeric value entered in the Arm Length text box specifies the distance in feet between the luminous center and the insertion point along the 0-180 degree photometric plane. If multiple luminaires exist in the arrangement, perpendicular to each other (such as twin), the numeric value specified in the Offset text box is the distance in feet between the luminous center and the insertion point along the 90-270 degree photometric plane.

The diagram to the right shows a Twin luminaire arrangement with a 2 foot offset and a 1 foot arm length. As you can see, it is simple to create luminaire arrangements with variable arm lengths and realistically model the luminaires photometric position relative to its insertion point.

Custom Arrangements

Should you need to create a luminaire other than the factory-supplied arrangements, AGi32 provides an easy method with which to create custom arrangements. You may create a new arrangement from scratch or use an existing arrangement to create a new arrangement. It is not recommended that you modify factory-supplied arrangements.

Luminaire Symbols

Users will increase the visual clarity of their presentations as well as distinguish different luminaires by taking advantage of AGi32's extensive luminaire symbol library when completing the luminaire definition. AGi32 provides many generic symbol representations that correspond to particular types of photometric files.

The Render Mode symbols are physical luminaire representations in Render Mode and are shown in this dialog in Isometric view. Render Symbols participate in the calculations in the Full Radiosity Method by reflecting and occluding light within the environment. They are constructed of surfaces making up two basic surface types, the symbol's housing and its luminous surface. Each surface type is assigned a color corresponding to a particular reflectance (luminaire housing) or luminosity (luminous area).

The Model Mode symbols are symbolic representations of the luminaire in Model Mode (design mode) and are shown in this dialog in Plan view. Model symbols are used to graphically represent the luminaire in Model Mode and do not participate in the calculations in any way. These symbols simply represent the luminaires in Model Mode and when printing or exporting the job file as a 2D CAD file. The Model symbol typically looks the same as the Render symbol unless it is changed.

Note: If the Model symbol is grayed out (not selectable), in order to change it you must first click in the Render symbol field, unselect the "Model Mode Symbol Same As Render Mode Symbol" option, and then click OK to return to the Define dialog. It is not necessary to do this if only the symbol color is to be changed.

Symbol Mirroring

In the render Symbols dialog, the Symbol Mirroring option is automatically selected. When enabled, the Model mode version of the selected Render mode symbol is automatically used as the Model mode symbol. To use this function efficiently, always modify the Render symbol first. If the Model mode symbol is modified first, the Render symbol is not changed.

AGi32 Factory Symbols

AGi32 symbols possess a number of properties that are important to understand prior to their application. A discussion of each follows.

Symbol Scale

The factory supplied luminaire symbols available in AGi32 are constructed to be true scale when symbol scale equals one. The actual symbol sizes are given in the table that follows. A symbol scale of one is the default value and is reasonably legible when working with small-scale projects such as interior lighting applications. It will also make the symbol appear correct when rendered.

When working with large-scale projects, such as outdoor sites, true size symbols may be hard to see. The Model mode Symbols may be scaled so that they are better viewed in these types of layouts. Do not increase the symbol scale of Render symbols, however, as scaling this symbol will increase its luminous area. To scale all Model mode symbols in the job file uniformly, a better alternative is the Modify-Luminaire-Symbol Magnifier command.

Symbols can be scaled in the X, Y or Z directions in order that a common shape may be used to resemble another. For example: A 1x4 symbol can be scaled by a factor of 2 in the Y direction to create a 1x8 symbol.

Render Symbol Color

The color of an AGi32 Render Symbol consists of two components, the housing color and the color of the luminous area. The housing color is the color of the non-light emitting portion of the symbol, while luminous color is the color of the light emitting (or luminous) portion of the symbol.

All colors in AGi32 are based on reflectance or luminance (SRE - Spectral Radiant Emittance). To select a color click the left mouse button with the cursor in the color cell. Follow the steps outlined below to select a color.

1. Move the Hue slider to the color of choice. For gray only (no color), move the Hue slider to the very bottom of the graph.

2. The Hue selected will be displayed with the range of intensities available. Move the Luminance (Lum.) and Saturation sliders to the desired intensity of the color, or simply click the left mouse button in the Lum./Saturation field. Alternatively, you can specification the RGB or HSL values.

3. The selected color will appear in the Selected Color / Reflectance frame on the right side, with current reflectance shown below. Adjust the reflectance if necessary in the small reflectance slider.

4. Click OK.

SRE (Spectral Radiant Emittance)

The luminous color selected affects the color of the light emitted from the associated luminaire when performing radiosity calculations and can easily be observed when rendering.

There are three methods that may be used: Source Color, Color Filters, or Color Mixing. Be aware that changing the color of the luminous area to other than white (100%) by means of the Color Filters or Color Mixing method will derate the output of the luminaire, as would be expected when applying a real filter or gel. This can be useful for approximating the effect of colored gels applied to the light source, as the depreciation is realistic. See SRE Color and SRE Color - Concepts for more information.

Insertion Point & Computational Implications

Symbols have no effect on the light emitted from the associated luminaire. For example, if the symbol has a mounting yoke, the yoke is part of the symbol and, consequently, has no effect on the light emitted from the associated luminaire. However, other luminaires or reflective surfaces in the environment can illuminate the luminaire symbol. Care should be exercised when using poles and pendants, as they do affect the light emitted from the associated luminaire (they are considered in the radiosity solution).

Poles and pendants are attached to the insertion point of the symbol. The insertion point of each symbol is indicated with a small arrow. When selecting a symbol, you can also select an insertion point on either the Top or the Bottom of the symbol. Your choice will most likely depend on the application of the symbol in your job file. Different symbols default to top or bottom, although in many cases either choice can be valid. See the Symbols Table for recommendations for insertion point.

Luminaire symbols are stored as files in the Symbols sub-folder of AGi32.

Symbol Line Width

The default line width of factory supplied symbols is 1 pixel. A Pixel is the smallest available line thickness. When placing luminaires on a complex background or printing in black and white, the symbols may be more distinguishable if the line width is increased. Line widths other than Pixel are stated in current display units (feet or meters). The line width scrolls in multiples of 0.25, although any value may be manually entered into the text box. If a value of zero is entered, the line width will default back to Pixel.

Custom Symbols

Custom symbols may be created in AGi32 by using Object and/or Drawing commands. To create a Model mode symbol, you may select entities from a CAD file background or create your own using the Drawing commands. To create Render symbols (and correlated Model mode symbols, if desired), use AGi32's Object modeling tools. Certain rules and restrictions are required. Details are provided here.

Photometric File Description

The Photometric File section contains a Description of the luminaire as extracted from the photometric format file, the Classification of the light distribution (calculated by AGi32), a photographic image if available (only files from the AGi32 Instabase), a graph of the luminaire's Candela distribution, and an LCS graph (toggle between the LCS graph and the Candela distribution display).

Description/Roadway/LCS/Indoor/Flood Classifications

The Description tab reiterates the descriptive Keyword information contained in the selected photometric file. Use the scroll-bars to see the entire IES description if it extends beyond the window extents.

The Classification and LCS (exterior Luminaire Classification System) tabs display various metrics calculated by AGi32. These metrics may or may not be displayed, depending on the nature of the file.

LCS / BUG / LER metrics and prorated lamp lumens
Classification metrics

Photographic Image

Manufacturers participating in the AGi32 Instabase program may have photographic images associated with their photometric files. When selecting a file from the Instabase or a Collection the image will appear in the luminaire define dialog. If the file is selected using Select File or Find File the image link is lost. Photographic images are selected by the manufacturer to match a group of files generally categorized by product type. This image can be used in your printed output from AGi32's Page Builder.

More Information link

When a manufacturer creates an Instabase for their product lines, they have the option to specify a More Information URL in their file structure as well as to each specific photometric file. This URL allows them to link you to a website location where more information about the product is available. If they have specified a More Information URL link for the selected photometric file, a More Information link will appear above the photographic image.

Candela Distribution Curves

The candela curves of all photometric files selected, regardless of method (Instabase, Select File, etc.) are plotted on either a Polar or Cartesian graph and displayed in the define dialog. The contents of the graph can be user controlled using the More button.

Factory provided graphs are created as follows:

Type C photometric reports (indoor, fluorescent, industrial, roadway, area and most other luminaire types) are displayed in a Polar format graph. The Blue curve represents a vertical slice through the light distribution at the horizontal angle containing the maximum candela value. The distribution 180 degrees (measured horizontally) away from the maximum makes up the other side of the curve. If a luminaire is symmetric, both sides of the curve are the same. The Red curve represents the cone dissecting the light distribution at the maximum candela value as measured in the vertical angle. Symmetric distributions will show as a perfect circle. In asymmetric distributions, the curve shape will depict the shape of the light distribution when viewed from above, as sliced through the vertical angle containing the maximum candela value.




Type B photometric reports (i.e., most floodlighting luminaires) are displayed in a Cartesian format graph similar to that shown at right. The red curve represents a vertical slice through the center of the light distribution from below the luminaire (left side) to above the luminaire (right side) when the luminaire is aimed at the horizon. The Blue curve represents a horizontal slice through the center of the light distribution from left to right. Visualize the Red curve as being the vertical beam spread and the blue curve being the horizontal beam spread.


Auto Define Option and Add/Redefine Button

Auto Define Option

The Auto Define option is selected by default. (Button on main toolbar of this dialog.) If this option is enabled, a luminaire whose photometric data file is loaded into the Define Luminaire dialog via any of the methods in Step 2 (first section above) will be automatically defined as is. If any changes are made, e.g. LLFs defined or symbol changed, the Add/Redefine button must be clicked to save those changes. If the Auto Define function is disabled, a luminaire whose photometric data file is subsequently loaded into the Define dialog will not have a completed definition until the Add/Redefine button is clicked.

Note: The default status of the Auto Define button is determined by the setting in System Settings (General tab, Switches section).

Redefining a Luminaire

Once a luminaire has been defined, it may redefined at any time. To redefine a luminaire, invoke the Define Luminaire dialog box (Define Luminaire button or Modify - Luminaire - Definition command on the main menu bar). Highlight the desired luminaire by left-clicking on the text line describing the luminaire in the luminaire list. Make the desired modifications. This might be as simple as a light loss factor change or as involved as the selection of a completely new photometric file to be assigned to the label. As soon as any item in the definition has been changed a warning will appear beneath the Add/Redefine button. This serves to remind the user that the Add/Redefine button must be selected prior to exiting the dialog in order to retain the changes.

When the Add/Redefine Luminaire button has been clicked, the following message will appear: "Label already exists, do you want to redefine <label>?" At this time, you have the opportunity to cancel the redefine operation and return to the Define Luminaire dialog.

Once redefined, all occurrences of that luminaire type already present in the model will be changed to reflect the modifications of the redefined luminaire. If AutoCalc is enabled, AGi32 will recalculate all analysis points.

Relabel Button

Occasionally, it is necessary to change a luminaire label while retaining all of the properties and luminaire location associated with it. This is done with the Relabel command in the Define Luminaire dialog.

To edit only the luminaire label without actually changing any of its assigned properties, do not change the value of the input cell directly. This will actually create a new luminaire definition, and the original luminaire definition will remain. Instead, click the Relabel button and enter a unique label name in the text box. Click Ok to apply the new luminaire label and return to the Define Luminaire dialog. If this is the only modification made while redefining the luminaire, there is no need to click the Add/Redefine Luminaire button.

Luminaire Groups

To begin, click on the Create Luminaire Group button in the Luminaire Toolkit, or from the main toolbar select the command Modify - Luminaire - Group - Create Group. The Define Luminaire dialog will automatically appear as part of the luminaire group definition process. The only entry that is required to complete a group definition is the assignment of a label. You may specify the symbol color, description and pole designation. However, this is purely optional. All other attributes are properties of the group definition and cannot be altered.

Once a Luminaire Group has been created, a Tag may be added to the Group definition, and Sub-Tags may be assigned to individual locations within the Group.

For more information on Luminaire Groups, see Grouping Luminaires - Concepts.

Photometric File Auditing and Automatic Audit Option

When opening a previously saved AGI file with defined luminaires, if the Automatic Audit option (main toolbar in the Define Luminaire dialog) is enabled:

For additional information, see Photometric File Audit.