###                            eulum2ies                                    ###

EULUM2IES is a small program that converts EULUMDAT luminaire description files 
to the IESNA format. As almost any software, it still isn't finished (and 
probably never will be ...), and -once written for home use-, is not particulary 
rich in features either, it just does it's job ...  

By compiling and using the software you agree to the following Licensing terms:

-------------------------------------------------------------------------------

This program is free software; you can redistribute it and/or modify it under 
the terms of the GNU General Public License as published by the Free Software 
Foundation. This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more 
details.

--------------------------------------------------------------------------------

Installation:

Installation should pose no problems on any standard LINUX system, unpack the 
archive, type
                   make eulum2ies

and that was it. (UNIX users may have to replace gcc by cc in the makefile)

Using:

Typing              eulum2ies [-c] <filename> 

will convert the named file to the IESNA-standard, automatically stripping the 
last four letters of the name and replacing them with ".ies". If several 
subsections for different lamp-types are present in the EULUMDAT file, several 
ies-files will be written, named xxx_1.ies, xxx_2.ies and so on ..
Optionally adding -c to the command enables a conversion from MSDOS to UNIX 
newline characters first, -that messy CR/LF or LF stuff-, securing that no
MSDOS newline sneaks through into the output file.  


Important notes:

No file-checking or whatever is done, so it is up to you to provide a valid
EULUMDAT file as input.
 
Currently, only Eulumdat - symmetry types   
                        0  (no sym)
                        1  (rotational sym.)
                        2  (sym to C0-C180)
                        4  (sym to C0-C180 and C90-C270)
are supported.

The number of C-planes (i.e. horizontal angles) given in the EULUMDAT file
should be a multiple of 4 and the horizontal angles should be equally spaced,
as is most often the case with 24 or 36 horiz. angles. (Up to now I haven't had
the chance to see what happens if this condition isn't met ...)

I don't know the meaning of all the parameters in the IESNA-file standard, 
only the most important ones, at least the converted files are sufficient to
be used with e.g. the Radiance raytracing program. (IESNA charges 20 $ (!)
for their complete file specification, and this is pure RIP OFF !!!!)

Good luck ! Send comments, bugs, feedback to :

Carsten Bauer                    cbauer-@t-online.de
Frankfurter Tor 2
10243 Berlin
--------------------------------------------------------------------------------
 
                                                  