dwww Home | Manual pages | Find package

AUTO-MULTIPLE-CHOI(1)        Auto Multiple Choice        AUTO-MULTIPLE-CHOI(1)

NAME
       auto-multiple-choice-export - exports marks for AMC multiple choice
       exams.

SYNOPSIS
       auto-multiple-choice export --data project-data-dir --module module
                            --fich-noms students-list.csv
                            [--noms-encodage list-encoding] --o output-file

DESCRIPTION
       The auto-multiple-choice export command exports marks from an Auto
       Multiple Choice exam.

       --data project-data-dir
           gives the directory where data files are (see for example auto-
           multiple-choice-prepare(1)).

       --module module
           selects a module for export. See below for the modules included in
           the AMC standard distribution.

       --fich-noms students-list.csv
           sets the students list file.

       --noms-encodage list-encoding
           selects an encoding for file students-list.csv (default is utf-8).

       --o output-file
           gives the output file name.

       --option-out options
           gives an option for selected module, in the form key=value (see
           below for possible options for each module). To specify multiple
           options, use --option several times.

       --sort sort-type
           sort the students names, depending on sort-type. If sort-type is l,
           use line number from students list file to sort. If sort-type is m,
           use mark (and name if marks are equal) to sort. If sort-type is i,
           use student number to sort. If sort-type is n, use name to sort (or
           line from students list if equal).

       --useall all
           if all is 0 or empty, only students with a scanned answer sheet
           appears in the output. If all is 1, all students in the students
           list appears in the output.

MODULES
   OpenDocument
       With "--module ods", an OpenDocument (for use by OpenOffice or
       LibreOffice for example) is produced. The following options are
       recognized:

       nom
           gives a name for the exam, to be written on the beginning of the
           sheet.

       code
           gives an short name for the exam, to be used as a tab name.

       columns
           sets the list of columns that are to be added to each student.

           Default value is student.key,student.name.

       stats
           with a true value, a table will be added with statistics for all
           questions.

       statsindic
           with a true value, a table will be added with statistics for all
           indicative questions.

   CSV
       With "--module CSV", a CSV file is produced. The following options are
       recognized:

       columns
           sets the list of columns that are to be added to each student.

           Default value is student.copy,student.key,student.name.

       decimal
           sets the decimal point (default is a dot).

       encodage
           sets the encoding to use for output (default is utf-8).

       separateur
           sets the character used between columns (default is a comma).

       entoure
           sets the character used to enclose strings (default is a double
           quote).

       ticked
           if not empty, additional columns (with "CHECKED:" prefix) are
           included to give all the checked boxes on all the sheets. This can
           be used by an external program to retrieve all the checked boxes
           when marks are not sufficient. Use value 01 to get 0;0;1;1;0 if
           boxes 3 and 4 are checked, and value AB to get CD if boxes 3 and 4
           are checked.

   List
       With "--module List", a PDF file is produced with a list of marks for
       all students. The following options are recognized:

       pagesize
           The page size. Default value is a4.

       nom
           gives the name of the exam, to be printed at the top of the page.

       ncols
           The number of columns. Default value is 2.

       decimal
           sets the decimal point (default is a dot).

AUTHORS
       Alexis Bienvenüe <paamc@passoire.fr>
           Main author

       Anirvan Sarkar
           Author and Editor

       Hiroto Kagotani
           Editor

       Frédéric Bréal
           Author and Editor

       Jean Bérard
           Translation from French

       Georges Khaznadar
           Translation from French

COPYRIGHT
       Copyright © 2008-2022 Alexis Bienvenüe

       This document can be used according to the terms of the GNU General
       Public License, version 2 or later.

Auto Multiple Choice 1.6.0        2023-02-06             AUTO-MULTIPLE-CHOI(1)

Generated by dwww version 1.15 on Fri Jun 28 02:28:11 CEST 2024.