1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171
|
FET (c) 2002-2008 Liviu Lalescu
Program description:
FET is free timetabling software.
This program aims to automatically generate the timetable of a school, high-school
or possibly university, by a heuristic algorithm.
FET can mean "Free Educational Timetabling".
Requirements:
FET is created in the following environment: Kubuntu 7.10 GNU/Linux distribution,
Midnight Commander 4.6.1, KDiff3 0.9.92, Qt 4.3.2, gcc 4.1.3, Linux 2.6.22, other great free tools.
FET can be run on any platform supported by the free software Qt.
GNU/Linux and similar OS's:
Software: gcc 4.1.3 or similar, Qt 4.3.2 or compatible.
Mac OS X:
Mac OS X 10.4.x or compatible.
Apple's developer tools installed.
Qt 4.3.2 or compatible (!!!! NOT Qt 4.2.x)
Microsoft Windows:
For running, you need only the archive of FET compiled for Windows (which contains
the MinGW and Qt dlls).
Download:
You can download the latest version from http://www.lalescu.ro/liviu/fet/ (for now).
Older versions: you will have to contact the author if you are interested.
Getting - compiling - installing Qt toolkit:
You will need Qt 4.3.2 or compatible to compile FET. You can get your
corresponding version of Qt from http://www.trolltech.com . Please get
the opensource version of Qt.
For GNU/Linux - there are instructions in the Qt package on how to install-compile it.
Please get the opensource version of Qt, which is available for now on
http://www.trolltech.com/developer/downloads/qt/x11 .
Basically, type ./configure (type yes when asked), make, make install. Then,
add/create/modify .profile file in your home directory, adding the following 2 lines:
PATH=/usr/local/Trolltech/Qt-4.3.2/bin:$PATH
export PATH
where x (4.3.2) is your corresponding number of the version.
For Windows - Download latest OpenSource Qt for MinGW from
http://www.trolltech.com (for now, the page is
http://www.trolltech.com/developer/downloads/qt/windows )
Install and let Qt download and install MinGW.
Please make sure, after installing Qt and MinGW, that you have
an environment variable named "QTDIR" which is C:\Qt\4.3.2"
and you have in the PATH environmental variable the contents
QTDIR and C:\MinGW\bin.
You might have problems with correct MinGW download procedure and version, I'm sorry,
you'll have to solve them by yourselves.
For Mac OS X:
- You can get the latest version of Qt from trolltech.com and
compile it on your operating system. Don't forget to set the path to Qt binaries
(maybe similar to GNU/Linux)
VERY OLD VARIANT:
- You can download a binary installer of Qt 4.1.0
(compatible with Qt 4.1.2) from: http://naranja.umh.es/~atg/software-qt4.html
Set the required environment variables for your shell. For tcsh,
add the following lines to the end of your ~/.tcshrc file:
setenv QTDIR /usr/local/Trolltech/Qt-4.1.0
setenv PATH $QTDIR/bin:$PATH
setenv MANPATH $QTDIR/doc/man
setenv DYLD_LIBRARY_PATH $QTDIR/lib
Compiling FET:
First of all, currently FET can be compiled using just Qt 4.3.2 or compatible.
But the majority of interface files are Qt 3.3 forms and to modify them
you will need Qt 3.3, which unfortunately has no free Windows version.
GNU/Linux and similar OS's:
- You will need Qt 4.3.2 or compatible to compile this program.
- type "qmake fet.pro". You have to use qmake from Qt 4 series, which on some systems
might be named qmake-qt4. So, "qmake-qt4 fet.pro" might sometimes be needed.
- type "make"
To remove the compiled objects/executable: "make clean" and/or "make distclean".
Mac OS X:
2 Variants:
1. First variant, if you use gcc compiler:
- You will need Qt 4.3.2 or compatible to compile this program.
- type "qmake fet.pro". You have to use qmake from Qt 4 series, which on some systems
might be named qmake-qt4. So, "qmake-qt4 fet.pro" might sometimes be needed.
- IMPORTANT: you might need to write: "qmake -spec macx-g++ fet.pro", if "qmake fet.pro"
does not produce a correct makefile. Please see
http://lists.trolltech.com/qt-interest/2007-04/thread01126-0.html for details.
- type "make"
To remove the compiled objects/executable: "make clean" and/or "make distclean".
2. Another variant:
- Type "qmake fet.pro" and then "xcodebuild".
If you encounter problems, please see:
http://lists.trolltech.com/qt-interest/2007-04/thread01126-0.html
Microsoft Windows: you will have to download and install Qt from trolltech.com (see above).
You might have problems with correct MinGW download procedure and version, I'm sorry,
you'll have to solve them by yourselves. Command "make" belongs to MinGW I think,
so you need a correct MinGW working.
You need to run "qmake" and then "make" in a command line in the FET directory.
Then, you can remove directories "src" and "tmp", to save up space.
If you want to obtain a version which can be run on other computers,
you have to copy these 7 files into the FET directory:
C:\MinGW\bin\mingwm10.dll (this file can be found also in Qt directory bin),
C:\Qt\4.3.2\bin\Qt3Support4.dll, C:\Qt\4.3.2\bin\QtCore4.dll, C:\Qt\4.3.2\bin\QtGui4.dll,
C:\Qt\4.3.2\bin\QtNetwork4.dll, C:\Qt\4.3.2\bin\QtSQl4.dll, C:\Qt\4.3.2\bin\QtXml4.dll.
E-mail author or the mailing list for more details.
Installing FET:
GNU/Linux and similar OS's:
Please move the whole directory "fet-x.x.x" into the place where you like,
for instance to the directory "/usr/local/".
Microsoft Windows:
Move the FET directory in a place of your choice.
Running FET:
GNU/Linux and similar OS's:
Please chdir to the directory where fet executable is (for instance,
"cd /home/liviu/fet-x.x.x/") and run "./fet". You may also run fet from
another directory, but this is not thoroughly tested. Please note that
translations must be in the same directory as the executable or in directory
/usr/share/fet/translations/ )
Microsoft Windows:
Run the executable fet.exe
NEW: Command line, no GUI, just run "fet --inputfile=x [--timelimitseconds=y] [--timetablehtmllevel=z] [--language=t]",
where x is the input file, for instance "inputfile.fet"
y is integer (seconds)
z is integer from 0 to 5 and represents the detaliation level for html timetables
t is one of en_GB, ar, ca, de, el, es, fr, hu, id, it, mk, ms, nl, pl, ro, tr
Documentation:
Very primitive: some hints in the directory "/.../fet-x.x.x/doc/".
Some other hints in Help menu.
If you are a programmer and would like to know how the program works,
you can use "doxygen" to generate API documentation.
Input files:
You can open a few sample input files in "/.../fet-x.x.x/sample_inputs/" directory.
You can create/modify a file from FET's user interface or you can modify it by
hand, if you like.
Feed-back / help:
- I would like to hear your oppinions/results about this program; any
feed-back would be greatly appreciated.
- Reporting bugs/wishes/patches: for now, to the author.
This project is free software, so any sponsoring offer/donation would be great. You can
contact the author for that.
|