Table Placement Optimiser

Using the program

Setup

1. The following external dependencies are required before continuing with the setup:

   • Node.js
   • pnpm

2. Run pnpm i to install dependencies from the NPM registry.

3. Run pnpm compile to compile the project.

Running

1. Edit the files in the directory user/ for your input. Detailed instructions can be found here.

2. Run pnpm start and open http://localhost:3000 in any browser.

Input

Names

Names are input in the user/names.txt file using the following format:

name1, group1
name2, group1
name3, group2
name4, group2
name5
name6

The usage of groups is optional. If any groups are specified the program will try to create seating arrangements that distribute the groups as much as possible.

Room

Names are input in the user/map.txt file using the following format:

  T

BB BB

BB BB

Spaces represents empty spots between seats.

B represents seats to seat people at.

Any other character is treated as a wildcard to be used with the wildcard-constraints.

Constraints

Constraints are input in the user/constraints.txt file using the following format:

constraint_1: name1, name2
constraint_2: name3, name4
wildcard_constraint: name5, name6: W

Constraints are seperated from the names of the people they with : which are seperated from each other with , .

If the constraint uses wildcards that is specified after the names, seperated with : .

The ordering of the constraints in the file is the ordering they will be applied. Therefore, put the most important constraints first.

Currently valid constraints are:

• at_wildcard
• near_wildcard
• not_near_wildcard
• sit_together
• separate