https://github.com/mwt/crowdmark-labeler
a Python function which automatically labels exams outputted by Crowdmark
https://github.com/mwt/crowdmark-labeler
booklets crowdmark crowdmark-labeler exam labeled-booklets labels-dataframe pdf pdf-generation
Last synced: 4 months ago
JSON representation
a Python function which automatically labels exams outputted by Crowdmark
- Host: GitHub
- URL: https://github.com/mwt/crowdmark-labeler
- Owner: mwt
- License: mit
- Created: 2020-02-09T00:23:07.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-03-15T02:36:39.000Z (over 4 years ago)
- Last Synced: 2025-05-20T00:40:00.123Z (5 months ago)
- Topics: booklets, crowdmark, crowdmark-labeler, exam, labeled-booklets, labels-dataframe, pdf, pdf-generation
- Language: Python
- Homepage: https://pypi.org/project/clabeler/1.0.0/
- Size: 514 KB
- Stars: 10
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Crowdmark Labeler
This is a Python package which automatically labels exams outputted by Crowdmark using the names of students provided in a `pandas` dataframe. This script depends on `pdfrw`, `reportlab`, and `pandas`. This is designed for assessments which have the "Enable automated matching" option enabled when booklets are generated in Crowdmark. The script will fill the name box that looks like this:
to make it look like this
## Enviroment
You can install this package with:
```
pip install clabeler
```
## CLI
This package can be called from the command line using the `clabeler` command. It has three required arguments and several optional arguments to set the output and to allow for different column labels in the inputted data.
```
usage: clabeler [-h] [-O OUTPUT] [--colfname COLFNAME] [--collname COLLNAME] [--colid COLID] labels booklets pagecount
Label exam PDFs from Crowdmark with names of students.
positional arguments:
labels path to a csv containing labels
booklets path to PDF of unlabeled exams
pagecount number of pages per exam
optional arguments:
-h, --help show this help message and exit
-O OUTPUT path to output unlabeled exams
--colfname COLFNAME column label for student's first name
--collname COLLNAME column label for student's last name
--colid COLID column label for student ID
```
## Function
In addition to the command line interface, this package defines the function `labelbooklets` defined in the following way:
```python
def labelbooklets(labels, pagecount, booklets="booklets.pdf", output="labeled_booklets.pdf", colfname="fname", collname="lname", colid="netID"):
```
the function takes the same arguments:
* **labels:** A pandas dataframe containing the student names and netIDs
* **pagecount:** The number of pages in each exam
* **booklets:** The path to the exam booklets generated by Crowdmark; defaults to "booklets.pdf" in the working directory
* **output:** The path to output the labeled booklets; defaults to "labeled_booklets.pdf" in the working directory
* **colfname:** The name of your student first name column in your labels dataframe; defaults to "fname"
* **collname:** The name of your student last name column in your labels dataframe; defaults to "lname"
* **colid:** The name of your student ID column in your labels dataframe; defaults to "netID"
## Example
An example is provided in the example folder. It contains:
* an excel spreadsheet of fake names called [`labels.xlsx`](example/labels.xlsx) and an identical tab delimited file called [`labels.txt`](example/labels.txt)
* a fake exam with a Crowdmark name box called [`booklets.pdf`](example/booklets.pdf)
* a script that calls the `labelbooklets ` function called [`example.py`](example/example.py)
The output of this example is the included [`labeled_booklets.pdf`](example/labeled_booklets.pdf)
## License
Crowdmark Labeler is licensed under the [MIT License](LICENSE).
## FAQ
Why does the inserted text look different/bad on my device?
> The script uses the font "Courier" when inserting text. While all versions of Acrobat reader, Windows, and Mac OSX have this font, not all readers and systems do (eg. Android). This is not a limitation unless you intend to print with a device that does not support this font.
Does this support documents with A4, legal, etc. paper?
> No, it only supports letter paper at the moment. It should be easy to add other formats. Please create an issue (or pull request) if you would like to see any other paper size supported.