{"id":21442228,"url":"https://github.com/thotypous/sdaps","last_synced_at":"2025-07-06T05:39:26.272Z","repository":{"id":69726851,"uuid":"503110455","full_name":"thotypous/sdaps","owner":"thotypous","description":"Scripts for data acquisition with paper based surveys (UFSCar branch)","archived":false,"fork":false,"pushed_at":"2024-04-28T01:58:41.000Z","size":6928,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"ufscar","last_synced_at":"2025-01-23T10:43:25.512Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/thotypous.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-06-13T20:48:45.000Z","updated_at":"2024-04-28T01:58:45.000Z","dependencies_parsed_at":"2024-04-28T03:53:59.852Z","dependency_job_id":"96ccf41c-ddef-4a4c-9a1f-b5112be7618b","html_url":"https://github.com/thotypous/sdaps","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thotypous%2Fsdaps","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thotypous%2Fsdaps/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thotypous%2Fsdaps/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thotypous%2Fsdaps/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thotypous","download_url":"https://codeload.github.com/thotypous/sdaps/tar.gz/refs/heads/ufscar","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243955721,"owners_count":20374372,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-23T01:53:08.369Z","updated_at":"2025-03-17T00:45:29.158Z","avatar_url":"https://github.com/thotypous.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SDAPS\n\nThis Program can be used to carry out paper based surveys.\n\nSDAPS uses a specialised LaTeX class to define questionnaires. This is tightly\nintegrated and is an easy way to create machine readable questionnaires.\n\nAfter this, the program can create an arbitrary number of (unique)\nquestionnaires that can be printed and handed out. After being filled out, you\njust scan them in, let sdaps run over them, and let it create a report with\nthe results.\n\nThe main LaTeX class is also available on CTAN (https://ctan.org/pkg/sdaps) and\nmay also be installed directly, e.g. using a LaTeX distribution like TeX Live.\nPlease check whether you can install it that way, and if not choose the\n`--build-tex` or `--install-tex` for building/installing SDAPS.\n\n## Requirements\n\nDepending on what part of SDAPS you use, different dependencies are\nrequired.\n\ngeneral (including recognize):\n * Python 3.6\n * distutils and distutils-extra\n * python3-cairo (including development files)\n * libtiff (including development files)\n * pkg-config\n * zbarimg binary for \"code128\" and \"qr\" styles\n * python3 development files\n\ngraphical user interface (gui):\n * GTK+ and introspection data\n * python3-gi\n\nreportlab based reports (report):\n * reportlab\n * Python Imaging Library (PIL)\n\nLaTeX based questionnaires (setup_tex/stamp):\n * pdflatex and packages:\n   * PGF/TikZ\n   * translator (part of beamer)\n   * and more\n\nLaTeX based reports:\n * pdflatex and packages:\n   * PGF/TikZ\n   * translator (part of beamer)\n * siunitx\n\nImport of other image formats (convert, add --convert):\n * python3-opencv\n * Poppler and introspection data\n * python3-gi\n\nExport to feather format:\n * python3-pandas\n * pyarrows\n\nDebug output (annotate):\n * Poppler and introspection data\n * python3-gi\n\n## Installation\n\nYou can install sdaps using `./setup.py install` or\n`./setup.py install --install-tex`. The C extension will be compiled\nautomatically, but of course you have to have all the dependencies installed\nfor this to work. When `--install-tex` is passed, the LaTeX class files\nwill also be installed. This is only necessary if your LaTeX distribution\ndoes not yet include the sdaps package.\n\nPlease note that this git repository uses submodules to pull in the LaTeX\ncode. This means you need to run\n $ git submodule init\nand then run\n $ git submodule update\nto checkout and update the repository after a pull.\n\nAlternatively, do the initial clone using \"git clone --recursive\".\n\n## Standalone execution\n\nAs an alternative to installing sdaps it is also supported to run it without\ninstallation. To do this run `./setup.py build` or\n`./setup.py build --build-tex` to build the binary modules, translation and\npossibly LaTeX class files. After this execute sdaps using the provided\n`sdaps.py` script in the toplevel directory.\n\nAdding `--build-tex` is only neccessary when testing the latest version of the\nLaTeX class or if the class is not already installed using other means (e.g.\ndistribution LaTeX installation).\n\n## Using SDAPS\n\nPlease run sdaps with \"--help\" after installing it for a list of commands.\nAlso check the website http://sdaps.org for some examples.\n\n## Quality of the recognition\n\nThe quality of the recognition in SDAPS is quite good in my experience.\nThere is a certain amount of wrong detections, that mostly arise from people\nnot checking or filling out the boxes correctly. For example:\n * The cross is not inside the checkbox, but next to it\n * People cross the same box multiple times\n * People use very thick pens\n * Filling out is not done properly\n\nAs you can see, most of the errors arise from the possibility to correct\nwrong marks by filling out checkboxes. SDAPS tries to be smart about this\nby using different heuristics to detect the case, but it is not foolproof.\n\nSuggestions on how to decrease the error rate are of course welcome.\n\n### Matrix Errors\n\nIt can happen that SDAPS is not able to calculate the transformation matrix\nwhich transforms the pixel space of the image into the mm coordinate system\nused internally. If this happens the affected pages cannot be further\nanalysed.\nIt is usually possible to manually correct them using the GUI, but that can\nbe quite tedious.\n\nSee also TROUBLESHOOTING for some more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthotypous%2Fsdaps","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthotypous%2Fsdaps","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthotypous%2Fsdaps/lists"}