omrkit 2.1.0__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- omrkit/__init__.py +76 -0
- omrkit/__main__.py +6 -0
- omrkit/api/__init__.py +5 -0
- omrkit/api/app.py +75 -0
- omrkit/api/routes.py +490 -0
- omrkit/api/settings.py +55 -0
- omrkit/api/static/assets/index-BFfdzDls.js +224 -0
- omrkit/api/static/assets/index-DRPOjlrM.css +1 -0
- omrkit/api/static/index.html +23 -0
- omrkit/cli/__init__.py +5 -0
- omrkit/cli/app.py +440 -0
- omrkit/core/__init__.py +44 -0
- omrkit/core/auto_scanner.py +132 -0
- omrkit/core/benchmark.py +204 -0
- omrkit/core/migrator.py +149 -0
- omrkit/core/scanner.py +281 -0
- omrkit/core/validators.py +62 -0
- omrkit/generator/__init__.py +13 -0
- omrkit/generator/pdf_sheet.py +508 -0
- omrkit/generator/presets.py +109 -0
- omrkit/grading/__init__.py +6 -0
- omrkit/grading/analytics.py +177 -0
- omrkit/grading/grader.py +191 -0
- omrkit/io/__init__.py +37 -0
- omrkit/io/exporters.py +355 -0
- omrkit/io/loader.py +207 -0
- omrkit/models/__init__.py +65 -0
- omrkit/models/grading.py +222 -0
- omrkit/models/scan.py +100 -0
- omrkit/models/template.py +285 -0
- omrkit/py.typed +0 -0
- omrkit/vision/__init__.py +30 -0
- omrkit/vision/detector.py +313 -0
- omrkit/vision/grid_finder.py +280 -0
- omrkit/vision/preprocess.py +57 -0
- omrkit/vision/qr.py +83 -0
- omrkit/vision/registration.py +486 -0
- omrkit/vision/visualizer.py +99 -0
- omrkit-2.1.0.dist-info/METADATA +284 -0
- omrkit-2.1.0.dist-info/RECORD +43 -0
- omrkit-2.1.0.dist-info/WHEEL +4 -0
- omrkit-2.1.0.dist-info/entry_points.txt +2 -0
- omrkit-2.1.0.dist-info/licenses/LICENSE +21 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
/*! tailwindcss v4.3.5 | MIT License | https://tailwindcss.com */@layer properties{@supports (((-webkit-hyphens:none)) and (not (margin-trim:block))) or ((-moz-orient:inline) and (not (color:rgb(from red r g b)))){*,:before,:after,::backdrop{--tw-space-y-reverse:0;--tw-divide-y-reverse:0;--tw-border-style:solid;--tw-leading:initial;--tw-font-weight:initial;--tw-tracking:initial;--tw-shadow:0 0 #0000;--tw-shadow-color:initial;--tw-shadow-alpha:100%;--tw-inset-shadow:0 0 #0000;--tw-inset-shadow-color:initial;--tw-inset-shadow-alpha:100%;--tw-ring-color:initial;--tw-ring-shadow:0 0 #0000;--tw-inset-ring-color:initial;--tw-inset-ring-shadow:0 0 #0000;--tw-ring-inset:initial;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-offset-shadow:0 0 #0000;--tw-backdrop-blur:initial;--tw-backdrop-brightness:initial;--tw-backdrop-contrast:initial;--tw-backdrop-grayscale:initial;--tw-backdrop-hue-rotate:initial;--tw-backdrop-invert:initial;--tw-backdrop-opacity:initial;--tw-backdrop-saturate:initial;--tw-backdrop-sepia:initial}}}@layer theme{:root,:host{--font-sans:-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji";--font-mono:ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace;--color-red-200:oklch(88.5% .062 18.334);--color-amber-500:oklch(76.9% .188 70.08);--color-emerald-400:oklch(76.5% .177 163.223);--color-white:#fff;--spacing:.25rem;--container-xs:20rem;--container-sm:24rem;--container-md:28rem;--text-xs:.75rem;--text-xs--line-height:calc(1 / .75);--text-sm:.875rem;--text-sm--line-height:calc(1.25 / .875);--text-lg:1.125rem;--text-lg--line-height:calc(1.75 / 1.125);--font-weight-medium:500;--font-weight-semibold:600;--font-weight-bold:700;--tracking-tight:-.025em;--tracking-wider:.05em;--leading-tight:1.25;--leading-relaxed:1.625;--radius-md:.375rem;--radius-lg:.5rem;--animate-spin:spin 1s linear infinite;--animate-pulse:pulse 2s cubic-bezier(.4, 0, .6, 1) infinite;--aspect-video:16 / 9;--default-transition-duration:.15s;--default-transition-timing-function:cubic-bezier(.4, 0, .2, 1);--default-font-family:var(--font-sans);--default-mono-font-family:var(--font-mono)}}@layer base{*,:after,:before,::backdrop{box-sizing:border-box;border:0 solid;margin:0;padding:0}::file-selector-button{box-sizing:border-box;border:0 solid;margin:0;padding:0}html,:host{-webkit-text-size-adjust:100%;-moz-tab-size:4;tab-size:4;line-height:1.5;font-family:var(--default-font-family,-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", "Noto Sans", Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji");font-feature-settings:var(--default-font-feature-settings,normal);font-variation-settings:var(--default-font-variation-settings,normal);-webkit-tap-highlight-color:transparent}hr{height:0;color:inherit;border-top-width:1px}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;-webkit-text-decoration:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,samp,pre{font-family:var(--default-mono-font-family,ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace);font-feature-settings:var(--default-mono-font-feature-settings,normal);font-variation-settings:var(--default-mono-font-variation-settings,normal);font-size:1em}small{font-size:80%}sub,sup{vertical-align:baseline;font-size:75%;line-height:0;position:relative}sub{bottom:-.25em}sup{top:-.5em}table{text-indent:0;border-color:inherit;border-collapse:collapse}:-moz-focusring:where(:not(iframe)){outline:auto}progress{vertical-align:baseline}summary{display:list-item}ol,ul,menu{list-style:none}img,svg,video,canvas,audio,iframe,embed,object{vertical-align:middle;display:block}img,video{max-width:100%;height:auto}button,input,select,optgroup,textarea{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}::file-selector-button{font:inherit;font-feature-settings:inherit;font-variation-settings:inherit;letter-spacing:inherit;color:inherit;opacity:1;background-color:#0000;border-radius:0}:where(select:is([multiple],[size])) optgroup{font-weight:bolder}:where(select:is([multiple],[size])) optgroup option{padding-inline-start:20px}::file-selector-button{margin-inline-end:4px}::placeholder{opacity:1}@supports (not ((-webkit-appearance:-apple-pay-button))) or (contain-intrinsic-size:1px){::placeholder{color:currentColor}@supports (color:color-mix(in lab,red,red)){::placeholder{color:color-mix(in oklab,currentcolor 50%,transparent)}}}textarea{resize:vertical}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-date-and-time-value{min-height:1lh;text-align:inherit}::-webkit-datetime-edit{display:inline-flex}::-webkit-datetime-edit-fields-wrapper{padding:0}::-webkit-datetime-edit{padding-block:0}::-webkit-datetime-edit-year-field{padding-block:0}::-webkit-datetime-edit-month-field{padding-block:0}::-webkit-datetime-edit-day-field{padding-block:0}::-webkit-datetime-edit-hour-field{padding-block:0}::-webkit-datetime-edit-minute-field{padding-block:0}::-webkit-datetime-edit-second-field{padding-block:0}::-webkit-datetime-edit-millisecond-field{padding-block:0}::-webkit-datetime-edit-meridiem-field{padding-block:0}::-webkit-calendar-picker-indicator{line-height:1}:-moz-ui-invalid{box-shadow:none}button,input:where([type=button],[type=reset],[type=submit]){-webkit-appearance:button;-moz-appearance:button;appearance:button}::file-selector-button{-webkit-appearance:button;-moz-appearance:button;appearance:button}::-webkit-inner-spin-button{height:auto}::-webkit-outer-spin-button{height:auto}[hidden]:where(:not([hidden=until-found])){display:none!important}html,body{background-color:var(--surface-paper);color:var(--ink-primary);-webkit-font-smoothing:antialiased;font-family:Inter,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif}code,pre,.font-mono{font-family:JetBrains Mono,ui-monospace,SFMono-Regular,Menlo,monospace}}@layer components;@layer utilities{.pointer-events-none{pointer-events:none}.absolute{position:absolute}.relative{position:relative}.static{position:static}.sticky{position:sticky}.inset-6{inset:calc(var(--spacing) * 6)}.-top-0\.5{top:calc(var(--spacing) * -.5)}.top-0{top:0}.top-3{top:calc(var(--spacing) * 3)}.-right-0\.5{right:calc(var(--spacing) * -.5)}.-bottom-0\.5{bottom:calc(var(--spacing) * -.5)}.-left-0\.5{left:calc(var(--spacing) * -.5)}.left-3{left:calc(var(--spacing) * 3)}.z-20{z-index:20}.col-span-2{grid-column:span 2/span 2}.mx-auto{margin-inline:auto}.my-auto{margin-block:auto}.mt-0\.5{margin-top:calc(var(--spacing) * .5)}.mt-1{margin-top:var(--spacing)}.mb-2{margin-bottom:calc(var(--spacing) * 2)}.ml-0\.5{margin-left:calc(var(--spacing) * .5)}.ml-2{margin-left:calc(var(--spacing) * 2)}.block{display:block}.flex{display:flex}.grid{display:grid}.hidden{display:none}.inline{display:inline}.inline-flex{display:inline-flex}.aspect-video{aspect-ratio:var(--aspect-video)}.h-3{height:calc(var(--spacing) * 3)}.h-3\.5{height:calc(var(--spacing) * 3.5)}.h-4{height:calc(var(--spacing) * 4)}.h-5{height:calc(var(--spacing) * 5)}.h-6{height:calc(var(--spacing) * 6)}.h-7{height:calc(var(--spacing) * 7)}.h-8{height:calc(var(--spacing) * 8)}.h-9{height:calc(var(--spacing) * 9)}.h-14{height:calc(var(--spacing) * 14)}.h-28{height:calc(var(--spacing) * 28)}.h-44{height:calc(var(--spacing) * 44)}.h-full{height:100%}.max-h-32{max-height:calc(var(--spacing) * 32)}.max-h-40{max-height:calc(var(--spacing) * 40)}.max-h-60{max-height:calc(var(--spacing) * 60)}.max-h-64{max-height:calc(var(--spacing) * 64)}.max-h-80{max-height:calc(var(--spacing) * 80)}.max-h-\[68vh\]{max-height:68vh}.max-h-\[70vh\]{max-height:70vh}.max-h-\[72vh\]{max-height:72vh}.max-h-\[74vh\]{max-height:74vh}.max-h-\[75vh\]{max-height:75vh}.min-h-\[540px\]{min-height:540px}.min-h-\[600px\]{min-height:600px}.min-h-screen{min-height:100vh}.w-3{width:calc(var(--spacing) * 3)}.w-3\.5{width:calc(var(--spacing) * 3.5)}.w-4{width:calc(var(--spacing) * 4)}.w-5{width:calc(var(--spacing) * 5)}.w-6{width:calc(var(--spacing) * 6)}.w-7{width:calc(var(--spacing) * 7)}.w-8{width:calc(var(--spacing) * 8)}.w-9{width:calc(var(--spacing) * 9)}.w-11{width:calc(var(--spacing) * 11)}.w-20{width:calc(var(--spacing) * 20)}.w-24{width:calc(var(--spacing) * 24)}.w-auto{width:auto}.w-full{width:100%}.max-w-\[1440px\]{max-width:1440px}.max-w-full{max-width:100%}.max-w-md{max-width:var(--container-md)}.max-w-none{max-width:none}.max-w-sm{max-width:var(--container-sm)}.max-w-xs{max-width:var(--container-xs)}.min-w-0{min-width:0}.flex-1{flex:1}.shrink-0{flex-shrink:0}.animate-pulse{animation:var(--animate-pulse)}.animate-spin{animation:var(--animate-spin)}.cursor-crosshair{cursor:crosshair}.cursor-pointer{cursor:pointer}.grid-cols-1{grid-template-columns:repeat(1,minmax(0,1fr))}.grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}.grid-cols-5{grid-template-columns:repeat(5,minmax(0,1fr))}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-center{align-items:center}.items-end{align-items:flex-end}.items-start{align-items:flex-start}.justify-between{justify-content:space-between}.justify-center{justify-content:center}.justify-end{justify-content:flex-end}.gap-1{gap:var(--spacing)}.gap-1\.5{gap:calc(var(--spacing) * 1.5)}.gap-2{gap:calc(var(--spacing) * 2)}.gap-2\.5{gap:calc(var(--spacing) * 2.5)}.gap-3{gap:calc(var(--spacing) * 3)}.gap-4{gap:calc(var(--spacing) * 4)}.gap-5{gap:calc(var(--spacing) * 5)}:where(.space-y-1>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(var(--spacing) * var(--tw-space-y-reverse));margin-block-end:calc(var(--spacing) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-1\.5>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 1.5) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 1.5) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-2>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 2) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 2) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-2\.5>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 2.5) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 2.5) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-3>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 3) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 3) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-4>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 4) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 4) * calc(1 - var(--tw-space-y-reverse)))}:where(.space-y-5>:not(:last-child)){--tw-space-y-reverse:0;margin-block-start:calc(calc(var(--spacing) * 5) * var(--tw-space-y-reverse));margin-block-end:calc(calc(var(--spacing) * 5) * calc(1 - var(--tw-space-y-reverse)))}.gap-x-3{column-gap:calc(var(--spacing) * 3)}.gap-y-1{row-gap:var(--spacing)}:where(.divide-y>:not(:last-child)){--tw-divide-y-reverse:0;border-bottom-style:var(--tw-border-style);border-top-style:var(--tw-border-style);border-top-width:calc(1px * var(--tw-divide-y-reverse));border-bottom-width:calc(1px * calc(1 - var(--tw-divide-y-reverse)))}:where(.divide-\[var\(--border-hairline\)\]>:not(:last-child)){border-color:var(--border-hairline)}.truncate{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-x-auto{overflow-x:auto}.overflow-y-auto{overflow-y:auto}.rounded{border-radius:.25rem}.rounded-full{border-radius:2147483647px}.rounded-lg{border-radius:var(--radius-lg)}.rounded-md{border-radius:var(--radius-md)}.rounded-t{border-top-left-radius:.25rem;border-top-right-radius:.25rem}.border{border-style:var(--tw-border-style);border-width:1px}.border-2{border-style:var(--tw-border-style);border-width:2px}.border-t{border-top-style:var(--tw-border-style);border-top-width:1px}.border-t-2{border-top-style:var(--tw-border-style);border-top-width:2px}.border-r-2{border-right-style:var(--tw-border-style);border-right-width:2px}.border-b{border-bottom-style:var(--tw-border-style);border-bottom-width:1px}.border-b-2{border-bottom-style:var(--tw-border-style);border-bottom-width:2px}.border-l-2{border-left-style:var(--tw-border-style);border-left-width:2px}.border-dashed{--tw-border-style:dashed;border-style:dashed}.border-\[var\(--border-hairline\)\]{border-color:var(--border-hairline)}.border-\[var\(--border-strong\)\]{border-color:var(--border-strong)}.border-\[var\(--ink-primary\)\]{border-color:var(--ink-primary)}.border-\[var\(--signal-ok\)\]{border-color:var(--signal-ok)}.border-red-200{border-color:var(--color-red-200)}.border-transparent{border-color:#0000}.border-white{border-color:var(--color-white)}.border-white\/25{border-color:#ffffff40}@supports (color:color-mix(in lab,red,red)){.border-white\/25{border-color:color-mix(in oklab,var(--color-white) 25%,transparent)}}.bg-\[\#14181F\]{background-color:#14181f}.bg-\[var\(--ink-primary\)\]{background-color:var(--ink-primary)}.bg-\[var\(--signal-err-bg\)\]{background-color:var(--signal-err-bg)}.bg-\[var\(--signal-ok\)\]{background-color:var(--signal-ok)}.bg-\[var\(--signal-ok-bg\)\]{background-color:var(--signal-ok-bg)}.bg-\[var\(--signal-warn-bg\)\]{background-color:var(--signal-warn-bg)}.bg-\[var\(--surface-card\)\],.bg-\[var\(--surface-card\)\]\/95{background-color:var(--surface-card)}@supports (color:color-mix(in lab,red,red)){.bg-\[var\(--surface-card\)\]\/95{background-color:color-mix(in oklab,var(--surface-card) 95%,transparent)}}.bg-\[var\(--surface-paper\)\]{background-color:var(--surface-paper)}.bg-\[var\(--surface-subtle\)\]{background-color:var(--surface-subtle)}.bg-amber-500{background-color:var(--color-amber-500)}.bg-transparent{background-color:#0000}.bg-white{background-color:var(--color-white)}.object-contain{object-fit:contain}.object-cover{object-fit:cover}.p-2\.5{padding:calc(var(--spacing) * 2.5)}.p-3{padding:calc(var(--spacing) * 3)}.p-3\.5{padding:calc(var(--spacing) * 3.5)}.p-4{padding:calc(var(--spacing) * 4)}.p-5{padding:calc(var(--spacing) * 5)}.p-6{padding:calc(var(--spacing) * 6)}.p-8{padding:calc(var(--spacing) * 8)}.p-12{padding:calc(var(--spacing) * 12)}.\!px-2{padding-inline:calc(var(--spacing) * 2)!important}.\!px-2\.5{padding-inline:calc(var(--spacing) * 2.5)!important}.px-1\.5{padding-inline:calc(var(--spacing) * 1.5)}.px-2{padding-inline:calc(var(--spacing) * 2)}.px-2\.5{padding-inline:calc(var(--spacing) * 2.5)}.px-3{padding-inline:calc(var(--spacing) * 3)}.px-4{padding-inline:calc(var(--spacing) * 4)}.\!py-1{padding-block:var(--spacing)!important}.\!py-1\.5{padding-block:calc(var(--spacing) * 1.5)!important}.py-0\.5{padding-block:calc(var(--spacing) * .5)}.py-1{padding-block:var(--spacing)}.py-1\.5{padding-block:calc(var(--spacing) * 1.5)}.py-2{padding-block:calc(var(--spacing) * 2)}.py-3{padding-block:calc(var(--spacing) * 3)}.py-5{padding-block:calc(var(--spacing) * 5)}.py-8{padding-block:calc(var(--spacing) * 8)}.py-10{padding-block:calc(var(--spacing) * 10)}.py-12{padding-block:calc(var(--spacing) * 12)}.pt-1{padding-top:var(--spacing)}.pt-2{padding-top:calc(var(--spacing) * 2)}.pt-4{padding-top:calc(var(--spacing) * 4)}.text-center{text-align:center}.text-left{text-align:left}.text-right{text-align:right}.font-mono{font-family:var(--font-mono)}.text-lg{font-size:var(--text-lg);line-height:var(--tw-leading,var(--text-lg--line-height))}.text-sm{font-size:var(--text-sm);line-height:var(--tw-leading,var(--text-sm--line-height))}.text-xs{font-size:var(--text-xs);line-height:var(--tw-leading,var(--text-xs--line-height))}.text-\[9px\]{font-size:9px}.text-\[10px\]{font-size:10px}.text-\[11px\]{font-size:11px}.leading-relaxed{--tw-leading:var(--leading-relaxed);line-height:var(--leading-relaxed)}.leading-tight{--tw-leading:var(--leading-tight);line-height:var(--leading-tight)}.font-bold{--tw-font-weight:var(--font-weight-bold);font-weight:var(--font-weight-bold)}.font-medium{--tw-font-weight:var(--font-weight-medium);font-weight:var(--font-weight-medium)}.font-semibold{--tw-font-weight:var(--font-weight-semibold);font-weight:var(--font-weight-semibold)}.tracking-tight{--tw-tracking:var(--tracking-tight);letter-spacing:var(--tracking-tight)}.tracking-wider{--tw-tracking:var(--tracking-wider);letter-spacing:var(--tracking-wider)}.whitespace-nowrap{white-space:nowrap}.text-\[var\(--accent-cobalt\)\]{color:var(--accent-cobalt)}.text-\[var\(--ink-muted\)\]{color:var(--ink-muted)}.text-\[var\(--ink-primary\)\]{color:var(--ink-primary)}.text-\[var\(--ink-secondary\)\]{color:var(--ink-secondary)}.text-\[var\(--signal-err\)\]{color:var(--signal-err)}.text-\[var\(--signal-ok\)\]{color:var(--signal-ok)}.text-\[var\(--signal-warn\)\]{color:var(--signal-warn)}.text-emerald-400{color:var(--color-emerald-400)}.text-white{color:var(--color-white)}.text-white\/60{color:#fff9}@supports (color:color-mix(in lab,red,red)){.text-white\/60{color:color-mix(in oklab,var(--color-white) 60%,transparent)}}.text-white\/75{color:#ffffffbf}@supports (color:color-mix(in lab,red,red)){.text-white\/75{color:color-mix(in oklab,var(--color-white) 75%,transparent)}}.uppercase{text-transform:uppercase}.opacity-50{opacity:.5}.opacity-70{opacity:.7}.shadow-sm{--tw-shadow:0 1px 3px 0 var(--tw-shadow-color,#0000001a), 0 1px 2px -1px var(--tw-shadow-color,#0000001a);box-shadow:var(--tw-inset-shadow),var(--tw-inset-ring-shadow),var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow)}.backdrop-blur{--tw-backdrop-blur:blur(8px);-webkit-backdrop-filter:var(--tw-backdrop-blur, ) var(--tw-backdrop-brightness, ) var(--tw-backdrop-contrast, ) var(--tw-backdrop-grayscale, ) var(--tw-backdrop-hue-rotate, ) var(--tw-backdrop-invert, ) var(--tw-backdrop-opacity, ) var(--tw-backdrop-saturate, ) var(--tw-backdrop-sepia, );backdrop-filter:var(--tw-backdrop-blur, ) var(--tw-backdrop-brightness, ) var(--tw-backdrop-contrast, ) var(--tw-backdrop-grayscale, ) var(--tw-backdrop-hue-rotate, ) var(--tw-backdrop-invert, ) var(--tw-backdrop-opacity, ) var(--tw-backdrop-saturate, ) var(--tw-backdrop-sepia, )}.transition-all{transition-property:all;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}.transition-colors{transition-property:color,background-color,border-color,outline-color,text-decoration-color,fill,stroke,--tw-gradient-from,--tw-gradient-via,--tw-gradient-to;transition-timing-function:var(--tw-ease,var(--default-transition-timing-function));transition-duration:var(--tw-duration,var(--default-transition-duration))}@media(hover:hover){.hover\:border-\[var\(--ink-primary\)\]:hover{border-color:var(--ink-primary)}.hover\:bg-\[var\(--surface-paper\)\]:hover{background-color:var(--surface-paper)}.hover\:bg-\[var\(--surface-subtle\)\]:hover{background-color:var(--surface-subtle)}.hover\:text-\[var\(--ink-primary\)\]:hover{color:var(--ink-primary)}.hover\:underline:hover{text-decoration-line:underline}}.focus\:outline-none:focus{--tw-outline-style:none;outline-style:none}@media(min-width:40rem){.sm\:grid-cols-10{grid-template-columns:repeat(10,minmax(0,1fr))}.sm\:px-6{padding-inline:calc(var(--spacing) * 6)}}@media(min-width:48rem){.md\:grid-cols-5{grid-template-columns:repeat(5,minmax(0,1fr))}}@media(min-width:64rem){.lg\:col-span-3{grid-column:span 3/span 3}.lg\:col-span-4{grid-column:span 4/span 4}.lg\:col-span-5{grid-column:span 5/span 5}.lg\:col-span-7{grid-column:span 7/span 7}.lg\:col-span-8{grid-column:span 8/span 8}.lg\:grid-cols-12{grid-template-columns:repeat(12,minmax(0,1fr))}}@media(min-width:80rem){.xl\:inline-flex{display:inline-flex}}}:root{--surface-paper:#faf9f6;--surface-card:#fff;--surface-subtle:#f3f1ec;--ink-primary:#14181f;--ink-secondary:#525b68;--ink-muted:#7a8391;--border-hairline:#e4e1d9;--border-strong:#cfc9bd;--accent-cobalt:#1d4ed8;--accent-cobalt-hover:#1e40af;--signal-ok:#0f8a5f;--signal-ok-bg:#ecfdf5;--signal-warn:#b45309;--signal-warn-bg:#fffbeb;--signal-err:#dc2626;--signal-err-bg:#fef2f2}.paper-card{background:var(--surface-card);border:1px solid var(--border-hairline);border-radius:10px;box-shadow:0 1px 2px #14181f0a}.workbench-input{background:var(--surface-card);border:1px solid var(--border-strong);color:var(--ink-primary);border-radius:7px;padding:.45rem .65rem;font-size:.875rem;transition:border-color .14s,box-shadow .14s}.workbench-input:focus{border-color:var(--accent-cobalt);outline:none;box-shadow:0 0 0 3px #1d4ed81f}.btn-primary{background:var(--ink-primary);color:#fff;cursor:pointer;border-radius:7px;align-items:center;gap:.45rem;padding:.5rem .95rem;font-size:.875rem;font-weight:500;transition:background-color .14s,transform 80ms;display:inline-flex}.btn-primary:hover:not(:disabled){background:#27303d}.btn-primary:active:not(:disabled){transform:translateY(.5px)}.btn-primary:disabled{opacity:.5;cursor:not-allowed}.btn-accent{background:var(--accent-cobalt);color:#fff;cursor:pointer;border-radius:7px;align-items:center;gap:.45rem;padding:.5rem .95rem;font-size:.875rem;font-weight:500;transition:background-color .14s;display:inline-flex}.btn-accent:hover:not(:disabled){background:var(--accent-cobalt-hover)}.btn-accent:disabled{opacity:.5;cursor:not-allowed}.btn-secondary{background:var(--surface-card);color:var(--ink-primary);border:1px solid var(--border-strong);cursor:pointer;border-radius:7px;align-items:center;gap:.45rem;padding:.45rem .85rem;font-size:.875rem;font-weight:500;transition:background-color .14s,border-color .14s;display:inline-flex}.btn-secondary:hover:not(:disabled){background:var(--surface-subtle);border-color:#b7b0a2}.btn-secondary:disabled{opacity:.5;cursor:not-allowed}@property --tw-space-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-divide-y-reverse{syntax:"*";inherits:false;initial-value:0}@property --tw-border-style{syntax:"*";inherits:false;initial-value:solid}@property --tw-leading{syntax:"*";inherits:false}@property --tw-font-weight{syntax:"*";inherits:false}@property --tw-tracking{syntax:"*";inherits:false}@property --tw-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-shadow-color{syntax:"*";inherits:false}@property --tw-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-inset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-shadow-color{syntax:"*";inherits:false}@property --tw-inset-shadow-alpha{syntax:"<percentage>";inherits:false;initial-value:100%}@property --tw-ring-color{syntax:"*";inherits:false}@property --tw-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-inset-ring-color{syntax:"*";inherits:false}@property --tw-inset-ring-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-ring-inset{syntax:"*";inherits:false}@property --tw-ring-offset-width{syntax:"<length>";inherits:false;initial-value:0}@property --tw-ring-offset-color{syntax:"*";inherits:false;initial-value:#fff}@property --tw-ring-offset-shadow{syntax:"*";inherits:false;initial-value:0 0 #0000}@property --tw-backdrop-blur{syntax:"*";inherits:false}@property --tw-backdrop-brightness{syntax:"*";inherits:false}@property --tw-backdrop-contrast{syntax:"*";inherits:false}@property --tw-backdrop-grayscale{syntax:"*";inherits:false}@property --tw-backdrop-hue-rotate{syntax:"*";inherits:false}@property --tw-backdrop-invert{syntax:"*";inherits:false}@property --tw-backdrop-opacity{syntax:"*";inherits:false}@property --tw-backdrop-saturate{syntax:"*";inherits:false}@property --tw-backdrop-sepia{syntax:"*";inherits:false}@keyframes spin{to{transform:rotate(360deg)}}@keyframes pulse{50%{opacity:.5}}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
<!doctype html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8" />
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
6
|
+
<title>OMRKit Studio — Optical Mark Recognition Workbench</title>
|
|
7
|
+
<meta
|
|
8
|
+
name="description"
|
|
9
|
+
content="Precision Optical Mark Recognition workbench: ArUco sheet generator, interactive visual template designer, HITL review queue, and psychometric exam analytics."
|
|
10
|
+
/>
|
|
11
|
+
<link rel="preconnect" href="https://fonts.googleapis.com" />
|
|
12
|
+
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
|
|
13
|
+
<link
|
|
14
|
+
href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500;600&display=swap"
|
|
15
|
+
rel="stylesheet"
|
|
16
|
+
/>
|
|
17
|
+
<script type="module" crossorigin src="/assets/index-BFfdzDls.js"></script>
|
|
18
|
+
<link rel="stylesheet" crossorigin href="/assets/index-DRPOjlrM.css">
|
|
19
|
+
</head>
|
|
20
|
+
<body>
|
|
21
|
+
<div id="root"></div>
|
|
22
|
+
</body>
|
|
23
|
+
</html>
|
omrkit/cli/__init__.py
ADDED
omrkit/cli/app.py
ADDED
|
@@ -0,0 +1,440 @@
|
|
|
1
|
+
"""Modern Typer + Rich command-line interface for OMRKit."""
|
|
2
|
+
|
|
3
|
+
from __future__ import annotations
|
|
4
|
+
|
|
5
|
+
import contextlib
|
|
6
|
+
import json
|
|
7
|
+
import os
|
|
8
|
+
from pathlib import Path
|
|
9
|
+
from time import perf_counter
|
|
10
|
+
from typing import Annotated
|
|
11
|
+
|
|
12
|
+
import typer
|
|
13
|
+
from rich.console import Console
|
|
14
|
+
from rich.progress import BarColumn, Progress, SpinnerColumn, TextColumn, TimeElapsedColumn
|
|
15
|
+
from rich.table import Table
|
|
16
|
+
|
|
17
|
+
from omrkit.core.auto_scanner import scan_file_auto
|
|
18
|
+
from omrkit.core.benchmark import run_benchmark
|
|
19
|
+
from omrkit.core.migrator import migrate_legacy_template_file
|
|
20
|
+
from omrkit.core.scanner import OMRScanner
|
|
21
|
+
from omrkit.generator.pdf_sheet import SheetGenerator
|
|
22
|
+
from omrkit.generator.presets import get_sheet_preset, get_sheet_presets
|
|
23
|
+
from omrkit.grading.grader import ExamGrader
|
|
24
|
+
from omrkit.io.exporters import export_csv, export_excel, export_json, export_pdf_scorecard
|
|
25
|
+
from omrkit.io.loader import discover_documents, load_document, strip_exif_and_save
|
|
26
|
+
from omrkit.models.grading import AnswerKey, GradingPolicy
|
|
27
|
+
from omrkit.models.scan import BatchResult, SheetResult
|
|
28
|
+
from omrkit.models.template import Template
|
|
29
|
+
from omrkit.vision.grid_finder import detect_layout_from_blank
|
|
30
|
+
|
|
31
|
+
app = typer.Typer(
|
|
32
|
+
name="omrkit",
|
|
33
|
+
help="OMRKit v2.1 — Modern Optical Mark Recognition engine, QR Auto-Scan, Sheet Generator, Psychometrics & Web Studio.",
|
|
34
|
+
no_args_is_help=True,
|
|
35
|
+
rich_markup_mode="rich",
|
|
36
|
+
)
|
|
37
|
+
console = Console()
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
@app.command()
|
|
41
|
+
def scan(
|
|
42
|
+
input_path: Annotated[
|
|
43
|
+
Path,
|
|
44
|
+
typer.Argument(help="Image file, PDF file, or directory containing sheets to scan."),
|
|
45
|
+
],
|
|
46
|
+
template: Annotated[
|
|
47
|
+
Path | None,
|
|
48
|
+
typer.Option(
|
|
49
|
+
"-t",
|
|
50
|
+
"--template",
|
|
51
|
+
help="Path to template.json/.yaml. Omit to auto-detect template from embedded sheet QR code.",
|
|
52
|
+
),
|
|
53
|
+
] = None,
|
|
54
|
+
output: Annotated[
|
|
55
|
+
Path,
|
|
56
|
+
typer.Option(
|
|
57
|
+
"-o", "--output", help="Directory where results and overlays will be written."
|
|
58
|
+
),
|
|
59
|
+
] = Path("outputs"),
|
|
60
|
+
answer_key: Annotated[
|
|
61
|
+
Path | None,
|
|
62
|
+
typer.Option(
|
|
63
|
+
"-k", "--answer-key", help="Optional answer_key.json/.yaml for immediate grading."
|
|
64
|
+
),
|
|
65
|
+
] = None,
|
|
66
|
+
policy: Annotated[
|
|
67
|
+
str,
|
|
68
|
+
typer.Option("--policy", help="Grading preset: standard, yks_tyt, kpss, lgs, sat_legacy."),
|
|
69
|
+
] = "standard",
|
|
70
|
+
formats: Annotated[
|
|
71
|
+
str,
|
|
72
|
+
typer.Option("--format", help="Comma-separated export formats: csv,json,xlsx,scorecards."),
|
|
73
|
+
] = "csv,json",
|
|
74
|
+
overlay: Annotated[
|
|
75
|
+
bool,
|
|
76
|
+
typer.Option("--overlay/--no-overlay", help="Save color-coded verification overlay PNGs."),
|
|
77
|
+
] = True,
|
|
78
|
+
workers: Annotated[
|
|
79
|
+
int,
|
|
80
|
+
typer.Option("-w", "--workers", help="Parallel worker processes (1 = sequential)."),
|
|
81
|
+
] = 1,
|
|
82
|
+
dpi: Annotated[
|
|
83
|
+
int,
|
|
84
|
+
typer.Option("--dpi", help="PDF rasterization DPI."),
|
|
85
|
+
] = 200,
|
|
86
|
+
recursive: Annotated[
|
|
87
|
+
bool,
|
|
88
|
+
typer.Option("-r", "--recursive", help="Recursively scan subdirectories."),
|
|
89
|
+
] = False,
|
|
90
|
+
) -> None:
|
|
91
|
+
"""Scan optical sheets (images or multi-page PDFs) with explicit template or QR auto-detection."""
|
|
92
|
+
output.mkdir(parents=True, exist_ok=True)
|
|
93
|
+
overlay_dir = output / "overlays" if overlay else None
|
|
94
|
+
|
|
95
|
+
if template is not None:
|
|
96
|
+
tmpl = Template.from_file(template)
|
|
97
|
+
tmpl_label = tmpl.name
|
|
98
|
+
scanner = OMRScanner(tmpl, dpi=dpi)
|
|
99
|
+
with Progress(
|
|
100
|
+
SpinnerColumn(),
|
|
101
|
+
TextColumn("[bold cyan]{task.description}"),
|
|
102
|
+
BarColumn(),
|
|
103
|
+
TextColumn("{task.completed}/{task.total}"),
|
|
104
|
+
TimeElapsedColumn(),
|
|
105
|
+
console=console,
|
|
106
|
+
) as progress:
|
|
107
|
+
task_id = progress.add_task("Scanning sheets...", total=None)
|
|
108
|
+
|
|
109
|
+
def _on_progress(done: int, total: int, filename: str) -> None:
|
|
110
|
+
progress.update(
|
|
111
|
+
task_id, total=total, completed=done, description=f"Scanned {filename}"
|
|
112
|
+
)
|
|
113
|
+
|
|
114
|
+
batch = scanner.scan_batch(
|
|
115
|
+
input_path=input_path,
|
|
116
|
+
workers=workers,
|
|
117
|
+
recursive=recursive,
|
|
118
|
+
save_overlay_dir=overlay_dir,
|
|
119
|
+
progress_cb=_on_progress,
|
|
120
|
+
)
|
|
121
|
+
else:
|
|
122
|
+
tmpl_label = "auto (QR)"
|
|
123
|
+
files = discover_documents(input_path, recursive=recursive)
|
|
124
|
+
t0 = perf_counter()
|
|
125
|
+
all_sheets: list[SheetResult] = []
|
|
126
|
+
for f in files:
|
|
127
|
+
all_sheets.extend(scan_file_auto(f, dpi=dpi, save_overlay_dir=overlay_dir))
|
|
128
|
+
elapsed = (perf_counter() - t0) * 1000.0
|
|
129
|
+
succeeded = sum(1 for r in all_sheets if r.error is None)
|
|
130
|
+
failed = sum(1 for r in all_sheets if r.error is not None)
|
|
131
|
+
flagged = sum(1 for r in all_sheets if r.error is None and len(r.review_items) > 0)
|
|
132
|
+
batch = BatchResult(
|
|
133
|
+
template_name="auto",
|
|
134
|
+
sheets=all_sheets,
|
|
135
|
+
total_sheets=len(all_sheets),
|
|
136
|
+
succeeded=succeeded,
|
|
137
|
+
flagged_sheets=flagged,
|
|
138
|
+
failed_sheets=failed,
|
|
139
|
+
total_elapsed_ms=round(elapsed, 2),
|
|
140
|
+
sheets_per_minute=round(
|
|
141
|
+
(len(all_sheets) / (elapsed / 60000.0)) if elapsed > 0 else 0.0, 1
|
|
142
|
+
),
|
|
143
|
+
)
|
|
144
|
+
|
|
145
|
+
report = None
|
|
146
|
+
if answer_key is not None:
|
|
147
|
+
key = AnswerKey.from_file(answer_key)
|
|
148
|
+
grader = ExamGrader(key, GradingPolicy.preset(policy))
|
|
149
|
+
report = grader.grade_batch(batch.sheets)
|
|
150
|
+
|
|
151
|
+
fmt_set = {f.strip().lower() for f in formats.split(",") if f.strip()}
|
|
152
|
+
exported: list[str] = []
|
|
153
|
+
if "csv" in fmt_set:
|
|
154
|
+
exported.append(str(export_csv(batch.sheets, output / "results.csv", report=report)))
|
|
155
|
+
if "json" in fmt_set:
|
|
156
|
+
exported.append(str(export_json(batch.sheets, output / "results.json", report=report)))
|
|
157
|
+
if "xlsx" in fmt_set:
|
|
158
|
+
exported.append(str(export_excel(batch.sheets, output / "report.xlsx", report=report)))
|
|
159
|
+
if "scorecards" in fmt_set and report is not None:
|
|
160
|
+
sc_dir = output / "scorecards"
|
|
161
|
+
for g in report.grades:
|
|
162
|
+
export_pdf_scorecard(
|
|
163
|
+
g, sc_dir / f"{g.sheet_id}_scorecard.pdf", exam_name=report.exam_name
|
|
164
|
+
)
|
|
165
|
+
exported.append(str(sc_dir))
|
|
166
|
+
|
|
167
|
+
table = Table(title="OMRKit Scan Summary", show_header=False)
|
|
168
|
+
table.add_column("Metric", style="cyan", no_wrap=True)
|
|
169
|
+
table.add_column("Value", style="bold")
|
|
170
|
+
table.add_row("Template", tmpl_label)
|
|
171
|
+
table.add_row("Total Pages", str(batch.total_sheets))
|
|
172
|
+
table.add_row("Succeeded", f"[green]{batch.succeeded}[/green]")
|
|
173
|
+
table.add_row("Flagged for HITL Review", f"[yellow]{batch.flagged_sheets}[/yellow]")
|
|
174
|
+
table.add_row("Failed", f"[red]{batch.failed_sheets}[/red]")
|
|
175
|
+
table.add_row(
|
|
176
|
+
"Throughput", f"{batch.sheets_per_minute:.1f} sheets/min ({batch.total_elapsed_ms:.0f} ms)"
|
|
177
|
+
)
|
|
178
|
+
if report is not None:
|
|
179
|
+
table.add_row(
|
|
180
|
+
"Mean Score", f"{report.analytics.mean_score} ({report.analytics.mean_percentage}%)"
|
|
181
|
+
)
|
|
182
|
+
if report.analytics.kr20_reliability is not None:
|
|
183
|
+
table.add_row("KR-20 Reliability", str(report.analytics.kr20_reliability))
|
|
184
|
+
for path_str in exported:
|
|
185
|
+
table.add_row("Exported", path_str)
|
|
186
|
+
console.print(table)
|
|
187
|
+
|
|
188
|
+
|
|
189
|
+
@app.command()
|
|
190
|
+
def generate(
|
|
191
|
+
preset: Annotated[
|
|
192
|
+
str,
|
|
193
|
+
typer.Option("--preset", "-p", help="Sheet preset ID (run --list to inspect all)."),
|
|
194
|
+
] = "standard_mcq_40",
|
|
195
|
+
output: Annotated[
|
|
196
|
+
Path,
|
|
197
|
+
typer.Option(
|
|
198
|
+
"-o", "--output", help="Output directory for PDF, template.json, and answer_key.json."
|
|
199
|
+
),
|
|
200
|
+
] = Path("generated_sheet"),
|
|
201
|
+
title: Annotated[
|
|
202
|
+
str | None,
|
|
203
|
+
typer.Option("--title", help="Custom header title on the generated PDF."),
|
|
204
|
+
] = None,
|
|
205
|
+
questions: Annotated[
|
|
206
|
+
int | None,
|
|
207
|
+
typer.Option("--questions", "-q", help="Override number of questions (5-120)."),
|
|
208
|
+
] = None,
|
|
209
|
+
list_presets: Annotated[
|
|
210
|
+
bool,
|
|
211
|
+
typer.Option("--list", help="List available built-in optical sheet presets."),
|
|
212
|
+
] = False,
|
|
213
|
+
) -> None:
|
|
214
|
+
"""Generate a print-ready ArUco + QR PDF optical sheet + pixel-exact matching template.json."""
|
|
215
|
+
if list_presets:
|
|
216
|
+
table = Table(title="Built-in Optical Sheet Presets")
|
|
217
|
+
table.add_column("Preset ID", style="cyan")
|
|
218
|
+
table.add_column("Questions")
|
|
219
|
+
table.add_column("Options")
|
|
220
|
+
table.add_column("Title")
|
|
221
|
+
for pid, spec in get_sheet_presets().items():
|
|
222
|
+
table.add_row(pid, str(spec.num_questions), "".join(spec.options), spec.title)
|
|
223
|
+
console.print(table)
|
|
224
|
+
return
|
|
225
|
+
|
|
226
|
+
spec = get_sheet_preset(preset).model_copy(deep=True)
|
|
227
|
+
if title is not None:
|
|
228
|
+
spec.title = title
|
|
229
|
+
if questions is not None:
|
|
230
|
+
spec.num_questions = questions
|
|
231
|
+
|
|
232
|
+
paths = SheetGenerator().generate_to_dir(spec, output)
|
|
233
|
+
console.print(f"[green]Generated optical sheet bundle in '{output}':[/green]")
|
|
234
|
+
for key, p in paths.items():
|
|
235
|
+
console.print(f" - [bold]{key}[/bold]: {p}")
|
|
236
|
+
|
|
237
|
+
|
|
238
|
+
@app.command("detect-layout")
|
|
239
|
+
def detect_layout(
|
|
240
|
+
blank_sheet: Annotated[
|
|
241
|
+
Path,
|
|
242
|
+
typer.Argument(help="Path to a blank optical form image or PDF."),
|
|
243
|
+
],
|
|
244
|
+
output: Annotated[
|
|
245
|
+
Path,
|
|
246
|
+
typer.Option("-o", "--output", help="Output path for auto-detected template.json."),
|
|
247
|
+
] = Path("detected_template.json"),
|
|
248
|
+
name: Annotated[
|
|
249
|
+
str | None,
|
|
250
|
+
typer.Option("--name", help="Optional name for the generated template."),
|
|
251
|
+
] = None,
|
|
252
|
+
dpi: Annotated[int, typer.Option("--dpi", help="PDF rasterization DPI.")] = 200,
|
|
253
|
+
) -> None:
|
|
254
|
+
"""Automatically detect circular bubble grids on a blank optical form and emit template.json."""
|
|
255
|
+
page = load_document(blank_sheet, dpi=dpi)[0]
|
|
256
|
+
tmpl, bubbles_found = detect_layout_from_blank(
|
|
257
|
+
page.image_bgr, template_name=name or blank_sheet.stem
|
|
258
|
+
)
|
|
259
|
+
saved = tmpl.to_file(output)
|
|
260
|
+
console.print(
|
|
261
|
+
f"[green]Auto-detected {len(tmpl.blocks)} block(s) ({len(tmpl.all_field_ids())} fields, "
|
|
262
|
+
f"{bubbles_found} bubbles)[/green] -> [bold]{saved}[/bold]"
|
|
263
|
+
)
|
|
264
|
+
|
|
265
|
+
|
|
266
|
+
@app.command("migrate-template")
|
|
267
|
+
def migrate_template(
|
|
268
|
+
legacy_json: Annotated[
|
|
269
|
+
Path,
|
|
270
|
+
typer.Argument(help="Path to a legacy OMRChecker v1 template.json file."),
|
|
271
|
+
],
|
|
272
|
+
output: Annotated[
|
|
273
|
+
Path,
|
|
274
|
+
typer.Option("-o", "--output", help="Destination path for OMRKit v2 template.json."),
|
|
275
|
+
] = Path("template_v2.json"),
|
|
276
|
+
) -> None:
|
|
277
|
+
"""Migrate a legacy OMRChecker template.json into an OMRKit v2.0 template."""
|
|
278
|
+
tmpl = migrate_legacy_template_file(legacy_json, output)
|
|
279
|
+
console.print(
|
|
280
|
+
f"[green]Migrated legacy template[/green] '{legacy_json.name}' -> [bold]{output}[/bold] "
|
|
281
|
+
f"({len(tmpl.blocks)} blocks, {len(tmpl.all_field_ids())} fields, mode={tmpl.registration.mode})"
|
|
282
|
+
)
|
|
283
|
+
|
|
284
|
+
|
|
285
|
+
@app.command()
|
|
286
|
+
def grade(
|
|
287
|
+
results_json: Annotated[
|
|
288
|
+
Path,
|
|
289
|
+
typer.Argument(help="Path to results.json produced by `omrkit scan`."),
|
|
290
|
+
],
|
|
291
|
+
answer_key: Annotated[
|
|
292
|
+
Path,
|
|
293
|
+
typer.Option("-k", "--answer-key", help="Path to answer_key.json or .yaml."),
|
|
294
|
+
],
|
|
295
|
+
policy: Annotated[
|
|
296
|
+
str,
|
|
297
|
+
typer.Option("--policy", help="Grading preset: standard, yks_tyt, kpss, lgs, sat_legacy."),
|
|
298
|
+
] = "standard",
|
|
299
|
+
output: Annotated[
|
|
300
|
+
Path,
|
|
301
|
+
typer.Option("-o", "--output", help="Output directory for graded reports."),
|
|
302
|
+
] = Path("graded_outputs"),
|
|
303
|
+
) -> None:
|
|
304
|
+
"""Grade previously scanned results and compute Classical Test Theory psychometrics."""
|
|
305
|
+
raw = json.loads(results_json.read_text(encoding="utf-8"))
|
|
306
|
+
sheets = [SheetResult.model_validate(item) for item in raw.get("sheets", raw)]
|
|
307
|
+
key = AnswerKey.from_file(answer_key)
|
|
308
|
+
grader = ExamGrader(key, GradingPolicy.preset(policy))
|
|
309
|
+
report = grader.grade_batch(sheets)
|
|
310
|
+
|
|
311
|
+
output.mkdir(parents=True, exist_ok=True)
|
|
312
|
+
export_json(sheets, output / "graded_report.json", report=report)
|
|
313
|
+
export_csv(sheets, output / "graded_results.csv", report=report)
|
|
314
|
+
with contextlib.suppress(RuntimeError):
|
|
315
|
+
export_excel(sheets, output / "graded_report.xlsx", report=report)
|
|
316
|
+
|
|
317
|
+
a = report.analytics
|
|
318
|
+
console.print(
|
|
319
|
+
f"[green]Graded {a.student_count} sheet(s)[/green] | "
|
|
320
|
+
f"Mean: [bold]{a.mean_score}[/bold] ({a.mean_percentage}%) | "
|
|
321
|
+
f"Median: {a.median_score} | Std: {a.std_score} | KR-20: {a.kr20_reliability}"
|
|
322
|
+
)
|
|
323
|
+
|
|
324
|
+
|
|
325
|
+
@app.command()
|
|
326
|
+
def validate(
|
|
327
|
+
template: Annotated[
|
|
328
|
+
Path,
|
|
329
|
+
typer.Argument(help="Path to template.json or template.yaml to validate."),
|
|
330
|
+
],
|
|
331
|
+
) -> None:
|
|
332
|
+
"""Validate an OMRKit template file and display layout summary."""
|
|
333
|
+
tmpl = Template.from_file(template)
|
|
334
|
+
console.print(
|
|
335
|
+
f"[green]Valid OMRKit v{tmpl.version} template:[/green] [bold]{tmpl.name}[/bold] "
|
|
336
|
+
f"({tmpl.page_width}x{tmpl.page_height}, mode={tmpl.registration.mode}, "
|
|
337
|
+
f"blocks={len(tmpl.blocks)}, fields={len(tmpl.all_field_ids())})"
|
|
338
|
+
)
|
|
339
|
+
|
|
340
|
+
|
|
341
|
+
@app.command()
|
|
342
|
+
def benchmark(
|
|
343
|
+
preset: Annotated[
|
|
344
|
+
str,
|
|
345
|
+
typer.Option("--preset", "-p", help="Sheet preset to stress-test."),
|
|
346
|
+
] = "standard_mcq_40",
|
|
347
|
+
samples: Annotated[
|
|
348
|
+
int,
|
|
349
|
+
typer.Option("--samples", "-n", help="Synthetic sheets per distortion scenario."),
|
|
350
|
+
] = 5,
|
|
351
|
+
) -> None:
|
|
352
|
+
"""Run synthetic distortion accuracy and speed benchmarks."""
|
|
353
|
+
console.print(
|
|
354
|
+
f"Running OMRKit benchmark on preset [cyan]{preset}[/cyan] ({samples} sheets/scenario)..."
|
|
355
|
+
)
|
|
356
|
+
rows = run_benchmark(preset_id=preset, samples_per_scenario=samples)
|
|
357
|
+
table = Table(title="OMRKit Synthetic Accuracy & Throughput Benchmark")
|
|
358
|
+
table.add_column("Scenario", style="cyan")
|
|
359
|
+
table.add_column("Accuracy", justify="right", style="bold green")
|
|
360
|
+
table.add_column("Fields", justify="right")
|
|
361
|
+
table.add_column("Avg Conf", justify="right")
|
|
362
|
+
table.add_column("HITL Flags", justify="right")
|
|
363
|
+
table.add_column("Throughput", justify="right", style="magenta")
|
|
364
|
+
|
|
365
|
+
for r in rows:
|
|
366
|
+
table.add_row(
|
|
367
|
+
r.scenario,
|
|
368
|
+
f"{r.accuracy_pct:.2f}%",
|
|
369
|
+
f"{r.correct_fields}/{r.total_fields}",
|
|
370
|
+
f"{r.avg_confidence * 100:.1f}%",
|
|
371
|
+
str(r.flagged_fields),
|
|
372
|
+
f"{r.sheets_per_minute:.0f} OMR/min",
|
|
373
|
+
)
|
|
374
|
+
console.print(table)
|
|
375
|
+
|
|
376
|
+
|
|
377
|
+
@app.command("strip-exif")
|
|
378
|
+
def strip_exif(
|
|
379
|
+
input_path: Annotated[
|
|
380
|
+
Path,
|
|
381
|
+
typer.Argument(help="Image file or folder to sanitize."),
|
|
382
|
+
],
|
|
383
|
+
output: Annotated[
|
|
384
|
+
Path,
|
|
385
|
+
typer.Option("-o", "--output", help="Destination file or folder."),
|
|
386
|
+
],
|
|
387
|
+
max_dim: Annotated[
|
|
388
|
+
int | None,
|
|
389
|
+
typer.Option("--max-dim", help="Optional max width/height in pixels."),
|
|
390
|
+
] = None,
|
|
391
|
+
) -> None:
|
|
392
|
+
"""Strip EXIF/GPS privacy metadata and bake orientation permanently into pixels."""
|
|
393
|
+
if input_path.is_file():
|
|
394
|
+
size = strip_exif_and_save(input_path, output, max_dimension=max_dim)
|
|
395
|
+
console.print(
|
|
396
|
+
f"[green]Sanitized[/green] {input_path.name} -> {output} ({size[0]}x{size[1]})"
|
|
397
|
+
)
|
|
398
|
+
return
|
|
399
|
+
|
|
400
|
+
files = [p for p in discover_documents(input_path) if p.suffix.lower() != ".pdf"]
|
|
401
|
+
for src in files:
|
|
402
|
+
dst = output / src.name
|
|
403
|
+
size = strip_exif_and_save(src, dst, max_dimension=max_dim)
|
|
404
|
+
console.print(f"[green]Sanitized[/green] {src.name} -> {dst} ({size[0]}x{size[1]})")
|
|
405
|
+
|
|
406
|
+
|
|
407
|
+
@app.command()
|
|
408
|
+
def studio(
|
|
409
|
+
host: Annotated[str, typer.Option("--host", help="Bind host address.")] = "127.0.0.1",
|
|
410
|
+
port: Annotated[
|
|
411
|
+
int | None,
|
|
412
|
+
typer.Option("--port", help="HTTP port (defaults to $PORT or 8000)."),
|
|
413
|
+
] = None,
|
|
414
|
+
reload: Annotated[
|
|
415
|
+
bool, typer.Option("--reload", help="Enable auto-reload for development.")
|
|
416
|
+
] = False,
|
|
417
|
+
) -> None:
|
|
418
|
+
"""Launch OMRKit Web Studio + FastAPI REST API server."""
|
|
419
|
+
try:
|
|
420
|
+
import uvicorn
|
|
421
|
+
except ImportError as exc:
|
|
422
|
+
console.print(
|
|
423
|
+
"[red]Web Studio requires optional dependencies.[/red] "
|
|
424
|
+
"Install with: [bold]pip install 'omrkit[studio]'[/bold]"
|
|
425
|
+
)
|
|
426
|
+
raise typer.Exit(code=1) from exc
|
|
427
|
+
|
|
428
|
+
resolved_port = port if port is not None else int(os.environ.get("PORT", "8000"))
|
|
429
|
+
console.print(
|
|
430
|
+
f"[bold green]OMRKit Studio[/bold green] listening on "
|
|
431
|
+
f"[cyan]http://{host}:{resolved_port}[/cyan] "
|
|
432
|
+
f"(OpenAPI docs: [cyan]http://{host}:{resolved_port}/docs[/cyan])"
|
|
433
|
+
)
|
|
434
|
+
uvicorn.run(
|
|
435
|
+
"omrkit.api.app:create_app",
|
|
436
|
+
factory=True,
|
|
437
|
+
host=host,
|
|
438
|
+
port=resolved_port,
|
|
439
|
+
reload=reload,
|
|
440
|
+
)
|
omrkit/core/__init__.py
ADDED
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
"""Core scanning, auto-detection, migration, validation, and benchmarking engines."""
|
|
2
|
+
|
|
3
|
+
from omrkit.core.auto_scanner import (
|
|
4
|
+
resolve_template_for_image,
|
|
5
|
+
scan_bytes_auto,
|
|
6
|
+
scan_file_auto,
|
|
7
|
+
scan_image_auto,
|
|
8
|
+
scan_page_auto,
|
|
9
|
+
)
|
|
10
|
+
from omrkit.core.benchmark import (
|
|
11
|
+
BenchmarkScenarioResult,
|
|
12
|
+
apply_camera_distortion,
|
|
13
|
+
render_synthetic_filled_sheet,
|
|
14
|
+
run_benchmark,
|
|
15
|
+
)
|
|
16
|
+
from omrkit.core.migrator import migrate_legacy_template_dict, migrate_legacy_template_file
|
|
17
|
+
from omrkit.core.scanner import OMRScanner
|
|
18
|
+
from omrkit.core.validators import (
|
|
19
|
+
run_validator,
|
|
20
|
+
validate_digits,
|
|
21
|
+
validate_luhn,
|
|
22
|
+
validate_non_empty,
|
|
23
|
+
validate_tr_tckn,
|
|
24
|
+
)
|
|
25
|
+
|
|
26
|
+
__all__ = [
|
|
27
|
+
"BenchmarkScenarioResult",
|
|
28
|
+
"OMRScanner",
|
|
29
|
+
"apply_camera_distortion",
|
|
30
|
+
"migrate_legacy_template_dict",
|
|
31
|
+
"migrate_legacy_template_file",
|
|
32
|
+
"render_synthetic_filled_sheet",
|
|
33
|
+
"resolve_template_for_image",
|
|
34
|
+
"run_benchmark",
|
|
35
|
+
"run_validator",
|
|
36
|
+
"scan_bytes_auto",
|
|
37
|
+
"scan_file_auto",
|
|
38
|
+
"scan_image_auto",
|
|
39
|
+
"scan_page_auto",
|
|
40
|
+
"validate_digits",
|
|
41
|
+
"validate_luhn",
|
|
42
|
+
"validate_non_empty",
|
|
43
|
+
"validate_tr_tckn",
|
|
44
|
+
]
|