# CampAssignment

## Quickstart

1. Clone the latest and greatest version

        git clone git@github.com:tocas/CampAssignment.git

2. Open project using NetBeans IDE

3. Build and run it	


## Project overview

	CampAssignment is a software for camp leaders. It helps them to assign Camper into Section.
	
	Project follow this conditions:
		- difference between count Campers in Sections it equal max. 1
		- campers in sections has similar age distribution, sections are in balance
                - every sections can have assign leader
                - assignment respect conditions whitch campers must be together and whitch don't


  Algoritm for find optimal members in Sections
  
  1. sort all member by age
  2. assingt campers whitch must be together
  3. complet sections into same size
        assignment respect conditon about
  4. with the rest of unassignt camper complete the assignment
        from the oldes into the younges one by one into section

  
## Using program

  In directory dist is CampAssignment.jar for download
  
  Usage from CLI:
  java -jar CampAssignment.jar <fileName> <numberOfSections> <define together campers> <define separated campers>
  
  <fileName> is CSV file with this fields separated with ";"
    1. field = ID (integer value)
    2. field = First name of camper
    3. field = Second name of camper
    4. field = sex {male = 0, female = 1}
    5. field = day of Birth in format dd.MM.yyyy
    
  <numberOfSections> integer value, into how many Sections you would like split members
  First <numberOfSection> campers are assign as leader in their file order

  <define together campers> is text char contain campers ID's whitch must be together in section
  camper pair is separated using ":" new pair is separed using ";"
  is prohibited make transient dependency for example: 43:13;13:25
    otherwhise the aloritm cam return wrong assignment


  example: "14:80;32:78" without apostrophe

  <define separated campers> is text char contains campers ID's whtich cannot be in the same section
  camper pair is separated using ":" new pair is separed using ";"
  every camper can be separated only with one another camper,
    otherwhise the aloritm cam return wrong assignment

  example: "40:2;105:103" without apostrophe


  Example first run:

  /Users/tocas/Desktop/Seznam.csv 6 14:80;32:78 40:2;105:103


## Authors

* Tomas Lucovic, <tomaslucovic@gmail.com>

## Copyright

This project is distribueted under LGPL licence