QuizGenerator 0.6.2__py3-none-any.whl → 0.7.0__py3-none-any.whl

QuizGenerator/premade_questions/cst463/models/attention.py

@@ -6,7 +6,7 @@ import numpy as np
 from typing import List, Tuple
 
 from QuizGenerator.question import Question, QuestionRegistry
-from QuizGenerator.contentast import ContentAST, AnswerTypes
+import QuizGenerator.contentast as ca
 from QuizGenerator.constants import MathRanges
 from QuizGenerator.mixins import TableQuestionMixin
 
@@ -61,25 +61,25 @@ class AttentionForwardPass(MatrixQuestion, TableQuestionMixin):
     ## Answers:
     # Q, K, V, output, weights
 
-    self.answers["weights"] = AnswerTypes.Matrix(self.weights, label="Weights")
-    self.answers["output"] = AnswerTypes.Matrix(self.output, label="Output")
+    self.answers["weights"] = ca.AnswerTypes.Matrix(self.weights, label="Weights")
+    self.answers["output"] = ca.AnswerTypes.Matrix(self.output, label="Output")
     
     return True
   
-  def _get_body(self, **kwargs) -> Tuple[ContentAST.Section, List[ContentAST.Answer]]:
+  def _get_body(self, **kwargs) -> Tuple[ca.Section, List[ca.Answer]]:
     """Build question body and collect answers."""
-    body = ContentAST.Section()
+    body = ca.Section()
     answers = []
 
     body.add_element(
-      ContentAST.Text("Given the below information about a self attention layer, please calculate the output sequence.")
+      ca.Text("Given the below information about a self attention layer, please calculate the output sequence.")
     )
     body.add_element(
       self.create_info_table(
         {
-          "Q": ContentAST.Matrix(self.Q),
-          "K": ContentAST.Matrix(self.K),
-          "V": ContentAST.Matrix(self.V),
+          "Q": ca.Matrix(self.Q),
+          "K": ca.Matrix(self.K),
+          "V": ca.Matrix(self.V),
         }
       )
     )
@@ -87,67 +87,67 @@ class AttentionForwardPass(MatrixQuestion, TableQuestionMixin):
     answers.append(self.answers["weights"])
     answers.append(self.answers["output"])
     body.add_elements([
-      ContentAST.LineBreak(),
+      ca.LineBreak(),
       self.answers["weights"],
-      ContentAST.LineBreak(),
+      ca.LineBreak(),
       self.answers["output"],
     ])
 
     return body, answers
 
-  def get_body(self, **kwargs) -> ContentAST.Section:
+  def get_body(self, **kwargs) -> ca.Section:
     """Build question body (backward compatible interface)."""
     body, _ = self._get_body(**kwargs)
     return body
   
-  def _get_explanation(self, **kwargs) -> Tuple[ContentAST.Section, List[ContentAST.Answer]]:
+  def _get_explanation(self, **kwargs) -> Tuple[ca.Section, List[ca.Answer]]:
     """Build question explanation."""
-    explanation = ContentAST.Section()
-    digits = ContentAST.Answer.DEFAULT_ROUNDING_DIGITS
+    explanation = ca.Section()
+    digits = ca.Answer.DEFAULT_ROUNDING_DIGITS
 
     explanation.add_element(
-      ContentAST.Paragraph([
+      ca.Paragraph([
         "Self-attention uses scaled dot-product attention to compute a weighted combination of values based on query-key similarity."
       ])
     )
 
     # Step 1: Compute attention scores
     explanation.add_element(
-      ContentAST.Paragraph([
-        ContentAST.Text("Step 1: Compute attention scores", emphasis=True)
+      ca.Paragraph([
+        ca.Text("Step 1: Compute attention scores", emphasis=True)
       ])
     )
 
     d_k = self.Q.shape[1]
     explanation.add_element(
-      ContentAST.Equation(f"\\text{{scores}} = \\frac{{Q K^T}}{{\\sqrt{{d_k}}}} = \\frac{{Q K^T}}{{\\sqrt{{{d_k}}}}}")
+      ca.Equation(f"\\text{{scores}} = \\frac{{Q K^T}}{{\\sqrt{{d_k}}}} = \\frac{{Q K^T}}{{\\sqrt{{{d_k}}}}}")
     )
 
     scores = self.Q @ self.K.T / np.sqrt(d_k)
 
     explanation.add_element(
-      ContentAST.Paragraph([
+      ca.Paragraph([
         "Raw scores (scaling by ",
-        ContentAST.Equation(f'\\sqrt{{{d_k}}}', inline=True),
+        ca.Equation(f'\\sqrt{{{d_k}}}', inline=True),
         " prevents extremely large values):"
       ])
     )
-    explanation.add_element(ContentAST.Matrix(np.round(scores, digits)))
+    explanation.add_element(ca.Matrix(np.round(scores, digits)))
 
     # Step 2: Apply softmax
     explanation.add_element(
-      ContentAST.Paragraph([
-        ContentAST.Text("Step 2: Apply softmax to get attention weights", emphasis=True)
+      ca.Paragraph([
+        ca.Text("Step 2: Apply softmax to get attention weights", emphasis=True)
       ])
     )
 
     explanation.add_element(
-      ContentAST.Equation(r"\alpha_{ij} = \frac{\exp(\text{score}_{ij})}{\sum_k \exp(\text{score}_{ik})}")
+      ca.Equation(r"\alpha_{ij} = \frac{\exp(\text{score}_{ij})}{\sum_k \exp(\text{score}_{ik})}")
     )
 
     # Show ONE example row
     explanation.add_element(
-      ContentAST.Paragraph([
+      ca.Paragraph([
         "Example: Row 0 softmax computation"
       ])
     )
@@ -160,7 +160,7 @@ class AttentionForwardPass(MatrixQuestion, TableQuestionMixin):
     exp_terms = " + ".join([f"e^{{{s:.{digits}f}}}" for s in row_scores])
 
     explanation.add_element(
-      ContentAST.Paragraph([
+      ca.Paragraph([
         f"Denominator = {exp_terms} = {sum_exp:.{digits}f}"
       ])
     )
@@ -168,39 +168,39 @@ class AttentionForwardPass(MatrixQuestion, TableQuestionMixin):
     # Format array with proper rounding
     weights_str = "[" + ", ".join([f"{w:.{digits}f}" for w in weights_row]) + "]"
     explanation.add_element(
-      ContentAST.Paragraph([
+      ca.Paragraph([
         f"Resulting weights: {weights_str}"
       ])
     )
 
     explanation.add_element(
-      ContentAST.Paragraph([
+      ca.Paragraph([
         "Complete attention weight matrix:"
       ])
     )
-    explanation.add_element(ContentAST.Matrix(np.round(self.weights, digits)))
+    explanation.add_element(ca.Matrix(np.round(self.weights, digits)))
 
     # Step 3: Weighted sum of values
     explanation.add_element(
-      ContentAST.Paragraph([
-        ContentAST.Text("Step 3: Compute weighted sum of values", emphasis=True)
+      ca.Paragraph([
+        ca.Text("Step 3: Compute weighted sum of values", emphasis=True)
       ])
     )
 
     explanation.add_element(
-      ContentAST.Equation(r"\text{output} = \text{weights} \times V")
+      ca.Equation(r"\text{output} = \text{weights} \times V")
     )
 
     explanation.add_element(
-      ContentAST.Paragraph([
+      ca.Paragraph([
         "Final output:"
       ])
     )
-    explanation.add_element(ContentAST.Matrix(np.round(self.output, digits)))
+    explanation.add_element(ca.Matrix(np.round(self.output, digits)))
 
     return explanation, []
 
-  def get_explanation(self, **kwargs) -> ContentAST.Section:
+  def get_explanation(self, **kwargs) -> ca.Section:
     """Build question explanation (backward compatible interface)."""
     explanation, _ = self._get_explanation(**kwargs)
     return explanation

QuizGenerator/premade_questions/cst463/models/cnns.py

@@ -6,7 +6,7 @@ import numpy as np
 from typing import List, Tuple
 
 from QuizGenerator.question import Question, QuestionRegistry
-from QuizGenerator.contentast import ContentAST, AnswerTypes
+import QuizGenerator.contentast as ca
 from QuizGenerator.constants import MathRanges
 from .matrices import MatrixQuestion
 
@@ -65,72 +65,72 @@ class ConvolutionCalculation(MatrixQuestion):
     self.result = self.conv2d_multi_channel(self.image, self.kernel, stride=self.stride, padding=self.padding)
     
     self.answers = {
-      f"result_{i}" : AnswerTypes.Matrix(self.result[:,:,i], label=f"Result of filter {i}")
+      f"result_{i}" : ca.AnswerTypes.Matrix(self.result[:,:,i], label=f"Result of filter {i}")
       for i in range(self.result.shape[-1])
     }
     
     return True
   
-  def _get_body(self, **kwargs) -> Tuple[ContentAST.Section, List[ContentAST.Answer]]:
+  def _get_body(self, **kwargs) -> Tuple[ca.Section, List[ca.Answer]]:
     """Build question body and collect answers."""
-    body = ContentAST.Section()
+    body = ca.Section()
     answers = []
 
     body.add_elements(
       [
-        ContentAST.Text("Given image represented as matrix: "),
-        ContentAST.Matrix(self.image, name="image")
+        ca.Text("Given image represented as matrix: "),
+        ca.Matrix(self.image, name="image")
       ]
     )
 
     body.add_elements(
       [
-        ContentAST.Text("And convolution filters: "),
+        ca.Text("And convolution filters: "),
       ] + [
-        ContentAST.Matrix(self.kernel[:, :, i], name=f"Filter {i}")
+        ca.Matrix(self.kernel[:, :, i], name=f"Filter {i}")
         for i in range(self.kernel.shape[-1])
       ]
     )
 
     body.add_element(
-      ContentAST.Paragraph(
+      ca.Paragraph(
         [
           f"Calculate the output of the convolution operation.  Assume stride = {self.stride} and padding = {self.padding}."
         ]
       )
     )
 
-    body.add_element(ContentAST.LineBreak())
+    body.add_element(ca.LineBreak())
 
     for i in range(self.result.shape[-1]):
       answers.append(self.answers[f"result_{i}"])
       body.add_elements([
-        ContentAST.Container([
+        ca.Container([
           self.answers[f"result_{i}"],
-          ContentAST.LineBreak()
+          ca.LineBreak()
         ])
       ])
 
     return body, answers
 
-  def get_body(self, **kwargs) -> ContentAST.Section:
+  def get_body(self, **kwargs) -> ca.Section:
     """Build question body (backward compatible interface)."""
     body, _ = self._get_body(**kwargs)
     return body
   
-  def _get_explanation(self, **kwargs) -> Tuple[ContentAST.Section, List[ContentAST.Answer]]:
+  def _get_explanation(self, **kwargs) -> Tuple[ca.Section, List[ca.Answer]]:
     """Build question explanation."""
-    explanation = ContentAST.Section()
-    digits = ContentAST.Answer.DEFAULT_ROUNDING_DIGITS
+    explanation = ca.Section()
+    digits = ca.Answer.DEFAULT_ROUNDING_DIGITS
 
     explanation.add_element(
-      ContentAST.Paragraph([
+      ca.Paragraph([
         "To compute a 2D convolution, we slide the filter across the input image and compute the element-wise product at each position, then sum the results."
       ])
     )
 
     explanation.add_element(
-      ContentAST.Paragraph([
+      ca.Paragraph([
         f"With stride={self.stride} and padding={self.padding}: ",
         f"stride controls how many pixels the filter moves each step, ",
         f"and padding adds zeros around the border {'(no border in this case)' if self.padding == 0 else f'({self.padding} pixels)'}."
@@ -140,19 +140,19 @@ class ConvolutionCalculation(MatrixQuestion):
     # For each filter, show one detailed example computation
     for f_idx in range(self.kernel.shape[-1]):
       explanation.add_element(
-        ContentAST.Paragraph([
-          ContentAST.Text(f"Filter {f_idx}:", emphasis=True)
+        ca.Paragraph([
+          ca.Text(f"Filter {f_idx}:", emphasis=True)
         ])
       )
 
       # Show the filter (rounded)
       explanation.add_element(
-        ContentAST.Matrix(np.round(self.kernel[:, :, f_idx], digits), name=f"Filter {f_idx}")
+        ca.Matrix(np.round(self.kernel[:, :, f_idx], digits), name=f"Filter {f_idx}")
       )
 
       # Show ONE example computation (position 0,0)
       explanation.add_element(
-        ContentAST.Paragraph([
+        ca.Paragraph([
           "Example computation at position (0, 0):"
         ])
       )
@@ -177,22 +177,22 @@ class ConvolutionCalculation(MatrixQuestion):
       result_val = self.result[0, 0, f_idx]
 
       explanation.add_element(
-        ContentAST.Equation(f"{equation_str} = {result_val:.2f}")
+        ca.Equation(f"{equation_str} = {result_val:.2f}")
       )
 
       # Show the complete output matrix (rounded)
       explanation.add_element(
-        ContentAST.Paragraph([
+        ca.Paragraph([
           "Complete output:"
         ])
       )
       explanation.add_element(
-        ContentAST.Matrix(np.round(self.result[:, :, f_idx], digits))
+        ca.Matrix(np.round(self.result[:, :, f_idx], digits))
       )
 
     return explanation, []
 
-  def get_explanation(self, **kwargs) -> ContentAST.Section:
+  def get_explanation(self, **kwargs) -> ca.Section:
     """Build question explanation (backward compatible interface)."""
     explanation, _ = self._get_explanation(**kwargs)
     return explanation

QuizGenerator/premade_questions/cst463/models/rnns.py

@@ -7,7 +7,7 @@ from typing import List, Tuple
 
 from .matrices import MatrixQuestion
 from QuizGenerator.question import Question, QuestionRegistry
-from QuizGenerator.contentast import ContentAST, AnswerTypes
+import QuizGenerator.contentast as ca
 from QuizGenerator.constants import MathRanges
 from QuizGenerator.mixins import TableQuestionMixin
 
@@ -64,65 +64,65 @@ class RNNForwardPass(MatrixQuestion, TableQuestionMixin):
     ## Answers:
     # x_seq, W_xh, W_hh, b_h, h_0, h_states
     
-    self.answers["output_sequence"] = AnswerTypes.Matrix(value=self.h_states, label="Hidden states")
+    self.answers["output_sequence"] = ca.AnswerTypes.Matrix(value=self.h_states, label="Hidden states")
     
     return True
   
-  def _get_body(self, **kwargs) -> Tuple[ContentAST.Section, List[ContentAST.Answer]]:
+  def _get_body(self, **kwargs) -> Tuple[ca.Section, List[ca.Answer]]:
     """Build question body and collect answers."""
-    body = ContentAST.Section()
+    body = ca.Section()
     answers = []
 
     body.add_element(
-      ContentAST.Paragraph([
-        ContentAST.Text("Given the below information about an RNN, please calculate the output sequence."),
+      ca.Paragraph([
+        ca.Text("Given the below information about an RNN, please calculate the output sequence."),
         "Assume that you are using a tanh activation function."
       ])
     )
     body.add_element(
       self.create_info_table(
         {
-          ContentAST.Container(["Input sequence, ", ContentAST.Equation("x_{seq}", inline=True)]) : ContentAST.Matrix(self.x_seq),
-          ContentAST.Container(["Input weights, ",  ContentAST.Equation("W_{xh}", inline=True)])  : ContentAST.Matrix(self.W_xh),
-          ContentAST.Container(["Hidden weights, ", ContentAST.Equation("W_{hh}", inline=True)])  : ContentAST.Matrix(self.W_hh),
-          ContentAST.Container(["Bias, ",           ContentAST.Equation("b_{h}", inline=True)])   : ContentAST.Matrix(self.b_h),
-          ContentAST.Container(["Hidden states, ",  ContentAST.Equation("h_{0}", inline=True)])   : ContentAST.Matrix(self.h_0),
+          ca.Container(["Input sequence, ", ca.Equation("x_{seq}", inline=True)]) : ca.Matrix(self.x_seq),
+          ca.Container(["Input weights, ",  ca.Equation("W_{xh}", inline=True)])  : ca.Matrix(self.W_xh),
+          ca.Container(["Hidden weights, ", ca.Equation("W_{hh}", inline=True)])  : ca.Matrix(self.W_hh),
+          ca.Container(["Bias, ",           ca.Equation("b_{h}", inline=True)])   : ca.Matrix(self.b_h),
+          ca.Container(["Hidden states, ",  ca.Equation("h_{0}", inline=True)])   : ca.Matrix(self.h_0),
         }
       )
     )
 
-    body.add_element(ContentAST.LineBreak())
+    body.add_element(ca.LineBreak())
 
     answers.append(self.answers["output_sequence"])
     body.add_element(self.answers["output_sequence"])
 
     return body, answers
 
-  def get_body(self, **kwargs) -> ContentAST.Section:
+  def get_body(self, **kwargs) -> ca.Section:
     """Build question body (backward compatible interface)."""
     body, _ = self._get_body(**kwargs)
     return body
   
-  def _get_explanation(self, **kwargs) -> Tuple[ContentAST.Section, List[ContentAST.Answer]]:
+  def _get_explanation(self, **kwargs) -> Tuple[ca.Section, List[ca.Answer]]:
     """Build question explanation."""
-    explanation = ContentAST.Section()
-    digits = ContentAST.Answer.DEFAULT_ROUNDING_DIGITS
+    explanation = ca.Section()
+    digits = ca.Answer.DEFAULT_ROUNDING_DIGITS
 
     explanation.add_element(
-      ContentAST.Paragraph([
+      ca.Paragraph([
     "For an RNN forward pass, we compute the hidden state at each time step using:"
       ])
     )
 
     explanation.add_element(
-      ContentAST.Equation(r"h_t = \tanh(x_t W_{xh} + h_{t-1} W_{hh} + b_h)")
+      ca.Equation(r"h_t = \tanh(x_t W_{xh} + h_{t-1} W_{hh} + b_h)")
     )
 
     explanation.add_element(
-      ContentAST.Paragraph([
-        "Where the input contributes via ", ContentAST.Equation("W_{xh}", inline=True),
-        ", the previous hidden state contributes via ", ContentAST.Equation("W_{hh}", inline=True),
-        ", and ", ContentAST.Equation("b_h", inline=True), " is the bias."
+      ca.Paragraph([
+        "Where the input contributes via ", ca.Equation("W_{xh}", inline=True),
+        ", the previous hidden state contributes via ", ca.Equation("W_{hh}", inline=True),
+        ", and ", ca.Equation("b_h", inline=True), " is the bias."
       ])
     )
 
@@ -137,12 +137,12 @@ class RNNForwardPass(MatrixQuestion, TableQuestionMixin):
     seq_len = len(self.x_seq)
     num_examples = min(2, seq_len)
 
-    explanation.add_element(ContentAST.Paragraph([""]))
+    explanation.add_element(ca.Paragraph([""]))
 
     for t in range(num_examples):
       explanation.add_element(
-        ContentAST.Paragraph([
-          ContentAST.Text(f"Example: Timestep {t}", emphasis=True)
+        ca.Paragraph([
+          ca.Text(f"Example: Timestep {t}", emphasis=True)
         ])
       )
 
@@ -162,53 +162,53 @@ class RNNForwardPass(MatrixQuestion, TableQuestionMixin):
       h_result = np.tanh(pre_activation)
 
       explanation.add_element(
-        ContentAST.Paragraph([
+        ca.Paragraph([
           "Input contribution: ",
-          ContentAST.Equation(f'x_{t} W_{{xh}}', inline=True),
+          ca.Equation(f'x_{t} W_{{xh}}', inline=True),
           f" = {format_array(x_contribution)}"
         ])
       )
 
       explanation.add_element(
-        ContentAST.Paragraph([
+        ca.Paragraph([
           "Hidden contribution: ",
-          ContentAST.Equation(f'{h_prev_label} W_{{hh}}', inline=True),
+          ca.Equation(f'{h_prev_label} W_{{hh}}', inline=True),
           f"{h_prev_desc} = {format_array(h_contribution)}"
         ])
       )
 
       explanation.add_element(
-        ContentAST.Paragraph([
+        ca.Paragraph([
           f"Pre-activation: {format_array(pre_activation)}"
         ])
       )
 
       explanation.add_element(
-        ContentAST.Paragraph([
+        ca.Paragraph([
           "After tanh: ",
-          ContentAST.Equation(f'h_{t}', inline=True),
+          ca.Equation(f'h_{t}', inline=True),
           f" = {format_array(h_result)}"
         ])
       )
 
       # Add visual separator between timesteps (except after the last one)
       if t < num_examples - 1:
-        explanation.add_element(ContentAST.Paragraph([""]))
+        explanation.add_element(ca.Paragraph([""]))
 
     # Show complete output sequence (rounded)
     explanation.add_element(
-      ContentAST.Paragraph([
+      ca.Paragraph([
         "Complete hidden state sequence (each row is one timestep):"
       ])
     )
 
     explanation.add_element(
-      ContentAST.Matrix(np.round(self.h_states, digits))
+      ca.Matrix(np.round(self.h_states, digits))
     )
 
     return explanation, []
 
-  def get_explanation(self, **kwargs) -> ContentAST.Section:
+  def get_explanation(self, **kwargs) -> ca.Section:
     """Build question explanation (backward compatible interface)."""
     explanation, _ = self._get_explanation(**kwargs)
     return explanation