Calculux

Version 1.0

User's guide
 Contents

Convert-Export User's Guide Contents

1 Introduction ............................................................................................................ 3
1.1 What is Calculux Convert-Export? 3
1.2 The process of generating data-files 4

2 Installing Convert-Export ...................................................................................... 5

2.1 Installation requirements 5
2.2 Installation instructions 5
2.3 File structure 5
2.4 Environment settings and preferences 6

3 Conventions and conversion rules ........................................................................ 7

3.1 The photometric axis of a luminaire 7
3.2 The C-gamma coordinate system 7
3.3 Conversion rules 8

4 The User-interface of Convert-Export............................................................... 11

4.1 General 11
4.2 The Menu bar 12
4.2.1 The File menu 13
4.2.2 The Edit menu 13
4.2.3 The View menu 13
4.2.4 The Help menu 13
4.3 The Toolbar 14
4.4 Luminaire Window 15
4.5 Output Format Parameters Window 16
4.6 Conversion Status Window 17
4.7 Status bar 18

5 Example output-files of the different data-formats .......................................... 19

5.1 Calculux photometric database Eulumdat 19
5.2 Calculux photometric database IES 20
5.3 Calculux photometric database I-Table 21
5.4 Calculux photometric database LTLI 22
5.5 Calculux photometric database TM14 23

Convert-E xport V ersion 1.0

-1-
V ersion 1.0 Convert-Export
-2-
 Chapter 1 Introduction

1 Introduction
This chapter describes the main features of Convert-Export and what you can expect from the
software package.

1.1 What is Calculux Convert-Export?

Calculux Convert-Export is one of the software tools belonging to the Calculux family. It allows
you to convert photometric data of a Calculux database into photometric data of other commonly
used formats, such as EULUMDAT, IES, TM14 and LTLI. The generated data format is saved to
an output file which can be used by light technical software programs, such as Lightscape and
DIALUX. The luminaire information retrieved from de Calculux database can be saved in a
document file. In this way you can save the retrieved luminaire information and used it later on for
other conversions.

This version of Convert-Export supports the following database export formats:

Format name Description For more information refer to

Eulumdat Ein Leuchten-datenformat fr den Dipl.-Ing. Axel Stockmar, LCI Light

Europischen Beleuchtungsplaner Consult International Software
Engineering Berlin/Celle,
Lindenallee 21a, D-3100 Celle 9.

IES IESNA standard file format for IESNA LM-63-95

Electronic Transfer of Photometric
Data

I-Table Free format -

LTLI The LTLI luminaire photometric file Lys & Optik, Hortekrsvej 99, 2800
format Lyngby, Denmark.

TM14 The CIBSE file format The Chartered Institution of

Building Services Engineers Delta
House, 222 Balham High Road,
London SW12 9BS.

Convert-E xport V ersion 1.0

-3-
 Introduction Chapter 1

1.2 The process of generating data-files

PROJECT OUTPUT FILES

PREFERENCES Luminaire A

LUMINAIRES
LIST
CALCULUX A
DATABASE B
C Luminaire B

OUTPUT FORMAT TYPE

Eulumdat IES I-table LTLI TM14 ....

Luminaire C
OUTPUT PARAMETERS

Fig. 1.1: Schematic block diagram of the data-file conversion process

V ersion 1.0 Convert-Export

-4-
 Chapter 2 Installing Convert-Export

2 Installing Convert-Export
This chapter describes de installation requirements for Convert-Export and which steps you should
follow to install Convert-Export on your personal computer.

2.1 Installation requirements

Software requirements
MS-Windows 95, Windows 98, or Windows NT 4.0.

Hardware requirements
CPU: min. Pentium, 100 MHz;
RAM: min. 16MB RAM;
Hard disk: min. 25 MB free disk space;
Others: SUPER VGA colour monitor (800 x 600, 256 colours);
mouse; graphical printer.

2.2 Installation instructions

In order to install Calculux correctly, please stop all other applications before starting the
installation.

To install the program:

Start Windows.
Insert the CD in the CD-ROM drive of your computer.
From the Windows Start menu, select Run.
When the Run dialogue box appears, click Browse.
On your CD-ROM drive, select Setup.
Click OK, to start the installation procedure.
The setup program prompts you through the installation.

. You can also use Windows Write to read the Readme file, which is stored in the Calculux\Convert-
Export directory.

Uninstalling the package:

From the Windows Start menu, select Settings > Control Panel.
Double click the Add/Remove Programs icon.
Select Calculux Convert-Export, click on the Add/Remo ve button and follow the instructions.

2.3 File structure

During the installation procedure by default the following directory structure will be created:

C:\Program Files\Calculux\Convert_Export

Convert-E xport V ersion 1.0

-5-
 Installing Convert-Export Chapter 2

2.4 Environment settings and preferences

When the application is installed successfully, you can start the application and use the menu item
Preferences in the Edit menu to set the environment directories. The environment settings are
saved in the configuration file and are used each time the program is used. The environment
directories can be checked or changed at any time.

Fig. 2.1: Dialogue box for environment settings and preferences

Use To
Input tab specify the default location of the Calculux database and the project files.
Output tab specify the default location of the generated output files for each format type.
Note: When the settings of the output tab are changed they will apply for all new
created projects (not for the currently opened project).
Angles tab specify the used angles for generated output files.

V ersion 1.0 Convert-Export

-6-
 Chapter 3 Conventions and conversion rules

3 Conventions and conversion rules

This chapter gives background information about conventions and conversion rules applicable for
Convert-Export.

3.1 The photometric axis of a luminaire

One of the most important luminaire characteristics used in light technical calculation programs is
its luminous flux distribution. To describe the luminous flux distribution an appropriate reference
system of co-ordinates is needed. This reference system should define every direction in space.

In the Calculux database and the formats generated by Convert-Export the C-gamma coordinate
system is used (refer to section 3.2). The C-gamma system is defined with respect to the three main
photometric luminaire axis, which are defined through the photmetric centre of the luminaire.

+
- +
C = Photometric Centre
a = First axis
C b = Second axis
g = Third axis
+
-
-

Fig. 3.1: The three photometric axis of a luminaire

3.2 The C-gamma coordinate system

The following illustrations display the C-gamma coordinate system for the three main luminaire
types:

90 90
C=
18 C= C=
18 C=

0 C=60 0 C=60

=1 =1
80 C=30 80 C=30

2 70 270
C= C= C= C=
0 0

=0 =0

Street luminaire Indoor luminaire

Convert-E xport V ersion 1.0

-7-
 Conventions and conversion rules Chapter 3

90
C=
18 C=

0 C=60

=1
80 C=30
0
27
C= C=
0

=0

Flood luminaire
Fig. 3.2: The C-gamma coordinate system for different luminaire types

In C-gamma photometry the first axis of the luminaire is the polar axis of the photometric grid.

The range of gamma angles is from 0 to 180 from the negative first axis to the positive first axis.
The range of C planes is from the 0 to 360 counter clockwise from the positive second axis to the
negative second axis.

3.3 Conversion rules

The Eulumdat, LTLI and TM14 format use the conventions as described above. For IES the
coordinate system is slightly different:

IESNA -91
For IESNA-91 the 90 plane is 0. All subsequent planes are rotated 90 clockwise.

Format type Coordinate system

Calculux plane 0 90 180 270 360

IESNA-91 90 0 270 180 90

IESNA -95
For IESNA-95 the 90 plane is 0. All subsequent planes are rotated 90 counter clockwise.

Format type Coordinate system

Calculux plane 0 90 180 270 360

IESNA-95 270 0 90 180 270

V ersion 1.0 Convert-Export

-8-
 Chapter 3 Conventions and conversion rules

180

270 90

Fig. 3.3: The CLX Lumdat coordinate system

270

180 0

90

Fig. 3.4: The IESNA91 coordinate system

90

180 0

270

Fig. 3.5: The IESNA95 coordinate system

. Most of the light-technical software programs that use the above formats comply to the same
conventions. Nevertheless a slightly different interpretation of the format(s) is possible. For
example, it can happen that the light distribution is rotated 90. So always be aware for strange
results. Specially when luminaires are tilted.

Convert-E xport V ersion 1.0

-9-
 Conventions and conversion rules Chapter 3

V ersion 1.0 Convert-Export

- 10 -
 Chapter 4 The User-interface of Convert-Export

4 The User-interface of Convert-Export

4.1 General
When Convert-Export is started the main application window will appear. The main application
window enables you to open and save Calculux Convert-Export documents, or to create a new file.

The functional parts of the main application window are:

1 Menu bar
2 Tool bar
3 Luminaire Window
4 Output Format Parameters Window
5 Conversion Status Window
6 Status bar

Fig. 4.1: Functional parts of the main application window

Convert-E xport V ersion 1.0

- 11 -
 The User-interface of Convert-Export Chapter 4

4.2 The Menu bar

The menu bar contains all the operations and/or commands that can be performed in Calculux
Convert-Export.

The following menus are available:

File menu
Edit menu
View menu
Help menu

Fig. 4.2: The Menu bar

V ersion 1.0 Convert-Export

- 12 -
 Chapter 4 The User-interface of Convert-Export

4.2.1 The File menu

Command Description

Creates a new Convert-Export document.*

Opens the selected Convert-Export document.*
Saves the currently opened Convert-Export document.
Saves a copy of the currently opened Convert-Export document.

List of the last four opened Convert-Export documents.

Quits the application and prompts to save the project (when necessary).

* If another document is already opened, this document will be closed.

Fig. 4.3: Operations and/or commands of the File menu

4.2.2 The Edit menu

Command Description

Creates a new luminaire folder, selects luminaires from a Calculux database.

Renames a selected luminaire folder.
Deletes the selected luminaire(s) or luminaire folder.

Copies the (selected) text of the Conversion Status Window to the clipboard.
Clears the contents of the Conversion Status Window.

Displays various categories of preferences which can be set by the user.

Fig. 4.4: Operations and/or commands of the Edit menu

4.2.3 The View menu

Command Description

Shows or hides the toolbar.

Shows or hides the status bar.
Shows or hides the Conversion Status Window.
Shows the properties of the selected luminaire(s).
Closes all opened luminaire property dialogues.

Fig. 4.5: Operations and/or commands of the View menu

4.2.4 The Help menu

Command Description

Opens the help for Calculux Convert-Export.

Shows info. about the currently installed version of Calculux Convert-Export.

Fig. 4.6: Operations and/or commands of the Help menu

Convert-E xport V ersion 1.0

- 13 -
 The User-interface of Convert-Export Chapter 4

4.3 The Toolbar

The toolbar contains buttons that provide shortcuts to the most commonly used functions or
commands. To display or hide the status bar, click on the menu item Status bar in the View menu.

Fig. 4.7: The Toolbar

Use To

create a new document.

open a previously saved project.
save the project.
add luminaire data from the database.
delete the selected luminaire or luminaires folder.
view the properties of the selected luminaire(s).
view information about Convert-Export.

V ersion 1.0 Convert-Export

- 14 -
 Chapter 4 The User-interface of Convert-Export

4.4 Luminaire Window

The 'My Luminaires' folder in the Luminaires window lists all luminaires you have selected from a
data base or Phillum file. The luminaires listed are specifically for the currently opened project and
are saved in the Convert-Export document file.
Luminaires can be grouped in sub-folders, that can be added, renamed or removed. You can add
new luminaires to, or remove luminaires from a folder. By using the enhanced drag and drop
features you can also move or copy luminaires to a different folder, or change the order of the
luminaires within a folder.
When a new project is created the 'My Luminaires' folder is empty.

Fig. 4.8: The Luminaires Window

Convert-E xport V ersion 1.0

- 15 -
 The User-interface of Convert-Export Chapter 4

4.5 Output Format Parameters Window

The Output Format Parameters Window allows you to select the conversion output format. There
is a separate tab for each output format to view or set the conversion parameters which apply to
that format. When all parameters are set the conversion process can be started by pressing the
or button.

Fig. 4.9: The Output Format Parameters Window

. If the button is pressed only the luminaires selected in the Luminaires Window will be
converted.

V ersion 1.0 Convert-Export

- 16 -
 Chapter 4 The User-interface of Convert-Export

4.6 Conversion Status Window

The Conversion Status Window displays information regarding the conversion process, such as:
Conversion Start (date and time).
Number of luminaires to convert.
Number of luminaires to converted.
Number of warnings encountered.
Number of errors encountered.

Fig. 4.10: The Conversion Status Window

Convert-E xport V ersion 1.0

- 17 -
 The User-interface of Convert-Export Chapter 4

4.7 Status bar

The status bar, which is a horizontal area below the main application window, provides information
about the current state of what you are viewing in the window and any other contextual
information. To display or hide the status bar, click on the menu item Status bar in the View menu.

Fig. 4.11: The Status bar

V ersion 1.0 Convert-Export

- 18 -
 Chapter 5 Example output-files of the different data-formats

5 Example output-files of the different data-formats

This chapter shows an example of the contents of the generated output-files for each of the
available format types.
Conversion is done for the photometric data of a TCS098-236 C1 luminaire. All format types are
generated using the default conversion settings of Calculux Convert-Export.

5.1 Calculux photometric database Eulumdat

PHILIPS 2000-07-17 Eulumdat/1 210.00 172.00 181.00

2 225.00 138.00 162.00
4 240.00 105.00 141.00
24 255.00 70.00 118.00
15.00 270.00 41.00 92.00
19 285.00 21.00 65.00
5.00 300.00 4.00 41.00
LVN8779900 315.00 2.00 21.00
TCS098/236 C1 330.00 1.00 10.00
345.00 1.00 5.00
0.00 0.00 3.00
1999-02-12 5.00 270.00 1.00
1251 10.00 266.00 270.00
206 15.00 255.00 266.00
78 20.00 248.00 257.00
1215 25.00 239.00 245.00
170 30.00 228.00 230.00
0 35.00 214.00 212.00
0 40.00 197.00 194.00
0 45.00 171.00 174.00
0 50.00 140.00 154.00
100.00 55.00 108.00 134.00
54.00 60.00 77.00 111.00
1.0 65.00 46.00 89.00
0.0 70.00 26.00 67.00
1 75.00 11.00 44.00
2 80.00 5.00 24.00
TL-D36W 85.00 3.00 10.00
6400.00 90.00 2.00 6.00
840 270.00 1.00 3.00
266.00 270.00 0.00
72.00 258.00 266.00 270.00
0.40 253.00 255.00 266.00
0.49 247.00 244.00 257.00
0.57 238.00 234.00 246.00
0.64 226.00 221.00 231.00
0.70 204.00 206.00 215.00
0.77 175.00 189.00 196.00
0.82 140.00 169.00 176.00
0.85 105.00 144.00 155.00
0.89 68.00 114.00 132.00
0.91 40.00 84.00 109.00
0.00 19.00 57.00 85.00
15.00 2.00 32.00 62.00
30.00 1.00 17.00 41.00
45.00 0.00 7.00 23.00
60.00 0.00 4.00 11.00
75.00 0.00 2.00 6.00
90.00 270.00 1.00 3.00
105.00 266.00 270.00 0.00
120.00 257.00 266.00
135.00 252.00 256.00
150.00 244.00 243.00
165.00 234.00 229.00
180.00 221.00 215.00
195.00 201.00 199.00

Convert-E xport V ersion 1.0

- 19 -
 Example output-files of the different data-formats Chapter 5

5.2 Calculux photometric database IES

IESNA:LM-63-1995
[TEST] LVN8779900
[MANUFAC]
[LUMCAT] Database version IES95 2000-05-17
[LUMINAIRE] TCS098/236 C1
[LAMP] TL-D36W
[BALLAST] Electronic
[OTHER] B-Angle = 0.00 B-Tilt = 0.00
TILT=NONE
2 3200.00 1 19 7 1 2 0.170 1.215 0.000
1.0 1.0 72.00
0.00 5.00 10.00 15.00 20.00 25.00 30.00 35.00 40.00 45.00
50.00 55.00 60.00 65.00 70.00 75.00 80.00 85.00 90.00
0.00 15.00 30.00 45.00 60.00 75.00 90.00
1728.00 1702.40 1644.80 1574.40 1478.40 1376.00 1254.40
1126.40 992.00 844.80 697.60 544.00 396.80 262.40
147.20 70.40 38.40 19.20 0.00
1728.00 1702.40 1644.80 1568.00 1472.00 1356.80 1241.60
1113.60 985.60 857.60 710.40 569.60 428.80 281.60
153.60 64.00 38.40 19.20 0.00
1728.00 1702.40 1638.40 1555.20 1465.60 1376.00 1273.60
1158.40 1036.80 902.40 755.20 588.80 416.00 262.40
134.40 64.00 32.00 19.20 6.40
1728.00 1702.40 1632.00 1561.60 1497.60 1414.40 1318.40
1209.60 1081.60 921.60 729.60 537.60 364.80 204.80
108.80 44.80 25.60 12.80 6.40
1728.00 1702.40 1632.00 1587.20 1529.60 1459.20 1369.60
1260.80 1094.40 896.00 691.20 492.80 294.40 166.40
70.40 32.00 19.20 12.80 6.40
1728.00 1702.40 1644.80 1612.80 1561.60 1497.60 1414.40
1286.40 1100.80 883.20 672.00 448.00 262.40 134.40
25.60 12.80 6.40 6.40 0.00
1728.00 1702.40 1651.20 1619.20 1580.80 1523.20 1446.40
1305.60 1120.00 896.00 672.00 435.20 256.00 121.60
12.80 6.40 0.00 0.00 0.00

V ersion 1.0 Convert-Export

- 20 -
 Chapter 5 Example output-files of the different data-formats

5.3 Calculux photometric database I-Table

Luminaire: TCS098/236 C1
Lamp: 2 x TL-D36W / 830
Lamp flux: 2 x 3200.00 lm
Ballast: Electronic
Measurement code: LVN8779900 - 01
Measurement date: 99-02-12
Measurement status: Released
Measurement tilt: 0.00

Values per 1000 lm

0.00 5.00 10.00 15.00 20.00

0.00 270.00 266.00 258.00 253.00 247.00
15.00 270.00 266.00 257.00 252.00 244.00
30.00 270.00 266.00 255.00 248.00 239.00
45.00 270.00 266.00 255.00 244.00 234.00
60.00 270.00 266.00 256.00 243.00 229.00
75.00 270.00 266.00 257.00 245.00 230.00
90.00 270.00 266.00 257.00 246.00 231.00

25.00 30.00 35.00 40.00 45.00

0.00 238.00 226.00 204.00 175.00 140.00
15.00 234.00 221.00 201.00 172.00 138.00
30.00 228.00 214.00 197.00 171.00 140.00
45.00 221.00 206.00 189.00 169.00 144.00
60.00 215.00 199.00 181.00 162.00 141.00
75.00 212.00 194.00 174.00 154.00 134.00
90.00 215.00 196.00 176.00 155.00 132.00

50.00 55.00 60.00 65.00 70.00

0.00 105.00 68.00 40.00 19.00 2.00
15.00 105.00 70.00 41.00 21.00 4.00
30.00 108.00 77.00 46.00 26.00 11.00
45.00 114.00 84.00 57.00 32.00 17.00
60.00 118.00 92.00 65.00 41.00 21.00
75.00 111.00 89.00 67.00 44.00 24.00
90.00 109.00 85.00 62.00 41.00 23.00

75.00 80.00 85.00 90.00

0.00 1.00 0.00 0.00 0.00
15.00 2.00 1.00 1.00 0.00
30.00 5.00 3.00 2.00 1.00
45.00 7.00 4.00 2.00 1.00
60.00 10.00 5.00 3.00 1.00
75.00 10.00 6.00 3.00 0.00
90.00 11.00 6.00 3.00 0.00

Convert-E xport V ersion 1.0

- 21 -
 Example output-files of the different data-formats Chapter 5

5.4 Calculux photometric database LTLI

0 90 90 15 5 0 125 21 8LTLI
LVN8779900
PHILIPS
TCS098/236 C1
TL-D36W
270 270 270 270 270 270 270 266 266 266 266 266 266 266 257 257 256
255 255 257 258 246 245 243 244 248 252 253 231 230 229 234 239 244
247 215 212 215 221 228 234 238 196 194 199 206 214 221 226 176 174
181 189 197 201 204 155 154 162 169 171 172 175 132 134 141 144 140
138 140 109 111 118 114 108 105 105 85 89 92 84 77 70 68 62
67 65 57 46 41 40 41 44 41 32 26 21 19 23 24 21 17
11 4 2 11 10 10 7 5 2 1 6 6 5 4 3 1 0
3 3 3 2 2 1 0 0 0 1 1 1 0 0

V ersion 1.0 Convert-Export

- 22 -
 Chapter 5 Example output-files of the different data-formats

5.5 Calculux photometric database TM14

CIBSE/1
LVN8779900
Database version TM14-1988 2000-05-17
TCS098/236 C1
TL-D36W
No additional information on lamps
Measurementsystem = C/GAMMA MEASUREMENT
B-Angle = 0.00 B-Tilt = 0.00
2 1 0.206 1.251 0.078
1.0 72.00 72.00
0.0
19 7
0.00 5.00 10.00 15.00 20.00 25.00 30.00 35.00 40.00 45.00 50.00
55.00 60.00 65.00 70.00 75.00 80.00 85.00 90.00
0.00 15.00 30.00 45.00 60.00 75.00 90.00
270.00 266.00 258.00 253.00 247.00 238.00 226.00
204.00 175.00 140.00 105.00 68.00 40.00 19.00
2.00 1.00 0.00 0.00 0.00
270.00 266.00 257.00 252.00 244.00 234.00 221.00
201.00 172.00 138.00 105.00 70.00 41.00 21.00
4.00 2.00 1.00 1.00 0.00
270.00 266.00 255.00 248.00 239.00 228.00 214.00
197.00 171.00 140.00 108.00 77.00 46.00 26.00
11.00 5.00 3.00 2.00 1.00
270.00 266.00 255.00 244.00 234.00 221.00 206.00
189.00 169.00 144.00 114.00 84.00 57.00 32.00
17.00 7.00 4.00 2.00 1.00
270.00 266.00 256.00 243.00 229.00 215.00 199.00
181.00 162.00 141.00 118.00 92.00 65.00 41.00
21.00 10.00 5.00 3.00 1.00
270.00 266.00 257.00 245.00 230.00 212.00 194.00
174.00 154.00 134.00 111.00 89.00 67.00 44.00
24.00 10.00 6.00 3.00 0.00
270.00 266.00 257.00 246.00 231.00 215.00 196.00
176.00 155.00 132.00 109.00 85.00 62.00 41.00
23.00 11.00 6.00 3.00 0.00
1 0.21 0.00 0.00

Convert-E xport V ersion 1.0

- 23 -