{
  "_id": "6a1f35adb401979e734286ef",
  "Package": "grouper",
  "Type": "Package",
  "Title": "Optimal Assignment of Students to Groups",
  "Version": "0.6.2",
  "Authors@R": "c(\nperson(\"Vik\", \"Gopal\", , \"vik.gopal@nus.edu.sg\", role = \"aut\"),\nperson(\"Kevin\", \"Lam\", , \"lamfy@nus.edu.sg\", role = \"aut\"),\nperson(\"Ju\", \"Xue\", , \"rigi.jx@gmail.com\", role = \"ctb\"),\nperson(\"Mingyuan\", \"Zhang\", , \"mingyuan.z@nus.edu.sg\", role = c(\"aut\", \"cre\")),\nperson(\"National University of Singapore\", role = \"cph\")\n)",
  "Description": "Integer programming models to assign students to groups by\nmaximising diversity within groups, or by maximising preference\nscores for topics.",
  "License": "MIT + file LICENSE",
  "URL": "https://Zimmy313.github.io/grouper/,\nhttps://github.com/Zimmy313/grouper",
  "BugReports": "https://github.com/Zimmy313/grouper/issues",
  "Encoding": "UTF-8",
  "LazyData": "true",
  "VignetteBuilder": "knitr",
  "Roxygen": "list(markdown = TRUE)",
  "Config/testthat/edition": "3",
  "Config/roxygen2/version": "8.0.0",
  "Repository": "https://singator.r-universe.dev",
  "Date/Publication": "2026-05-15 03:29:07 UTC",
  "RemoteUrl": "https://github.com/singator/grouper",
  "RemoteRef": "HEAD",
  "RemoteSha": "e0160718a750afda01254886948dd36433e4dac3",
  "NeedsCompilation": "no",
  "Packaged": {
    "Date": "2026-05-15 06:32:00 UTC",
    "User": "root"
  },
  "Author": "Vik Gopal [aut],\nKevin Lam [aut],\nJu Xue [ctb],\nMingyuan Zhang [aut, cre],\nNational University of Singapore [cph]",
  "Maintainer": "Mingyuan Zhang <mingyuan.z@nus.edu.sg>",
  "MD5sum": "4f3242500b063a2f23c1aa49fdc825d2",
  "_user": "singator",
  "_type": "src",
  "_file": "grouper_0.6.2.tar.gz",
  "_fileid": "e8d0f54ed265bdb0d81492a8fbbeb126795a7c0fe2866fa5d17180ae7061f30e",
  "_filesize": 220202,
  "_sha256": "e8d0f54ed265bdb0d81492a8fbbeb126795a7c0fe2866fa5d17180ae7061f30e",
  "_created": "2026-05-15T06:32:00.000Z",
  "_published": "2026-06-02T19:57:33.414Z",
  "_distro": "noble",
  "_jobs": [
    {
      "job": 79159885062,
      "time": 135,
      "config": "linux-devel-x86_64",
      "r": "4.7.0",
      "check": "WARNING",
      "artifact": "7011483777"
    },
    {
      "job": 79159885135,
      "time": 121,
      "config": "linux-release-x86_64",
      "r": "4.6.0",
      "check": "WARNING",
      "artifact": "7011480679"
    },
    {
      "job": 79159885120,
      "time": 93,
      "config": "macos-oldrel-arm64",
      "r": "4.5.3",
      "check": "WARNING",
      "artifact": "7011473971"
    },
    {
      "job": 79159885118,
      "time": 90,
      "config": "macos-release-arm64",
      "r": "4.6.0",
      "check": "WARNING",
      "artifact": "7011473367"
    },
    {
      "job": 79159884607,
      "time": 164,
      "config": "source",
      "r": "4.6.0",
      "check": "OK",
      "artifact": "7011454358"
    },
    {
      "job": 79159884335,
      "time": 113,
      "config": "wasm-release",
      "r": "4.6.0",
      "check": "OK",
      "artifact": "7368369223"
    },
    {
      "job": 79159884781,
      "time": 89,
      "config": "windows-devel",
      "r": "4.7.0",
      "check": "WARNING",
      "artifact": "7011472974"
    },
    {
      "job": 79159885362,
      "time": 79,
      "config": "windows-oldrel",
      "r": "4.5.3",
      "check": "WARNING",
      "artifact": "7011471285"
    },
    {
      "job": 79159885276,
      "time": 91,
      "config": "windows-release",
      "r": "4.6.0",
      "check": "WARNING",
      "artifact": "7011472770"
    }
  ],
  "_buildurl": "https://github.com/r-universe/singator/actions/runs/25903940372",
  "_status": "success",
  "_host": "GitHub-Actions",
  "_upstream": "https://github.com/singator/grouper",
  "_commit": {
    "id": "e0160718a750afda01254886948dd36433e4dac3",
    "author": "Vik Gopal <vik.gopal@nus.edu.sg>",
    "committer": "Vik Gopal <vik.gopal@nus.edu.sg>",
    "message": "fixed to use latest version of roxygen\n",
    "time": 1778815747
  },
  "_maintainer": {
    "name": "Mingyuan Zhang",
    "email": "mingyuan.z@nus.edu.sg"
  },
  "_registered": true,
  "_dependencies": [
    {
      "package": "R",
      "version": ">= 3.5",
      "role": "Depends"
    },
    {
      "package": "cluster",
      "role": "Imports"
    },
    {
      "package": "dplyr",
      "role": "Imports"
    },
    {
      "package": "magrittr",
      "role": "Imports"
    },
    {
      "package": "ompr",
      "role": "Imports"
    },
    {
      "package": "rlang",
      "role": "Imports"
    },
    {
      "package": "yaml",
      "role": "Imports"
    },
    {
      "package": "knitr",
      "role": "Suggests"
    },
    {
      "package": "ompr.roi",
      "role": "Suggests"
    },
    {
      "package": "pkgdown",
      "role": "Suggests"
    },
    {
      "package": "rmarkdown",
      "role": "Suggests"
    },
    {
      "package": "ROI.plugin.glpk",
      "role": "Suggests"
    },
    {
      "package": "testthat",
      "version": ">= 3.0.0",
      "role": "Suggests"
    }
  ],
  "_owner": "singator",
  "_selfowned": true,
  "_usedby": 0,
  "_updates": [
    {
      "week": "2025-20",
      "n": 2
    },
    {
      "week": "2025-22",
      "n": 10
    },
    {
      "week": "2025-23",
      "n": 9
    },
    {
      "week": "2025-24",
      "n": 5
    },
    {
      "week": "2025-25",
      "n": 4
    },
    {
      "week": "2025-26",
      "n": 19
    },
    {
      "week": "2025-27",
      "n": 3
    },
    {
      "week": "2025-34",
      "n": 3
    },
    {
      "week": "2025-39",
      "n": 5
    },
    {
      "week": "2025-40",
      "n": 7
    },
    {
      "week": "2025-41",
      "n": 5
    },
    {
      "week": "2025-42",
      "n": 12
    },
    {
      "week": "2025-43",
      "n": 4
    },
    {
      "week": "2025-44",
      "n": 4
    },
    {
      "week": "2026-18",
      "n": 2
    },
    {
      "week": "2026-20",
      "n": 5
    }
  ],
  "_tags": [
    {
      "name": "v0.4.0",
      "date": "2025-09-28"
    }
  ],
  "_topics": [
    "education",
    "glpk",
    "gurobi",
    "optimisation"
  ],
  "_stars": 0,
  "_contributors": [
    {
      "user": "singator",
      "count": 106,
      "uuid": 1618120
    },
    {
      "user": "zimmy313",
      "count": 24,
      "uuid": 139688303
    },
    {
      "user": "lamfy",
      "count": 2,
      "uuid": 51726801
    }
  ],
  "_userbio": {
    "uuid": 1618120,
    "type": "user",
    "name": "singator"
  },
  "_downloads": {
    "count": 189,
    "source": "https://cranlogs.r-pkg.org/downloads/total/last-month/grouper"
  },
  "_devurl": "https://github.com/zimmy313/grouper",
  "_pkgdown": "https://Zimmy313.github.io/grouper/",
  "_searchresults": 17,
  "_rbuild": "4.6.0",
  "_assets": [
    "extra/citation.cff",
    "extra/citation.html",
    "extra/citation.json",
    "extra/citation.txt",
    "extra/contents.json",
    "extra/grouper.html",
    "extra/NEWS.html",
    "extra/NEWS.txt",
    "extra/readme.html",
    "extra/readme.md",
    "manual.pdf"
  ],
  "_homeurl": "https://github.com/singator/grouper",
  "_realowner": "singator",
  "_cranurl": true,
  "_releases": [
    {
      "version": "0.3.1",
      "date": "2025-07-09"
    },
    {
      "version": "0.5.0",
      "date": "2025-10-16"
    }
  ],
  "_exports": [
    "%>%",
    "assign_groups",
    "assign_job",
    "extract_info",
    "extract_params_yaml",
    "extract_phd_info",
    "extract_student_info",
    "prepare_diversity_model",
    "prepare_model",
    "prepare_phd_model",
    "prepare_preference_model"
  ],
  "_datasets": [
    {
      "name": "dba_gc_ex001",
      "title": "DBA Group Composition Data Example 001",
      "object": "dba_gc_ex001",
      "class": [
        "data.frame"
      ],
      "fields": [
        "id",
        "major",
        "skill",
        "groups"
      ],
      "rows": 4,
      "table": true,
      "tojson": true
    },
    {
      "name": "dba_gc_ex003",
      "title": "",
      "object": "dba_gc_ex003",
      "class": [
        "data.frame"
      ],
      "fields": [
        "year",
        "major",
        "self_groups",
        "id"
      ],
      "rows": 4,
      "table": true,
      "tojson": true
    },
    {
      "name": "dba_gc_ex004",
      "title": "",
      "object": "dba_gc_ex004",
      "class": [
        "data.frame"
      ],
      "fields": [
        "id",
        "python",
        "self_groups"
      ],
      "rows": 5,
      "table": true,
      "tojson": true
    },
    {
      "name": "pba_gc_ex002",
      "title": "PBA Group Composition Data Example 002",
      "object": "pba_gc_ex002",
      "class": [
        "data.frame"
      ],
      "fields": [
        "id",
        "grouping"
      ],
      "rows": 8,
      "table": true,
      "tojson": true
    },
    {
      "name": "pba_prefmat_ex002",
      "title": "PBA Group Preference Data Example 002",
      "object": "pba_prefmat_ex002",
      "class": [
        "matrix",
        "array"
      ],
      "fields": [
        "col1",
        "col2",
        "col3",
        "col4"
      ],
      "rows": 4,
      "table": true,
      "tojson": true
    },
    {
      "name": "phd_demand_ex001",
      "title": "PhD Demand Matrix Example 001",
      "object": "phd_demand_ex001",
      "class": [
        "matrix",
        "array"
      ],
      "fields": [
        "TA",
        "GR"
      ],
      "rows": 4,
      "table": true,
      "tojson": true
    },
    {
      "name": "phd_prefmat_ex001",
      "title": "PhD Preference Matrix Example 001",
      "object": "phd_prefmat_ex001",
      "class": [
        "matrix",
        "array"
      ],
      "fields": [
        "C101",
        "C102",
        "C103",
        "C104"
      ],
      "rows": 4,
      "table": true,
      "tojson": true
    },
    {
      "name": "phd_students_ex001",
      "title": "PhD Student Data Example 001",
      "object": "phd_students_ex001",
      "class": [
        "data.frame"
      ],
      "fields": [
        "student_id",
        "year",
        "past_ta",
        "past_gr",
        "Name"
      ],
      "rows": 4,
      "table": true,
      "tojson": true
    }
  ],
  "_help": [
    {
      "page": "assign_groups",
      "title": "Assigns model result to the original data frame.",
      "topics": [
        "assign_groups"
      ]
    },
    {
      "page": "assign_job",
      "title": "Convert PhD solver allocation to manual-style wide table",
      "topics": [
        "assign_job"
      ]
    },
    {
      "page": "dba_gc_ex001",
      "title": "DBA Group Composition Data Example 001",
      "topics": [
        "dba_gc_ex001"
      ]
    },
    {
      "page": "extract_info",
      "title": "Extract model inputs (wrapper)",
      "topics": [
        "extract_info"
      ]
    },
    {
      "page": "extract_params_yaml",
      "title": "Extract parameters from a YAML file",
      "topics": [
        "extract_params_yaml"
      ]
    },
    {
      "page": "extract_phd_info",
      "title": "Extract inputs for the PhD workload allocation model",
      "topics": [
        "extract_phd_info"
      ]
    },
    {
      "page": "extract_student_info",
      "title": "Extract student information",
      "topics": [
        "extract_student_info"
      ]
    },
    {
      "page": "pba_gc_ex002",
      "title": "PBA Group Composition Data Example 002",
      "topics": [
        "pba_gc_ex002"
      ]
    },
    {
      "page": "pba_prefmat_ex002",
      "title": "PBA Group Preference Data Example 002",
      "topics": [
        "pba_prefmat_ex002"
      ]
    },
    {
      "page": "phd_demand_ex001",
      "title": "PhD Demand Matrix Example 001",
      "topics": [
        "phd_demand_ex001"
      ]
    },
    {
      "page": "phd_prefmat_ex001",
      "title": "PhD Preference Matrix Example 001",
      "topics": [
        "phd_prefmat_ex001"
      ]
    },
    {
      "page": "phd_students_ex001",
      "title": "PhD Student Data Example 001",
      "topics": [
        "phd_students_ex001"
      ]
    },
    {
      "page": "prepare_diversity_model",
      "title": "Prepare the diversity-based assignment model",
      "topics": [
        "prepare_diversity_model"
      ]
    },
    {
      "page": "prepare_model",
      "title": "Initialise optimisation model (wrapper)",
      "topics": [
        "prepare_model"
      ]
    },
    {
      "page": "prepare_phd_model",
      "title": "Prepare the PhD workload allocation model",
      "topics": [
        "prepare_phd_model"
      ]
    },
    {
      "page": "prepare_preference_model",
      "title": "Prepare the preference-based assignment model",
      "topics": [
        "prepare_preference_model"
      ]
    }
  ],
  "_readme": "https://github.com/singator/grouper/raw/HEAD/README.md",
  "_rundeps": [
    "cli",
    "cluster",
    "data.table",
    "dplyr",
    "fastmap",
    "generics",
    "glue",
    "lattice",
    "lazyeval",
    "lifecycle",
    "listcomp",
    "magrittr",
    "Matrix",
    "ompr",
    "pillar",
    "pkgconfig",
    "R6",
    "rlang",
    "tibble",
    "tidyselect",
    "utf8",
    "vctrs",
    "withr",
    "yaml"
  ],
  "_vignettes": [
    {
      "source": "d-sanity-checks.Rmd",
      "filename": "d-sanity-checks.html",
      "title": "Application to simple datasets",
      "engine": "knitr::rmarkdown",
      "headings": [
        "Introduction",
        "Diversity-Based Assignment",
        "Dataset 001 (diversity only)",
        "Dataset 001 (skills only)",
        "Dataset 003",
        "Dataset 004",
        "Preference-Based Assignment",
        "Dataset 002",
        "PhD Workload Assignment",
        "Dataset 001(Year-long)",
        "Dataset 001 (Single-semester)"
      ],
      "created": "2025-06-27 16:45:30",
      "modified": "2026-05-15 03:28:09",
      "commits": 4
    },
    {
      "source": "b-diversity-skill.Rmd",
      "filename": "b-diversity-skill.html",
      "title": "Maximising Diversity and Balancing Skill",
      "engine": "knitr::rmarkdown",
      "headings": [
        "Model introduction",
        "Objective function",
        "Constraints",
        "Group to topic-repetition combination",
        "Defining $z_{ijtr}$",
        "Number of repetitions per topic",
        "Number of students per group",
        "Per-group skill levels",
        "Binary and non-negativity constraints"
      ],
      "created": "2025-06-27 16:45:30",
      "modified": "2025-06-27 16:45:30",
      "commits": 1
    },
    {
      "source": "c-subgroups-preference.Rmd",
      "filename": "c-subgroups-preference.html",
      "title": "Maximising Preference",
      "engine": "knitr::rmarkdown",
      "headings": [
        "Model introduction",
        "Objective function",
        "Constraints",
        "Group to topic-repetition combination",
        "Number of repetitions per topic",
        "Balanced number of subgroups",
        "Number of students per subgroup",
        "Binary and non-negativity constraints"
      ],
      "created": "2025-06-27 16:45:30",
      "modified": "2025-06-27 16:45:30",
      "commits": 1
    },
    {
      "source": "e-phd-workload.Rmd",
      "filename": "e-phd-workload.html",
      "title": "PhD Workload Allocation",
      "engine": "knitr::rmarkdown",
      "headings": [
        "Model introduction",
        "Objective function",
        "Constraints",
        "Demand satisfaction",
        "TA spread among non-Year-1 students",
        "Annual workload equality",
        "Year-1 TA soft upper bound",
        "Optional current-semester workload bounds"
      ],
      "created": "2026-04-28 12:19:50",
      "modified": "2026-04-28 12:19:50",
      "commits": 1
    },
    {
      "source": "a-related-work.Rmd",
      "filename": "a-related-work.html",
      "title": "Related work and grouper",
      "engine": "knitr::rmarkdown",
      "headings": [
        "Introduction",
        "Balancing staff workload and student preferences",
        "OptAssign",
        "Students to elective courses",
        "Assigning students to groups based on traits",
        "Student-to-project supervisor assignment",
        "Automated group assignments in academic setting",
        "Introducing grouper package",
        "References"
      ],
      "created": "2025-06-27 16:45:30",
      "modified": "2026-05-15 03:28:09",
      "commits": 5
    }
  ],
  "_score": 6.133538908370218,
  "_indexed": true,
  "_nocasepkg": "grouper",
  "_universes": [
    "singator",
    "zimmy313"
  ],
  "_binaries": [
    {
      "r": "4.7.0",
      "os": "linux",
      "version": "0.6.2",
      "date": "2026-05-15T06:34:15.000Z",
      "distro": "noble",
      "commit": "e0160718a750afda01254886948dd36433e4dac3",
      "fileid": "06d4dbd03a949a2b708ebc7cbcc8983e13fa07bdfecc190812749a07fb0bbd00",
      "status": "success",
      "check": "WARNING",
      "buildurl": "https://github.com/r-universe/singator/actions/runs/25903940372"
    },
    {
      "r": "4.6.0",
      "os": "linux",
      "version": "0.6.2",
      "date": "2026-05-15T06:34:01.000Z",
      "distro": "noble",
      "commit": "e0160718a750afda01254886948dd36433e4dac3",
      "fileid": "da6b58a8dfb389f33daabe54153ac6c1eab973f91535f412f6550fcb5d83359d",
      "status": "success",
      "check": "WARNING",
      "buildurl": "https://github.com/r-universe/singator/actions/runs/25903940372"
    },
    {
      "r": "4.5.3",
      "os": "mac",
      "version": "0.6.2",
      "date": "2026-05-15T06:33:33.000Z",
      "commit": "e0160718a750afda01254886948dd36433e4dac3",
      "fileid": "bdf705d000056fdb0f7420cbb40960aad18c8be32b06e6620a3529dde6a4de1a",
      "status": "success",
      "check": "WARNING",
      "buildurl": "https://github.com/r-universe/singator/actions/runs/25903940372"
    },
    {
      "r": "4.6.0",
      "os": "mac",
      "version": "0.6.2",
      "date": "2026-05-15T06:33:29.000Z",
      "commit": "e0160718a750afda01254886948dd36433e4dac3",
      "fileid": "ff51bd834b27234248f9c04d3d415d6dbc16098bc69ba66b5d30973c24b554f2",
      "status": "success",
      "check": "WARNING",
      "buildurl": "https://github.com/r-universe/singator/actions/runs/25903940372"
    },
    {
      "r": "4.7.0",
      "os": "win",
      "version": "0.6.2",
      "date": "2026-05-15T06:33:17.000Z",
      "commit": "e0160718a750afda01254886948dd36433e4dac3",
      "fileid": "41c111124451ebefd494e88dc279e25c96438fa1ccfcfafc1dfbbaf79e3d97e3",
      "status": "success",
      "check": "WARNING",
      "buildurl": "https://github.com/r-universe/singator/actions/runs/25903940372"
    },
    {
      "r": "4.5.3",
      "os": "win",
      "version": "0.6.2",
      "date": "2026-05-15T06:33:11.000Z",
      "commit": "e0160718a750afda01254886948dd36433e4dac3",
      "fileid": "1bfe5df1a69816bb0c556c0d28ee4e3e50dff699d5f949da2c2521b8f286c981",
      "status": "success",
      "check": "WARNING",
      "buildurl": "https://github.com/r-universe/singator/actions/runs/25903940372"
    },
    {
      "r": "4.6.0",
      "os": "win",
      "version": "0.6.2",
      "date": "2026-05-15T06:33:16.000Z",
      "commit": "e0160718a750afda01254886948dd36433e4dac3",
      "fileid": "7028f5d13b0aa5cd0230095eb7ceca0a068dd81b54b98a5c1bc053bc470d5e53",
      "status": "success",
      "check": "WARNING",
      "buildurl": "https://github.com/r-universe/singator/actions/runs/25903940372"
    },
    {
      "r": "4.6.0",
      "os": "wasm",
      "version": "0.6.2",
      "date": "2026-06-02T19:57:13.000Z",
      "commit": "e0160718a750afda01254886948dd36433e4dac3",
      "fileid": "132e7b2bbc1d7f8a2382f96cfb3db98e29607a63813e1574bc3c762d87b69270",
      "status": "success",
      "buildurl": "https://github.com/r-universe/singator/actions/runs/25903940372"
    }
  ]
}