mcqpy-core 0.2.3__tar.gz → 0.2.4__tar.gz

{mcqpy_core-0.2.3 → mcqpy_core-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: mcqpy-core
-Version: 0.2.3
+Version: 0.2.4
 Summary: Core question, manifest, grading, analysis, and browser-safe runtime logic for MCQPy
 Author: Mads-Peter
 Author-email: Mads-Peter <machri@phys.au.dk>

{mcqpy_core-0.2.3 → mcqpy_core-0.2.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mcqpy-core"
-version = "0.2.3"
+version = "0.2.4"
 description = "Core question, manifest, grading, analysis, and browser-safe runtime logic for MCQPy"
 readme = "README.md"
 authors = [

{mcqpy_core-0.2.3 → mcqpy_core-0.2.4}/src/mcqpy_core/cli/config.py

@@ -1,6 +1,7 @@
 """Quiz configuration management using Pydantic and YAML."""
 
 from pathlib import Path
+from sys import path
 from typing import Any, Literal
 
 from pydantic import BaseModel, Field, ConfigDict, field_validator, model_validator
@@ -142,6 +143,28 @@ class QuizConfig(BaseModel):
                 raise FileNotFoundError(f"Questions path does not exist: {resolved_path}")
 
         return data
+    
+    @model_validator(mode="before")
+    def selection_path_make_absolute(cls, data):
+        """Ensure that selection paths are relative to the config file's directory"""
+        selection = data.get("selection", None)
+        if selection is None:
+            return data
+
+        filters = selection.get("filters", None)
+
+        if filters is None:
+            return data
+
+        config_path = data.get("path")
+        for filter_name, filter_params in filters.items():
+            for name, param in filter_params.items():
+                if name.endswith("_path") and isinstance(param, str) and config_path is not None:
+                    absolute_path = (Path(config_path).parent / param).resolve()
+                    filter_params[name] = str(absolute_path)
+
+        return data
+
 
     def yaml_dump(self) -> str:
         """Dump the current configuration to a YAML string"""

{mcqpy_core-0.2.3 → mcqpy_core-0.2.4}/src/mcqpy_core/grading/analysis/overall_analysis.py

@@ -8,6 +8,8 @@ from mcqpy_core.grading.types import GradedSet
 from scipy.stats import pearsonr
 from mcqpy_core.grading.analysis.utils import AnalysisFigure
 
+COLROMAP = plt.cm.plasma
+
 def get_points_array(graded_sets: list[GradedSet]):
 
     n_questions = max(len(graded_set.graded_questions) for graded_set in graded_sets)
@@ -37,11 +39,15 @@ def correlation_analysis(graded_sets: list[GradedSet], output_dir: str | Path):
         correlations[qidx] = correlation
         p_values[qidx] = p_value
 
+
+    # Colors based on correlation
+    colors = COLROMAP((correlations - np.min(correlations)) / (np.max(correlations) - np.min(correlations)))
+
     fig, ax = plt.subplots(figsize=(8, 5))
     ax.bar(
         np.arange(1, n_questions + 1),
         correlations,
-        color="mediumpurple",
+        color=colors,
         alpha=0.7,
         edgecolor="black",
     )
@@ -111,11 +117,15 @@ def discrimination_index_analysis(graded_sets: list[GradedSet], output_dir: str
         D = (np.mean(q_points[high_group]) - np.mean(q_points[low_group])) / max_score
         discrimination_indices[qidx] = D
 
+
+    # Colors based on discrimination index
+    colors = COLROMAP((discrimination_indices - np.min(discrimination_indices)) / (np.max(discrimination_indices) - np.min(discrimination_indices)))
+
     fig, ax = plt.subplots(figsize=(8, 5))
     ax.bar(
         np.arange(1, n_questions + 1),
         discrimination_indices,
-        color="mediumpurple",
+        color=colors,
         alpha=0.7,
         edgecolor="black",
     )
@@ -138,6 +148,42 @@ def discrimination_index_analysis(graded_sets: list[GradedSet], output_dir: str
     )
 
 
+def quesstion_point_average_analysis(graded_sets: list[GradedSet], output_dir: str | Path):
+    point_array = get_points_array(graded_sets)
+
+    n_questions = point_array.shape[1]
+
+    average_points = np.mean(point_array, axis=0)
+
+    # Colors based on average points
+    colors = COLROMAP(average_points / np.max(point_array))
+
+    fig, ax = plt.subplots(figsize=(8, 5))
+    ax.bar(
+        np.arange(1, n_questions + 1),
+        average_points,
+        color=colors,
+        alpha=0.7,
+        edgecolor="black",
+    )
+    plt.xlabel("Question Number")
+    plt.ylabel("Average Points")
+    plt.title("Average Points per Question")
+
+    ax.set_xticks(np.arange(1, n_questions + 1))
+
+    plt.tight_layout()
+
+    name = "quiz_question_point_average_analysis.pdf"
+    output_path = output_dir / name
+
+    plt.savefig(output_path)
+    plt.close()
+    return AnalysisFigure(
+        name=name,
+        caption=r"\textbf{Average points per question}: Shows the average points earned on each question across all students.",
+    )
+
 def make_quiz_analysis(graded_sets: list[GradedSet], out_directory: str | Path):
     out_directory = Path(out_directory)
     out_directory.mkdir(parents=True, exist_ok=True)
@@ -147,10 +193,14 @@ def make_quiz_analysis(graded_sets: list[GradedSet], out_directory: str | Path):
     pd_fig = point_distribution_analysis(graded_sets, out_directory)
     figures.append(pd_fig)
 
+    avg_fig = quesstion_point_average_analysis(graded_sets, out_directory)
+    figures.append(avg_fig)
+
     corr_fig = correlation_analysis(graded_sets, out_directory)
     figures.append(corr_fig)
 
     di_fig = discrimination_index_analysis(graded_sets, out_directory)
     figures.append(di_fig)
 
+
     return figures

{mcqpy_core-0.2.3 → mcqpy_core-0.2.4}/src/mcqpy_core/grading/helpers.py

@@ -13,12 +13,17 @@ def get_grade_dataframe(
 
     records = []
     for graded_set in graded_sets:
+
+        # Determine the number of questions the student gave an answer to
+        answered_questions = sum(1 in q.student_answers for q in graded_set.graded_questions)
+
         record = {}
         record.update(graded_set.student_info)
         record.update(
             {
                 "total_points": graded_set.points,
                 "max_points": graded_set.max_points,
+                "answered_questions": answered_questions,
             }
         )