TABLIX(1)

📦
version 0.3.5 · 2 versions
, in ubuntu jammy

✨ TABLIX(1) ✨ — the Tablix User's Manual, but make it a group chat 💖

okay so, bestie, buckle up — we're talking about the Tablix User's Manual, and specifically the little icon that is tablix2_output. no cap, this thing is a whole vibe. let's get into it 🦋

🌸 NAME 🌸

tablix2_output — the Tablix data export utility. she takes your timetables and turns them into things humans (or machines) can actually read. iconic behaviour, honestly 👑

💫 SYNOPSIS 💫

tablix2_output [ -o file ] [ options ] format file

that's it. that's the whole summoning ritual ✨

🧚 DESCRIPTION 🧚

okay so first things first: Tablix is a powerful free software kernel for solving general timetabling problems. it uses a coarse-grained parallel genetic algorithm in combination with other techniques to construct sensible timetables from XML formatted problem descriptions. and the range? unmatched. Tablix can run on a single host or on a heterogeneous parallel virtual machine using PVM3. main character energy fr fr 💅

now, tablix2_output specifically: she reads a timetable description in a XML format produced by Tablix from file and converts it into a number of human or machine readable file formats. alternatively — and this is the plot twist 🫶 — she can also read timetable information from a saved Tablix session. versatile queen.

💖 OPTIONS 💖

  • -o FILE — write output to file FILE instead of the standard output. like, "don't yell into the void, write it down" 🎀
  • -s OPTIONS — set export module options. OPTIONS is a comma separated string of option=value pairs. some options can only be enabled and do not accept a value, and for those you can just omit the =value part (specifying the option alone will enable it). which options exist? depends entirely on the export format you picked, bestie. iykyk.
  • -d LEVEL — set the verbosity level, where LEVEL is one of the following:
    • 0 — only fatal error messages are shown
    • 1 — fatal and non-fatal errors
    • 2 — all errors
    • 3 — all of the above plus some informational messages
    • 4 — all of the above plus debug messages
  • -r FILE — use timetable information from a saved Tablix session in FILE (usually named save?.txt). the timetable with the lowest fitness value in the saved population is exported instead of any result stored in the XML file. and here's the cute part: if you use this option, the XML file does not need to contain a solution at all (i.e. the problem description file can be used). slay 💜
  • -h — shows a brief help message. your little "help me bestie" button 🌸
  • -v — shows compile time options and copyright information. receipts, basically 📜
  • -i PATH — sets the path to export modules. by default the module path is set to the location where export modules were installed by the make install command.

🌈 FORMATS 🌈

🎀 htmlcss

XHTML 1.1 output using CSS stylesheets and UTF-8 encoding for school scheduling. creates one giant HTML file with all timetables.

not recommended for large timetabling problems — she gets heavy, bestie 😭
  • use the css option to specify an alternative stylesheet (if no stylesheet is specified, a default stylesheet is used).
  • use the namedays option (without a value) to enable day names.

🦋 htmlcss2

XHTML 1.1 output using CSS stylesheets and UTF-8 encoding for school scheduling. creates a directory containing one HTML file per timetable. also supports timetables that span multiple weeks.

with this module you have to specify the name of the directory where files are to be saved — you can not use standard output. no exceptions 💀
  • use the css option to specify an alternative stylesheet (if no stylesheet is specified, a default stylesheet is used).
  • use the namedays option (without a value) to enable day names.
  • the footnotes option (without a value) changes the way events from conflicting resources are displayed. without this option, time slots occupied by events from conflicting resources are only marked. with this option, some more information is displayed in the timetable (this is similar to timetables produced by the htmlcss module).
  • with the weeksize option you can specify the number of days in a week. this can be used to produce timetables that span multiple weeks. for example: if the timetable has 15 days (the width of the "time" matrix) and weeksize is set to 5, the timetable will be displayed as 3 separate weeks. default week size is 5 days. math is math ✨

🍓 csv

general "comma separated values" format in UTF-8 encoding, suitable for import into spreadsheet programs and further processing. spreadsheet girlies, this one's for you 💅

⭐ vcal

vCalendar 2.0 (also known as iCal or iCalendar) compatible output. use this format to generate a list of events for one class or one teacher that is suitable for import into cell phones, calendaring applications, etc. putting your timetable in your phone is so main character 📱

you have to specify ALL of the following options for this export module to work correctly — no skipping, bestie, she will simply not function:
  • starttime — time and date of the first time slot in the timetable (a suitable time and date would for example be Monday, 4 September 2006, at 8:00 AM) written in basic ISO 8601 format (previous example in this format would be "20060904T080000").
  • length — length of each event in the timetable in minutes (for example "40").
  • restype — type of resource for which to export the timetable. use "teacher" for teachers and "class" for student classes.
  • resource — name of the resource for which to export the timetable.

👑 gnutu

XML format suitable for import into Gnutu Student's Schedule (see http://gnutu.org).

this module can create a timetable for a single class of students, or a directory with timetables for all defined classes. in the first case, specify the name of the class with the class option. if you do not specify this option, all timetables will be generated — and in that case you have to specify a name for the directory into which the timetables will be saved (use the -o option). choose your fighter 🫶

by default the first timeslot begins at 8:00, the second at 9:00 and so on. if you would like to change that, make a file with one time slot time per line. then specify this file with the hours option. customisation, we love her 🌸

💀 BUGS 💀

none currently known.

bestie really said "i am flawless" and honestly? valid 🙈

🧚 AUTHOR 🧚

Tomaz Solc (tomaz.solc@tablix.org)

🎀 SEE ALSO 🎀

tablix2(1), Tablix User's Manual, Tablix modules HOWTO, Tablix on Morphix HOWTO

and that's the whole page, bestie!! 💖 this edition of the Tablix User's Manual was brought to you by Tomaz Solc, dated 2006-02-04, living under the banner of TABLIX(1). go forth and export your timetables, you absolute icon 🌈✨💅

📦 where this page comes from