in2lambda 0.3.0__py3-none-any.whl → 0.3.2__py3-none-any.whl

in2lambda/api/module.py

@@ -6,6 +6,7 @@ from typing import Union
 import panflute as pf
 
 from in2lambda.api.question import Question
+from in2lambda.json_convert import json_convert
 
 
 @dataclass
@@ -28,11 +29,11 @@ class Module:
         Examples:
             >>> from in2lambda.api.module import Module
             >>> Module().current_question
-            Question(title='INVALID', parts=[], images=[], _main_text='')
+            Question(title='INVALID', parts=[], images=[], main_text='')
             >>> module = Module()
             >>> module.add_question()
             >>> module.current_question
-            Question(title='', parts=[], images=[], _main_text='')
+            Question(title='', parts=[], images=[], main_text='')
         """
         return (
             self.questions[self._current_question_index]
@@ -56,7 +57,7 @@ class Module:
             >>> module = Module()
             >>> module.add_question("Some title", pf.Para(pf.Str("hello"), pf.Space, pf.Str("there")))
             >>> module
-            Module(questions=[Question(title='Some title', parts=[], images=[], _main_text='hello there')])
+            Module(questions=[Question(title='Some title', parts=[], images=[], main_text='hello there')])
             >>> module.add_question(main_text="Normal string text")
             >>> module.questions[1].main_text
             'Normal string text'
@@ -85,7 +86,37 @@ class Module:
             >>> module.increment_current_question()
             >>> module.current_question.add_solution("Question 2 answer")
             >>> module.questions
-            [Question(title='Question 1', parts=[Part(text='', worked_solution='Question 1 answer')], images=[], _main_text=''),\
- Question(title='Question 2', parts=[Part(text='', worked_solution='Question 2 answer')], images=[], _main_text='')]
+            [Question(title='Question 1', parts=[Part(text='', worked_solution='Question 1 answer')], images=[], main_text=''),\
+ Question(title='Question 2', parts=[Part(text='', worked_solution='Question 2 answer')], images=[], main_text='')]
         """
         self._current_question_index += 1
+
+    def to_json(self, output_dir: str) -> None:
+        """Turns this module into Lambda Feedback JSON/ZIP files.
+
+        WARNING: This will overwrite any existing files in the directory.
+
+        Args:
+            output_dir: Where to output the final Lambda Feedback JSON/ZIP files.
+
+        Examples:
+            >>> import tempfile
+            >>> import os
+            >>> import json
+            >>> # Create a module with two questions
+            >>> module = Module()
+            >>> module.add_question("Question 1")
+            >>> module.add_question("Question 2")
+            >>> with tempfile.TemporaryDirectory() as temp_dir:
+            ...     # Write the JSON files to the temporary directory
+            ...     module.to_json(temp_dir)
+            ...     # Check the contents of the directory
+            ...     sorted(os.listdir(temp_dir))
+            ...     # Check the title of the first question
+            ...     with open(f"{temp_dir}/question_1/question_1.json") as file:
+            ...         print(f"Question 1's title: {json.load(file)['title']}")
+            ['question_1', 'question_1.zip', 'question_2', 'question_2.zip']
+            Question 1's title: Question 1
+
+        """
+        json_convert.main(self.questions, output_dir)

in2lambda/api/question.py

@@ -16,8 +16,8 @@ class Question:
 
     Examples:
         >>> from in2lambda.api.question import Question
-        >>> Question(title="Some title", _main_text="Some text")
-        Question(title='Some title', parts=[], images=[], _main_text='Some text')
+        >>> Question(title="Some title", main_text="Some text")
+        Question(title='Some title', parts=[], images=[], main_text='Some text')
     """
 
     title: str = ""
@@ -25,7 +25,11 @@ class Question:
     parts: list[Part] = field(default_factory=list)
     images: list[str] = field(default_factory=list)
 
-    _main_text: str = ""
+    # Use getter/setter methods for main_text without exposing private attribute.
+    # See https://stackoverflow.com/a/61480946
+    main_text: str = ""
+    _main_text: str = field(init=False, repr=False, default="")
+
     _last_part: dict[str, int] = field(
         default_factory=lambda: {"solution": 0, "text": 0}, repr=False
     )
@@ -34,15 +38,10 @@ class Question:
 
     @property
     def main_text(self) -> str:
-        """Main top-level question text."""
-        return self._main_text
+        r"""Main top-level question text.
 
-    @main_text.setter
-    def main_text(self, value: Union[pf.Element, str]) -> None:
-        r"""Appends to the top-level main text, which starts off as an empty string.
-
-        Args:
-            value: A panflute element or string denoting what to append to the main text.
+        Setting the attribute multiple times appends to the current value with a newline.
+        This allows question text to be dynamically appended.
 
         Examples:
             >>> from in2lambda.api.question import Question
@@ -52,7 +51,28 @@ class Question:
             >>> question.main_text
             'hello\nthere'
         """
-        text_value = value if isinstance(value, str) else pf.stringify(value, False)
+        return self._main_text
+
+    @main_text.setter
+    def main_text(self, value: Union[pf.Element, str, property]) -> None:
+        r"""Appends to the top-level main text, which starts off as an empty string.
+
+        Args:
+            value: A panflute element or string denoting what to append to the main text.
+
+        See example in main_text property.
+        """
+        # Converts the inputted value into a string, stored in text_value
+        match value:
+            case str():
+                text_value = value
+            case property():
+                # Use default value when no value set at initialisation.
+                # See https://stackoverflow.com/a/61480946
+                text_value = self.main_text
+            case pf.Element():
+                text_value = pf.stringify(value, False)
+
         if self._main_text:
             self._main_text += "\n"
         self._main_text += text_value
@@ -69,7 +89,7 @@ class Question:
             >>> question.add_part_text("part a")
             >>> question.add_solution("part a solution")
             >>> question
-            Question(title='', parts=[Part(text='part a', worked_solution='part a solution')], images=[], _main_text='')
+            Question(title='', parts=[Part(text='part a', worked_solution='part a solution')], images=[], main_text='')
             >>> question.add_part_text("part b")
             >>> question.add_part_text("part c")
             >>> question.add_solution("Solution for b")
@@ -77,12 +97,12 @@ class Question:
             >>> question
             Question(title='', parts=[Part(text='part a', worked_solution='part a solution'), \
 Part(text='part b', worked_solution='Solution for b'), \
-Part(text='part c', worked_solution='Solution for b')], images=[], _main_text='')
+Part(text='part c', worked_solution='Solution for b')], images=[], main_text='')
             >>> question.add_solution("We now have a solution for c!")
             >>> question
             Question(title='', parts=[Part(text='part a', worked_solution='part a solution'), \
 Part(text='part b', worked_solution='Solution for b'), \
-Part(text='part c', worked_solution='We now have a solution for c!')], images=[], _main_text='')
+Part(text='part c', worked_solution='We now have a solution for c!')], images=[], main_text='')
         """
         elem_text = elem if isinstance(elem, str) else pf.stringify(elem)
 
@@ -111,13 +131,13 @@ Part(text='part c', worked_solution='We now have a solution for c!')], images=[]
             >>> question.add_part_text("part a")
             >>> question.add_solution("part a solution")
             >>> question
-            Question(title='', parts=[Part(text='part a', worked_solution='part a solution')], images=[], _main_text='')
+            Question(title='', parts=[Part(text='part a', worked_solution='part a solution')], images=[], main_text='')
             >>> # Supports adding the answer first.
             >>> question.add_solution("part b solution")
             >>> question.add_part_text("part b")
             >>> question
             Question(title='', parts=[Part(text='part a', worked_solution='part a solution'), \
-Part(text='part b', worked_solution='part b solution')], images=[], _main_text='')
+Part(text='part b', worked_solution='part b solution')], images=[], main_text='')
         """
         elem_text = elem if isinstance(elem, str) else pf.stringify(elem)
 

in2lambda/example_questions.tex

@@ -0,0 +1,231 @@
+\documentclass[12pt]{article}
+
+% Mechanics course definitions and macros.
+%\usepackage{mechanics}
+\usepackage{graphicx}
+
+% Add space between paragraphs instead of indenting.
+\usepackage{parskip}
+
+\addtolength{\topmargin}{-4em}
+\addtolength{\evensidemargin}{-3em}
+\addtolength{\oddsidemargin}{-3em}
+\addtolength{\textheight}{6em}
+\addtolength{\textwidth}{4em}
+
+%\usepackage{bm}
+\usepackage{graphics}
+\usepackage{color}
+\usepackage{amsmath}
+
+\begin{document}
+\section*{\textrm{\textbf{Mechanics Problem Sheet 4 --- Collisions and CoM frame}}} 
+
+\begin{enumerate}
+%\begin{enumerate}
+\item The ballistic pendulum is a device for determining the speed of a
+  projectile. A large stationary mass $M$ is suspended by a wire from
+  the ceiling and a projectile of mass $m$ is fired into it at an
+  unknown speed $u$. The projectile embeds itself in the hanging mass.
+  Assume that $g = 9.8\,\text{m}\cdot\text{s}^{-2}$.
+  \begin{enumerate}
+  \item Is momentum conserved in the collision? Is kinetic energy
+    conserved?
+  \item Derive an expression for the height $h$ to which the masses rise
+    after the collision.
+  \item A bullet of mass $m = 12\,$g is fired into a block of mass
+    $M = 10\,$kg and the height rise $h$ is measured to be $10\,$cm.
+    What was the speed of the bullet?
+  \end{enumerate}
+
+\item A ping-pong (table tennis) ball makes a head-on elastic collision
+  with a much heavier basketball, which is initially stationary. Which 
+  of the following statements are true after the collision?
+  \begin{enumerate}
+  \item The absolute value of the momentum of the ping-pong ball is
+    smaller than that of the basketball.
+  \item The absolute value of the momentum of the ping-pong ball is the
+    same as that of the basketball.
+  \item The absolute value of the momentum of the ping-pong ball is
+    greater than that of the basketball.
+  \item Not enough information is given to decide between (a), (b) and
+    (c).
+  \item The ping-pong ball has less kinetic energy than the basketball.
+  \item The ping-pong ball has the same kinetic energy as the
+    basketball.
+  \item The ping-pong ball has more kinetic energy than the basketball.
+  \item Not enough information is given to decide between (e), (f) and
+    (g).
+  \end{enumerate}
+
+\item Question 3 on Problem Sheet 3 (repeated below) was about a woman
+  walking along a plank on a frictionless frozen lake. Solve this
+  problem again, this time using the concept of the centre of mass.
+
+%  \begin{tcolbox}{0.96\textwidth}
+%  {Woman walking along a plank on a frozen lake} 
+    A woman of mass 60\,kg stands at one end of a 10\,m plank of
+    mass 20\,kg, which itself lies on a (frictionless) frozen lake. She
+    walks to the other end of the plank. Work out how far she has
+    travelled relative to the lake.
+ % \end{tcolbox}
+
+\item Two masses, $m_1 = 4\,$kg and $m_2 = 6\,$kg, are moving in the
+  $x$-$y$ plane. The position of $m_1$ is given by
+  $\vec{\boldsymbol{r}}_1(t) = (1 + 3t)\boldsymbol{\hat{i}} + t\boldsymbol{\hat{j}}$ and the position of $m_2$ by
+  $\vec{\boldsymbol{r}}_2(t) = -2t\boldsymbol{\hat{i}} + 5\boldsymbol{\hat{j}}$. Positions are measured in metres and
+  the time $t$ is measured in seconds.
+  \begin{enumerate}
+  \item What is the reduced mass of the system?
+  \item What is the velocity of the centre of mass?
+  \item What is the velocity of $m_1$ relative to $m_2$?
+  \item What is the momentum of $m_1$ in the centre-of-mass frame?
+  \item What is the total kinetic energy of the system in the
+    centre-of-mass frame?
+  \end{enumerate}
+
+\item The position $\vec{\boldsymbol{R}}(t)$ of the centre of mass of $N$ objects with
+  masses $m_i$ at positions $\vec{\boldsymbol{r}}_i(t)$ is given by:
+  %
+  \begin{displaymath}
+    \vec{\boldsymbol{R}}(t) = \frac{\sum_{i=1}^{N} m_i \vec{\boldsymbol{r}}_i(t)}{\sum_{i=1}^{N} m_i} .
+  \end{displaymath}
+  %
+  Show that the vector sum of the momenta of all of the masses is zero
+  in the centre-of-mass frame. In other words, show that the
+  centre-of-mass frame is also the zero-momentum frame.
+  
+\item In lectures, you saw that the total laboratory-frame kinetic
+  energy of two particles is the sum of their kinetic energy in the
+  centre-of-mass frame and the kinetic energy of the centre of mass in
+  the laboratory frame. Show that the same result holds for a system of
+  $N$ particles. You may assume (because you proved it in the previous question) that the
+  total momentum of the $N$ particles is zero in the centre-of-mass
+  frame.
+
+\item In one-dimensional inelastic collisions, the coefficient of
+  restitution $e$ is defined by the equation
+  % 
+  \begin{displaymath}
+    v_2 - v_1 = -e (u_2 - u_1),
+  \end{displaymath}
+  % 
+  where $v_1$ and $v_2$ are the final velocities of the two bodies and
+  $u_1$ and $u_2$ are their initial velocities. Use this equation, plus
+  momentum conservation, to derive the following expressions for the
+  final velocities of the two bodies (of masses $m_1$ and $m_2$) in the
+  case when the second body is initially at rest ($u_2 = 0$):
+  % 
+  \begin{align*}
+    v_1 &= \frac{(m_1 - e m_2) u_1}{m_1 + m_2},
+    &
+      v_2 &= \frac{(1 + e)m_1 u_1}{m_1 + m_2}.
+  \end{align*}
+
+
+
+%\end{enumerate}
+
+
+%\subsection*{Problems for Reflection and Discussion}
+
+
+%\begin{enumerate}
+\item 
+  A ball is dropped onto a table from an initial height $h_0$. If it
+  lands with speed $v$, it bounces up with speed $ev$, where the
+  coefficient of restitution $e$ is a positive constant less than 1.
+  %
+  \begin{enumerate}
+  \item Write down expressions for the speed $v_0$ of the ball when it
+    first hits the table and the time $t_0$ it takes to drop.
+    
+  \item Find the height $h_1$ reached by the ball after its first bounce
+    and the corresponding drop time $t_1$. Write down expressions for
+    the height $h_n$ and drop time $t_n$ of the $n^{\text{th}}$ bounce.
+  \item How long does the ball take to stop completely? Evaluate this
+    time if the initial height $h_0 = 5\,$m and the coefficient of
+    restitution $e = 0.5$. Take $g = 10\,\text{m}\cdot\text{s}^{-2}$.
+
+    [Hint: you will need the formula for the sum of a geometric series:
+
+    \centerline{$\displaystyle a + ar + ar^2 + ar^3 + \ldots =
+      \frac{a}{1-r}, \qquad |r|<1.]$}
+  \end{enumerate}
+  
+\item In the chemical reaction $\text{NO} + \text{O}_3 \rightarrow
+  \text{NO}_2 + \text{O}_2$, there is an intermediate step where the
+  $\text{NO}$ and $\text{O}_3$ molecules combine to form an activated
+  complex $[\text{NO--O}_3]^{\ast}$. The diagram below shows an
+  empirical potential energy curve representing the three different
+  stages of the reaction.
+  %
+  \begin{center}
+    \includegraphics[width=0.75\textwidth]{figures/activated_complex.png}
+  \end{center}
+  %
+  Although the $x$ axis corresponds to an unspecified reaction
+  coordinate, the diagram can be interpreted as any other potential
+  function. The peak of the potential curve is 9.6\,kJ$\cdot$ mol$^{-1}$
+  above the combined potential energy of the $\text{NO} + \text{O}_3$
+  reactants; this is the ``activation energy'' required for the reaction
+  to take place. One mole consists of Avogadro's number, $6.022 \times
+  10^{23}$, of $[\text{NO--O}_3]^{\ast}$ complexes. The mass of a
+  nitrogen atom is 14 atomic mass units and the mass of an oxygen
+  atom is 16 atomic mass units.
+
+  \smallskip
+  
+  An $\text{NO}$ molecule travelling in the $x$ direction at speed
+  $u_{\text{NO}} = -550\,\text{m}\cdot\text{s}^{-1}$ and an $\text{O}_3$
+  molecule travelling at
+  $u_{\text{O}_3} = +550\,\text{m}\cdot\text{s}^{-1}$ collide. After the
+  collision, the molecules temporarily coalesce to form an
+  $[\text{NO--O}_3]^{\ast}$ complex.
+  \begin{enumerate}
+  \item Find the velocity of the $[\text{NO--O}_3]^{\ast}$ complex
+    after the collision.
+  \item Show that the collision is inelastic. What has happened to the
+    kinetic energy lost in the collision?
+  \item Will this collision lead to the formation of $\text{NO}_2$?
+    Explain your answer.
+  \item Two oxygen atoms collide in isolation. Could the collision
+    result in the formation of an $\text{O}_2$ molecule in the right
+    circumstances?
+  \end{enumerate}
+  
+
+\item Show that the velocity $v(t)$ of a rocket starting from rest and
+  accelerating against the Earth's gravity is given by
+  %
+  \begin{displaymath}
+    v(t) = u\ln \left ( \frac{M_0}{M(t)} \right ) - gt.
+  \end{displaymath}
+  The exhaust speed is $u$, the initial mass is $M_0$, and the mass
+  after time $t$ is $M(t)$. Neglect the dependence of $g$ on height.
+
+\item A two-stage rocket accelerates in free space by ejecting fuel at a
+  constant relative speed $u$. Three-quarters of its initial mass is
+  fuel. It accelerates from rest until $2/3$ of the fuel is burnt. The
+  first stage is then detached. Fuel accounts for $4/5$ of the mass of
+  the second stage. Show that the final speed of the second stage is
+  equal to $u\ln(10)$.
+
+  Show that a single-stage rocket of the same initial mass, burning 
+  the same total mass of fuel, would reach a final speed of 
+  approximately $0.6u\ln(10)$.
+
+\end{enumerate}
+
+
+  
+%\subsubsection*{Numerical Answers}
+%
+%\begin{list}{}{\setlength{\itemsep}{0em}\setlength{\labelwidth}{6em}}
+%\item[1.] 2.5\,m.
+%\item[2.] (a) 2.4\,kg; (b) $0.4\boldsymbol{\hat{j}}\,$m\udot s$^{-1}$; (c) $(5\boldsymbol{\hat{i}} +
+%  \boldsymbol{\hat{j}})\,$m\udot s$^{-1}$; (d) $(12\boldsymbol{\hat{i}} + 2.4\boldsymbol{\hat{j}})\,$kg\udot m\udot
+%  s$^{-1}$; (e) 31.2\,J.
+%\end{list}
+
+\end{document}

in2lambda/example_solutions.tex

@@ -0,0 +1,567 @@
+\documentclass[12pt]{article}
+
+% Mechanics course definitions and macros.
+%\usepackage{mechanics}
+\usepackage{graphicx}
+
+% Add space between paragraphs instead of indenting.
+\usepackage{parskip}
+
+\addtolength{\topmargin}{-4em}
+\addtolength{\evensidemargin}{-3em}
+\addtolength{\oddsidemargin}{-3em}
+\addtolength{\textheight}{6em}
+\addtolength{\textwidth}{4em}
+
+%\usepackage{bm}
+\usepackage{graphics}
+\usepackage{color}
+\usepackage{amsmath}
+
+\begin{document}
+\section*{Mechanics Answer Sheet 4} 
+
+\begin{enumerate}
+  \item
+  \begin{enumerate}
+
+  \item Momentum is conserved. Kinetic energy is not conserved. (The
+    collision is said to be \textbf{inelastic}.)
+
+  \item Immediately after the collision, the block and projectile have
+    merged into a single object of mass $M+m$ with total momentum $mu$.
+    The speed $U$ of the merged block and projectile is given by
+    % 
+    \begin{displaymath}
+      (M + m)U = mu \qquad \Rightarrow \qquad U = \frac{mu}{M+m} ,
+    \end{displaymath}
+    %
+    and its kinetic energy $K$ is
+    %
+    \begin{displaymath}
+      K = \frac{1}{2}(M+m)U^2 = \frac{m^2 u^2}{2(M+m)}.
+    \end{displaymath}
+    %
+    At the maximum height $h$, all of this kinetic energy has become
+    gravitational potential energy:
+    %
+    \begin{displaymath}
+      (M+m)gh =  \frac{m^2 u^2}{2(M+m)}.
+    \end{displaymath}
+    %
+    Hence
+    %
+    \begin{displaymath}
+      h = \frac{m^2 u^2}{2(M+m)^2 g}.
+    \end{displaymath}
+
+  \item The question says that $m = 12\,$g = $0.012\,$kg, $M = 10\,$kg,
+    and $h = 10\,$cm $= 0.1\,$m. Rearranging the result of part (b)
+    gives
+    %
+    \begin{displaymath}
+      u = \frac{M+m}{m} \sqrt{2gh}
+          = \frac{10.012}{0.012} \sqrt{2 \times 9.8 \times 0.1} \approx
+          1168 \, \text{m}\cdot\text{s}^{-1} \approx 1.17\,\text{km}\cdot\text{s}^{-1}.
+    \end{displaymath}
+
+  \end{enumerate}
+  
+\item Suppose the woman of mass $60\,$kg starts at the origin
+  ($X_{\text{woman}} = 0$) standing on the left-hand end of the plank.
+  The centre of mass of the $10\,$m long plank of mass $20\,$kg is at
+  $X_{\text{plank}} = 5\,$m, and the centre of mass of the joint system
+  (woman $+$ plank) is at
+  \[
+    X = \frac{60 \times X_{\text{woman}} + 20 \times X_{\text{plank}}}
+    {60 + 20} = 1.25\,\text{m}.
+  \]
+
+  There are no externally applied horizontal forces acting on the woman
+  $+$ plank (treated as one system), so the position $X$ of the centre
+  of mass cannot change. The diagram below, which pictures the woman and
+  plank before and after she walks from one end to the other, shows that
+  she moves a total distance of $2X = 2.5\,$m relative to the frozen
+  surface of the lake.
+
+\item
+  \begin{enumerate}
+
+  \item Using the formula
+    $\displaystyle \frac{1}{\mu} = \frac{1}{m_1} + \frac{1}{m_2}$ gives
+    $\mu = 2.4\,$kg.
+
+  \item Differentiating the definition of the centre of mass,
+    %
+    \begin{displaymath}
+      \vec{\boldsymbol{R}} = \frac{m_1 \vec{\boldsymbol{r}}_1 + m_2 \vec{\boldsymbol{r}}_2}{m_1 + m_2} ,
+    \end{displaymath}
+    %
+    gives a formula for the velocity of the centre of mass:
+    %
+    \begin{displaymath}
+      \dot{\vec{\boldsymbol{R}}} = \frac{m_1 \vec{\boldsymbol{v}}_1 + m_2 \vec{\boldsymbol{v}}_2}{m_1 + m_2}.
+    \end{displaymath}
+    %
+    We are told that $\vec{\boldsymbol{r}}_1 = (1 + 3t)\boldsymbol{\hat{i}} + t\boldsymbol{\hat{j}}$ and
+    $\vec{\boldsymbol{r}}_2 = -2t\boldsymbol{\hat{i}} + 5\boldsymbol{\hat{j}}$, so $\vec{\boldsymbol{v}}_1 = \dot{\vec{\boldsymbol{r}}}_1 = 3\boldsymbol{\hat{i}} + \boldsymbol{\hat{j}}$ and
+    $\vec{\boldsymbol{v}}_2 = \dot{\vec{\boldsymbol{r}}}_2 = -2\boldsymbol{\hat{i}}$. Hence
+    \begin{displaymath}
+      \dot{\vec{\boldsymbol{R}}} = \frac{4(3\boldsymbol{\hat{i}} + \boldsymbol{\hat{j}}) + 6(-2\boldsymbol{\hat{i}})}{4 + 6} = 0.4\boldsymbol{\hat{j}}
+      \;\text{m}\cdot\text{s}^{-1}.
+    \end{displaymath}
+
+  \item The velocity of $m_1$ relative to $m_2$ is
+    \begin{displaymath}
+      \vec{\boldsymbol{v}}_1 - \vec{\boldsymbol{v}}_2 = (3\boldsymbol{\hat{i}} + \boldsymbol{\hat{j}}) - (-2\boldsymbol{\hat{i}}) = (5\boldsymbol{\hat{i}} + \boldsymbol{\hat{j}})\,\text{m}\cdot\text{s}^{-1}.
+    \end{displaymath}
+
+  \item The momentum of $m_1$ in the centre-of-mass frame is
+    \begin{displaymath}
+      \vec{\boldsymbol{p}}_1^{\ast} = m_1(\vec{\boldsymbol{v}}_1 - \dot{\vec{\boldsymbol{R}}}) = 4(3\boldsymbol{\hat{i}} + 0.6\boldsymbol{\hat{j}})
+      = (12\boldsymbol{\hat{i}} + 2.4\boldsymbol{\hat{j}}) \, \text{kg}\cdot\text{m}\cdot\text{s}^{-1}.
+      \end{displaymath}
+
+  \item The velocities of the two particles in the centre-of-mass frame
+    are:
+    \begin{align*}
+      \vec{\boldsymbol{v}}_1^{\ast} &= \vec{\boldsymbol{v}}_1 - \dot{\vec{\boldsymbol{R}}} = (3\boldsymbol{\hat{i}} +
+                     0.6\boldsymbol{\hat{j}})\,\text{m}\cdot\text{s}^{-1}, \\
+      \vec{\boldsymbol{v}}_2^{\ast} &= \vec{\boldsymbol{v}}_2 - \dot{\vec{\boldsymbol{R}}} = (-2\boldsymbol{\hat{i}} -
+                     0.4\boldsymbol{\hat{j}})\,\text{m}\cdot\text{s}^{-1}.
+    \end{align*}
+    %
+    Their kinetic energies are
+    %
+    \begin{align*}
+      \frac{1}{2}m_1 (v_1^{\ast})^2 &= \frac{1}{2} 4 \left ( 3^2 +
+                                      (0.6)^2 \right ) =
+                                      18.72\,\text{J}, \\
+      \frac{1}{2}m_2 (v_2^{\ast})^2 &= \frac{1}{2} 6 \left ( 2^2 +
+                                      (0.4)^2 \right ) =
+                                      12.48\,\text{J}.
+    \end{align*}
+    %
+    The total kinetic energy in the centre-of-mass frame is $31.2\,$J.
+
+  \end{enumerate}
+
+\item As in the answer to Q2(b), the velocity of the centre of mass can
+  be found by differentiating the equation for $\vec{\boldsymbol{R}}(t)$:
+  %
+  \begin{displaymath}
+    \dot{\vec{\boldsymbol{R}}} = \frac{d}{dt} \left (
+      \frac{\sum_{i=1}^{N} m_i \vec{\boldsymbol{r}}_i}{\sum_{i=1}^{N} m_i}
+    \right ) = \frac{\sum_{i=1}^{N} m_i \vec{\boldsymbol{v}}_i}{\sum_{i=1}^{N} m_i}
+    = \frac{\sum_{i=1}^{N} m_i \vec{\boldsymbol{v}}_i}{M}
+  \end{displaymath}
+  %
+  where $M \equiv \sum_{i=1}^{N} m_i$. Since the velocity
+  $\vec{\boldsymbol{v}}_i^{\ast}$ of mass $m_i$ in the centre-of-mass frame is given by
+  $\vec{\boldsymbol{v}}_i - \dot{\vec{\boldsymbol{R}}}$, its momentum
+  $\vec{\boldsymbol{p}}_i^{\ast} = m_i(\vec{\boldsymbol{v}}_i - \dot{\vec{\boldsymbol{R}}})$. The total momentum in the
+  centre-of-mass frame is
+  %
+  \begin{align*}
+    \sum_{i=1}^{N} \vec{\boldsymbol{p}}_i^{\ast}
+    &=  \sum_{i=1}^{N} m_i (\vec{\boldsymbol{v}}_i - \dot{\vec{\boldsymbol{R}}} ) \\
+    &= \sum_{i=1}^{N} m_i \vec{\boldsymbol{v}}_i - \dot{\vec{\boldsymbol{R}}} \sum_{i=1}^{N} m_i \\
+    &= M \left ( \frac{\sum_{i=1}^{N} m_i \vec{\boldsymbol{v}}_i}{M} - \dot{\vec{\boldsymbol{R}}}
+      \right ) \\
+    &= 0. \qquad\qquad
+      \text{(Note that this is a zero \underline{vector}.)}
+  \end{align*}
+  %
+  The final step used the equation for $\dot{\vec{\boldsymbol{r}}}$ above.
+
+\item The total laboratory-frame kinetic energy of the $N$ particles
+  (masses $m_i$, velocities $\vec{\boldsymbol{v}}_i$) is
+  %
+  \begin{displaymath}
+    K = \sum_{i=1}^{N} \frac{1}{2} m_i v_i^2 .
+  \end{displaymath}
+  %
+  The laboratory (unstarred) and centre-of-mass (starred) velocities of
+  the particles are related by $\vec{\boldsymbol{v}}_i^{\phantom{}} = \vec{\boldsymbol{v}}_i^{\ast} +
+  \dot{\vec{\boldsymbol{R}}}$, where
+  %
+  \begin{displaymath}
+    \dot{\vec{\boldsymbol{R}}} = \frac{\sum_{i=1}^{N} m_i \vec{\boldsymbol{v}}_i}{\sum_{i=1}^{N} m_i}
+  \end{displaymath}
+  %
+  is the velocity of the centre of mass. Hence
+  %
+  \begin{align*}
+    K &= \frac{1}{2} \sum_{i=1}^{N} m_i^{\phantom{}} 
+        \left ( \vec{\boldsymbol{v}}_i^{\ast} + \dot{\vec{\boldsymbol{R}}} \right )^2 \\
+      &= \frac{1}{2} \sum_{i=1}^{N} m_i^{\phantom{}} \left [  
+        \left ( v_i^{\ast} \right)^2 + 
+        2 (\vec{\boldsymbol{v}}_i^{\ast}\cdot \dot{\vec{\boldsymbol{R}}}) + \dot{R}^2 \right ] \\
+      &= \frac{1}{2} \sum_{i=1}^{N} m_i^{\phantom{}} 
+        \left ( v_i^{\ast}\right )^2  
+        + \left ( \sum_{i=1}^{N} m_i^{\phantom{}} \vec{\boldsymbol{v}}_i^{\ast} \right ) 
+        \cdot \dot{\vec{\boldsymbol{R}}}
+        + \frac{1}{2} \left ( \sum_{i=1}^{N} m_i^{\phantom{}} \right ) 
+        \dot{R}^2 \\
+      &= \frac{1}{2}\sum_{i=1}^{N} m_i^{\phantom{}} 
+        \left ( v_i^{\ast} \right )^2 + \frac{1}{2} M \dot{R}^2 
+        \qquad (\text{where } M \equiv \sum_{i=1}^{N} m_i^{\phantom{}}) \\
+      &= K^{\ast} + \frac{1}{2} M \dot{R}^2 \\
+      &= \text{(KE in centre-of-mass frame)} + \text{(KE of centre of mass)}.
+  \end{align*}
+  %
+  The cross term vanished because $\sum_{i=1}^{N} m_i^{\phantom{}}
+  \vec{\boldsymbol{v}}_i^{\ast}$ is the total momentum in the centre-of-mass frame, which
+  Q2 showed is always zero.
+
+\item Start by writing down the definition of the coefficient of
+  restitution and the law of conservation of momentum in the case when
+  $u_2 = 0$:
+  %
+  \begin{align*}
+    v_2 - v_1 &= eu_1 ,\\
+    m_1 v_1 + m_2 v_2 &= m_1 u_1 .
+  \end{align*}
+  %
+  Our job is to solve for $v_1$ and $v_2$ as functions of $u_1$. One way
+  is to multiply the first equation by $m_1$,
+  %
+  \begin{displaymath}
+    m_1 v_2 - m_1 v_1 = e m_1 u_1,
+  \end{displaymath}
+  %
+  and add it to the second equation to obtain
+  %
+  \begin{displaymath}
+    m_2 v_2 + m_1 v_2 = m_1 u_1 + e m_1 u_1 ,
+  \end{displaymath}
+  % 
+  which rearranges to give
+  %
+  \begin{displaymath}
+    v_2 = \frac{(1 + e)m_1 u_1}{m_1 + m_2}.
+  \end{displaymath}
+  %
+  Plugging this back into $v_1 - v_2 = -eu_1$ yields
+  %
+  \begin{displaymath}
+    v_1 = v_2 - eu_1 = \frac{(1+e)m_1 u_1}{m_1 + m_2} - \frac{e(m_1 +
+    m_2)u_1}{m_1 + m_2} = \frac{(m_1 - e m_2)u_1}{m_1 + m_2}.
+  \end{displaymath}
+
+
+\item Options (a) and (g) are true.
+
+  The ping-pong ball of mass $m$ is so much lighter than the basketball
+  of mass $M$ that its momentum almost reverses when it collides:
+  $m\vec{\boldsymbol{u}}_m \rightarrow -m\vec{\boldsymbol{u}}_m$. Since the total momentum $m\vec{\boldsymbol{u}}_m$ is
+  conserved, the momentum of the basketball after the collision must be
+  approximately $2m\vec{\boldsymbol{u}}_m$. The absolute value of the momentum of the
+  basketball after the collision is larger than that of the ping-pong
+  ball.
+
+  The momentum of the basketball after the collision is approximately
+  $2m\vec{\boldsymbol{u}}_m$, so its velocity $\vec{\boldsymbol{v}}_M \approx \frac{2m}{M} \vec{\boldsymbol{u}}_m$. The
+  final kinetic energies of the basketball and ping-pong ball are:
+  %
+  \begin{align*}
+    K_M
+    &= \frac{1}{2}M |\vec{\boldsymbol{v}}_M|^2 \approx \frac{1}{2} M
+      \left |\frac{2m\vec{\boldsymbol{u}}_m}{M}\right |^2 = \frac{2m^2}{M}
+      |\vec{\boldsymbol{u}}_m|^2 ,\\
+    K_m
+    &\approx \frac{1}{2} m |-\vec{\boldsymbol{u}}_m|^2 .
+  \end{align*}
+  %
+  The ratio $K_m/K_M = M/(4m)$ is much bigger than 1 (the mass of one
+  basketball is much larger than the mass of four ping-pong balls), so
+  the ping-pong ball has much more kinetic energy than the basketball.
+
+  \item
+    \begin{enumerate}
+
+      \item The total momentum before the collision that forms the
+        complex is
+        \begin{displaymath}
+          p_{\text{tot}} = m_{\text{NO}} u_{\text{NO}} + m_{\text{O}_3}
+          u_{\text{O}_3} = (14 + 16)m_u u_{\text{NO}} + (3\times 16)m_u u_{\text{O}_3},
+        \end{displaymath}
+        where $m_u \approx 1.66 \times 10^{-27}\,$kg is the atomic mass
+        unit. Setting the value of $u_{\text{NO}}$ to $-550\,$m$\cdot$
+        s$^{-1}$ and $u_{\text{O}_3} = +550\,$m$\cdot$s$^{-1}$ gives
+        %
+        \begin{displaymath}
+          p_{\text{tot}} \approx 1.64 \times 10^{-23}\,\text{kg}\cdot\text{m}\cdot\text{s}^{-1}.
+        \end{displaymath}
+
+        The total momentum is conserved during the collision in which
+        the two molecules bind to form the [NO--O$_3$]$^{\ast}$ complex,
+        so
+        %
+        \begin{displaymath}
+          p_{\text{[NO--O$_3$]}^{\ast}} \approx 1.64 \times
+          10^{-23}\,\text{kg}\cdot\text{m}\cdot\text{s}^{-1}
+        \end{displaymath}
+        %
+        and the velocity of the complex is
+        %
+        \begin{displaymath}
+          v_{\text{[NO--O$_3$]}^{\ast}} \approx \frac{1.64 \times
+            10^{-23}}{[(14 + 16) + (3 \times 16)] m_u} \approx
+          127\,\text{m}\cdot\text{s}^{-1}.
+        \end{displaymath}
+
+      \item The total kinetic energy before the collision is
+        %
+        \[
+          K = \frac{1}{2} m^{}_{\text{NO}}v_{\text{NO}}^2 + \frac{1}{2}
+              m^{}_{\text{O}_3} v_{\text{O}_3}^2 
+            = \frac{1}{2} [ (14 + 16) + (3 \times 16) ] m_u (550)^2 
+            \approx 1.96\times 10^{-20}\,\text{J}.
+          \]
+
+        The total kinetic energy after the collision is
+        %
+        \[
+          K' = \frac{1}{2} m^{}_{\text{[NO--O$_3$]}^{\ast}} \,
+               v_{\text{[NO--O$_{3}$]}^{\ast}}^2 \\
+             = \frac{1}{2} (78 m_u) (127)^2 \\
+             \approx 1.04 \times 10^{-21}\,\text{J}.
+        \]
+
+        The total KE has reduced so the collision was inelastic.
+
+        The KE lost has gone into the internal energy of the activated
+        complex, which has higher chemical energy than the two molecules
+        of which it is formed (it is only metastable) plus internal
+        vibrational and rotational energy.
+
+      \item The collision will only form the products if the internal energy
+        of the complex exceeds the activation barrier. The internal
+        energy is
+        %
+        \begin{displaymath}
+          E^{\text{internal}}_{[\text{NO--O}_3]^{\ast}} = K - K' \approx
+          1.96 \times 10^{-20} - 1.04 \times 10^{-21}
+          \approx 1.85 \times 10^{-20}\,\text{J}.
+        \end{displaymath}
+        %
+        An activation barrier of of $9.6\,\text{kJ}\cdot\text{mol}^{-1}$
+        translates into
+        %
+        \begin{displaymath}
+          \frac{9.6 \times 10^3}{6.022 \times 10^{23}} \approx 1.59 \times
+          10^{-20} \, \text{J per complex}.
+        \end{displaymath}
+        %
+        This is less than the internal energy provided by the collision,
+        so the NO$_2$ and O$_2$ products will be formed (some of the
+        time, at least).
+
+      \item Set the potential energy of interaction to zero when the two
+        oxygen atoms are far apart. Since the atoms are approaching each
+        other, they already have some kinetic energy even before the
+        attractive part of the interaction starts accelerating them
+        towards each other. This means that their total energy $E$ is
+        greater than zero. If we choose to work in the centre-of-mass
+        frame, the total momentum is zero and the two oxygen atoms
+        approach each other with equal and opposite momentum.
+
+        Momentum and total energy are conserved, so the O$_2$ molecule
+        must have zero total momentum but positive total energy $E$. If
+        the molecule is to form, the kinetic energy of the molecules
+        arriving at their equilibrium spacing (the difference between
+        $E$ and the minimum value of $U(r)$) must be transferred into
+        internal vibrational, rotational and electronic degrees freedom
+        of the O$_2$ molecule.
+
+        Since the total energy of the molecule is greater than zero, it
+        is large enough to provide the two O atoms with enough kinetic
+        energy to unbind and escape to infinity. Unless some other
+        nearby atom or molecule takes away the excess energy before it
+        is too late, the highly-excited oxygen molecule will soon break
+        up.
+
+        \begin{center}
+          \includegraphics[width=0.55\textwidth]{figures/O2_potential.png}
+        \end{center}
+
+        The figure above illustrates the situation. It shows the
+        potential energy $U(r)$ of the two O atoms as a function of
+        their separation $r$ (compare with Q5 of the Mechanics part of
+        the week 6 problem sheet). The total energy $E$, indicated by
+        the dashed red line, is greater than zero. The total kinetic
+        energy at separation $r$, indicated by the green arrow, is $E -
+        U(r)$. Because $E > 0$, the two escaping atoms will keep moving
+        away from each other even as $r \rightarrow \infty$.
+        
+  \end{enumerate}
+  
+    \begin{enumerate}
+    
+    \item Using conservation of energy, the speed $v_0$ of the ball when
+      it first hits the ground is related to the initial height $h_0$ by
+      $mgh_0 = \frac{1}{2}mv_0^2$. This gives
+      %
+      \begin{displaymath}
+        v_0 = \sqrt{2gh_0}.
+      \end{displaymath}
+      %
+      (Could also have used the SUVAT equation $v^2 = u^2 + 2as$.) Since
+      $v_0 = g t_0$,
+      %
+      \begin{displaymath}
+        t_0 = \sqrt{\frac{2h_0}{g}}.
+      \end{displaymath}
+
+    \item The upward speed after the first bounce is $v_1 = ev_0$. The
+      height reached after the first bounce is
+      %
+      \begin{displaymath}
+        h_1 = \frac{v_1^2}{2g} = \frac{e^2 v_0^2}{2g}
+        = e^2 h_0.
+      \end{displaymath}
+      %
+      The time taken to reach the top of the first bounce is
+      %
+      \begin{displaymath}
+        t_1 = \sqrt{\frac{2h_1}{g}} = et_0.
+      \end{displaymath}
+      %
+      The height $h_n$ and drop time $t_n$ for the $n^{\text{th}}$ bounce
+      are
+      %
+      \begin{displaymath}
+        h_n = e^{2n} h_0, \qquad t_n = e^n t_0.
+      \end{displaymath}
+    
+    \item The initial drop takes time $t_0$. The duration of the
+      $n^{\text{th}}$ bounce is $2t_n$, not $t_n$, because the ball has to
+      rise and then drop again. The total time $T$ for the ball to stop
+      bouncing is the sum of the durations of the initial drop and all
+      subsequent bounces:
+      %
+      \begin{align*}
+        T &= t_0 + 2 e t_0 + 2 e^2 t_0 + 2 e^3 t_0 + \ldots \\
+          &= 2 t_0 (1 + e + e^2 + e^3 + \ldots) - t_0 \\
+          &= \frac{2 t_0}{1 - e} - t_0
+        \qquad \text{(using the formula given in the question)}\\
+          &= \frac{1 + e}{1 - e} \, t_0.
+      \end{align*}
+
+      If $h_0 = 5\,$m, $e = 0.5$, and $g = 10\,\text{m}\cdot\text{s}^{-2}$,
+      then
+      %
+      \begin{displaymath}
+        t_0 = \sqrt{\frac{2 \times 5}{10}} = 1\,\text{s},
+      \end{displaymath}
+      %
+      and the time $T$ taken to stop bouncing is
+      %
+      \begin{displaymath}
+        T = \frac{1 + 0.5}{1 - 0.5} \, t_0 = 3\,\text{s}.
+      \end{displaymath}
+
+    \end{enumerate}
+
+\item The diagram below shows that the change in momentum of the
+  rocket+fuel in time $dt$ can be found as follows:
+  %
+  \begin{align*}
+    \text{change in momentum}
+    &= \text{(momentum at time $t + dt$)} - \text{(momentum at time $t$)} \\
+    &=\big( (M + dM)(v + dv) + (-dM)(v-u) \big) - \big( Mv \big)\\
+    &= M dv + u dM . \qquad \text{(ignoring second-order terms)}
+  \end{align*}
+
+  \begin{center}
+    \includegraphics[width=0.45\textwidth]{figures/rocket-momentum.png}
+  \end{center}
+  
+  Since the only external force acting on the system is gravity, this
+  must be equal to the gravitational impulse $-Mg\,dt$ (which is negative
+  because gravity acts against the rocket's acceleration):
+  %
+  \begin{align*}
+    &M dv + u dM = -Mg \, dt \\
+    \Rightarrow \qquad
+    &dv = -u\frac{dM}{M} - g \, dt \\
+    \Rightarrow \qquad
+    &\int_{0}^{v(t)} dv' = -u \int_{M_0}^{M(t)} \frac{dM'}{M'} -
+      g\int_0^{t} dt' \\
+    \Rightarrow \qquad
+    &\left [ v' \right ]_0^{v(t)} = -u \left [ \ln M' \right
+      ]_{M_0}^{M(t)} - g \left [ t' \right ]_0^{t} \\
+    \Rightarrow \qquad
+    &v(t) = -u \left \{ \ln(M(t)) - \ln(M_0) \right \} - gt \\
+    \Rightarrow \qquad
+    &v(t) = u\ln\left ( \frac{M_0}{M(t)} \right ) - gt,
+  \end{align*}
+  as required.
+
+\item The free-space rocket equation is
+  %
+  \begin{displaymath}
+    v(t) = v_0 + u \ln \left ( \frac{M_0}{M(t)} \right ),
+  \end{displaymath}
+  %
+  where $v_0$ is the initial speed of the rocket, $u$ is the exhaust
+  speed, $M_0$ is the rocket's initial mass (including any fuel it is
+  carrying), and $M(t)$ is its mass at time $t$ (including any fuel not
+  yet burnt).
+
+  For the first stage of the journey, call the initial mass
+  $M_1^{\text{init}}$. The initial speed is zero. The initial mass of
+  fuel is $3M_1^{\text{init}}/4$, but only $2/3$ of this is burnt during
+  stage 1. The mass $M_1^{\text{final}}$ of the rocket and remaining
+  fuel at the end of stage 1 is therefore
+  $M_1^{\text{init}} - (2/3)(3M_1^{\text{init}}/4) =
+  M_1^{\text{init}}/2$. We can now work out the speed $v_1$ at the end
+  of stage 1:
+  %
+  \begin{displaymath}
+    v_1 = u \ln \left ( \frac{M_1^{\text{init}}}{M_1^{\text{final}}} \right )
+    = u\ln \left ( \frac{M_1^{\text{init}}}{M_1^{\text{init}}/2} \right ) = u\ln 2.
+  \end{displaymath}
+
+  Once the first stage of the rocket has detached, the remaining mass of
+  fuel, which we know is equal to
+  $(1/3)(3M_1^{\text{init}}/4) = M_1^{\text{init}}/4$, accounts for
+  $4/5$ of the mass of the rocket. This tells us the initial mass
+  of stage 2:
+  %
+  \begin{displaymath}
+    M_2^{\text{init}} = (5/4)(M_1^{\text{init}}/4) =
+    5M_1^{\text{init}}/16.
+  \end{displaymath}
+  %
+  At the end of stage 2, the fuel has all been burnt, so
+  $M_2^{\text{final}} = M_2^{\text{init}} - M_1^{\text{init}}/4 =
+  M_1^{\text{init}}/16$. The velocity $v_2$ at the end of stage 2 is
+  %
+  \begin{align*}
+    v_2 &= v_1 + u \ln \left (
+      \frac{M_2^{\text{init}}}{M_2^{\text{final}}} \right ) 
+    = u\ln 2 + u\ln \left
+      ( \frac{5M_1^{\text{init}}/16}{M_1^{\text{init}}/16} \right ) \\
+    &= u\ln 2 + u\ln 5 = u\ln 10.
+  \end{align*}
+
+  Suppose we had instead made the journey with a single-stage rocket of
+  initial mass $M_1^{\text{init}}$ and the same initial mass of fuel,
+  $3M_{1}^{\text{init}}/4$. At the end of the single stage, all of the
+  fuel has been burnt, so the final mass is
+  $M_1^{\text{init}} - 3M_{1}^{\text{init}}/4 = M_1^{\text{init}}/4$.
+  The final speed $v_1'$ is given by
+  %
+  \begin{align*}
+    v_1' = u\ln\left ( \frac{M_1^{\text{init}}}{M_1^{\text{init}}/4}
+    \right ) = u\ln 4,
+  \end{align*}
+  %
+  which is approximately $0.6u\ln(10)$.
+
+    \end{enumerate}
+    
+
+\end{document}

in2lambda/filters/PartsSepSol/filter.py

@@ -72,7 +72,9 @@ def pandoc_filter(
             # Add each part solution/text
             # For the solution, prepend any top level answer text to each part answer
             for part in lettered_parts:
-                module.current_question.add_solution(
-                    spaced_blurb + part
-                ) if parsing_answers else module.current_question.add_part_text(part)
+                (
+                    module.current_question.add_solution(spaced_blurb + part)
+                    if parsing_answers
+                    else module.current_question.add_part_text(part)
+                )
     return None

in2lambda/filters/markdown.py

@@ -120,7 +120,10 @@ def filter(
         [pf.Element, pf.elements.Doc, Module, bool],
         Optional[pf.Str],
     ]
-) -> Callable[[pf.Element, pf.elements.Doc, Module, str, bool], Optional[pf.Str],]:
+) -> Callable[
+    [pf.Element, pf.elements.Doc, Module, str, bool],
+    Optional[pf.Str],
+]:
     """Python decorator to make generic LaTeX elements markdown readable.
 
     As an example, part of the process involves putting dollar signs around maths

in2lambda/json_convert/json_convert.py

@@ -18,7 +18,7 @@ def converter(
     """Turns a list of question objects into Lambda Feedback JSON.
 
     Args:
-        template: The loaded JSON from the minimal template.
+        template: The loaded JSON from the minimal template (it needs to be in sync).
         ListQuestions: A list of question objects.
         output_dir: The absolute path for where to produced the final JSON/zip files.
     """
@@ -50,7 +50,7 @@ def converter(
                 )
 
         # Output file
-        filename = "Question " + str(i + 1)
+        filename = "question_" + str(i + 1)
 
         # create directory to put the questions
         os.makedirs(output_dir, exist_ok=True)

in2lambda/json_convert/minimal_template.json

@@ -1,5 +1,4 @@
 {
-  "isPublished": false,
   "masterContent": "Top level question here",
   "parts": [
     {
@@ -17,6 +16,7 @@
       ]
     }
   ],
+  "publish": false,
   "questionSettings": {
     "displayFinalAnswer": true,
     "displayStructuredTutorial": true,

in2lambda/main.py

@@ -9,7 +9,6 @@ import rich_click as click
 
 import in2lambda.filters
 from in2lambda.api.module import Module
-from in2lambda.json_convert import json_convert
 
 
 def file_type(file: str) -> str:
@@ -40,7 +39,17 @@ def file_type(file: str) -> str:
     match (extension := file.split(".")[-1].lower()):
         case "tex" | "latex" | "ltx":
             return "latex"
-        case "md" | "rmd" | "markdown" | "mdown" | "mdwn" | "mkd" | "mkdn" | "text" | "txt":
+        case (
+            "md"
+            | "rmd"
+            | "markdown"
+            | "mdown"
+            | "mdwn"
+            | "mkd"
+            | "mkdn"
+            | "text"
+            | "txt"
+        ):
             return "markdown"
         case "docx":
             return "docx"  # Pandoc doesn't seem to support doc
@@ -71,9 +80,9 @@ def runner(
         >>> from in2lambda.main import runner
         >>> # Retrieve an example TeX file and run the given filter.
         >>> runner(f"{os.path.dirname(in2lambda.__file__)}/filters/PartsSepSol/example.tex", "PartsSepSol") # doctest: +ELLIPSIS
-        Module(questions=[Question(title='', parts=[Part(text=..., worked_solution=''), ...], images=[], _main_text='This is a sample question\n\n'), ...])
+        Module(questions=[Question(title='', parts=[Part(text=..., worked_solution=''), ...], images=[], main_text='This is a sample question\n\n'), ...])
         >>> runner(f"{os.path.dirname(in2lambda.__file__)}/filters/PartsOneSol/example.tex", "PartsOneSol") # doctest: +ELLIPSIS
-        Module(questions=[Question(title='', parts=[Part(text='This is part (a)\n\n', worked_solution=''), ...], images=[], _main_text='Here is some preliminary question information that might be useful.'), ...)
+        Module(questions=[Question(title='', parts=[Part(text='This is part (a)\n\n', worked_solution=''), ...], images=[], main_text='Here is some preliminary question information that might be useful.'), ...)
     """
     # The list of questions for Lambda Feedback as a Python API.
     module = Module()
@@ -112,7 +121,7 @@ def runner(
 
     # Read the Python API format and convert to JSON.
     if output_dir is not None:
-        json_convert.main(module.questions, output_dir)
+        module.to_json(output_dir)
 
     return module
 

{in2lambda-0.3.0.dist-info → in2lambda-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: in2lambda
-Version: 0.3.0
+Version: 0.3.2
 Summary: Converts content ready for import into Lambda Feedback
 Home-page: https://lambda-feedback.github.io/in2lambda
 License: MIT
@@ -12,11 +12,12 @@ Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Typing :: Typed
-Requires-Dist: beartype (>=0.16.4,<0.17.0)
-Requires-Dist: panflute (>=2.3.0,<3.0.0)
-Requires-Dist: rich-click (>=1.7.2,<2.0.0)
+Requires-Dist: beartype (>=0.17.2,<0.18.0)
+Requires-Dist: panflute (>=2.3.1,<3.0.0)
+Requires-Dist: rich-click (>=1.7.4,<2.0.0)
 Project-URL: Bug Tracker, https://github.com/lambda-feedback/in2lambda/issues
 Project-URL: Documentation, https://lambda-feedback.github.io/in2lambda
 Project-URL: Repository, https://github.com/lambda-feedback/in2lambda

{in2lambda-0.3.0.dist-info → in2lambda-0.3.2.dist-info}/RECORD

@@ -1,8 +1,10 @@
 in2lambda/__init__.py,sha256=VvbVGkrakfqTIqnYUuv95_LFxitkMODRYr161R9128U,492
 in2lambda/api/__init__.py,sha256=uh1WA1JIIYmjaWXms3JR5LOlnizv-ozW4ijBHQxi9QA,103
-in2lambda/api/module.py,sha256=pxAYA355aY5B07JTCDetdP9U0GiXCMh-aWRc9QAiPAE,3729
+in2lambda/api/module.py,sha256=YDV2NWejxg3duEzVjn6er05OiCGBihI7fUDJP16RuD0,5046
 in2lambda/api/part.py,sha256=Y-W0sd5mJQifA8V8nZNTYk_HPhxhRQq5mUCdlYKioXw,204
-in2lambda/api/question.py,sha256=EJpg8dZEj3byTTQNXu0QIHH1IqRh75ZjWs39E1ninfU,5408
+in2lambda/api/question.py,sha256=is-Bmx85GFAV7Jf8mblP2ZtkDgfbRcVbMhh9Tmy2hmk,6173
+in2lambda/example_questions.tex,sha256=kvcuUUoQXTJYqrAlUMfibzGsL9qFgqbKS57JIg1YhkA,9491
+in2lambda/example_solutions.tex,sha256=0idJQV9Q8VhMO_dB5RYzYkZzyEMSA594sqnPdl4wlLA,22164
 in2lambda/filters/PartPartSolSol/__init__.py,sha256=YJCnCoGJfXt7jrMdgcsEfkI7Su9WK-VOvUwwefQ8zog,124
 in2lambda/filters/PartPartSolSol/example.tex,sha256=TK4JyjYj_wFfi9bkV8uKfXdFIBYPsvgMng5x1XdE_oU,667
 in2lambda/filters/PartPartSolSol/filter.py,sha256=vttP0_RNjLuLu2GSUudzv2qk-AQHuRb172JAwf_0mmA,2383
@@ -14,20 +16,20 @@ in2lambda/filters/PartsOneSol/example.tex,sha256=d45J2goEL_X-otuwtwJwXId1KHTW2sG
 in2lambda/filters/PartsOneSol/filter.py,sha256=DLj7DcDt1Aru2B4Tb5rljOFKZ4sXB8UUc4Yd3knnJow,2017
 in2lambda/filters/PartsSepSol/__init__.py,sha256=yAIUC3oJVob1R7Rrvn0sXGpK_-pXfF46DeJ9vaXSNfQ,121
 in2lambda/filters/PartsSepSol/example.tex,sha256=w7mJIcWCqKzJE_sJG4bg0J-V9kXSfe6doKWXgTd1nF8,687
-in2lambda/filters/PartsSepSol/filter.py,sha256=Tp2lPL2WdViSMbkIgM-VxFQce-Iuy9mQ7sXpfRu-A98,3164
+in2lambda/filters/PartsSepSol/filter.py,sha256=9cV6HhSqOQGTk5bIS36pgBbB-5UWO3mPI2s8l9ZsNeE,3206
 in2lambda/filters/__init__.py,sha256=tla_1d85db2MAT-fgc5sNoScuYZJeTgKedzFn3NXT2c,69
-in2lambda/filters/markdown.py,sha256=QyZvOCQQxNOXU9_Ip8eHwEz_ljedJuLL8YLDM2OsRTA,7143
+in2lambda/filters/markdown.py,sha256=FhbGHziVCHirhssCpMnSkyC0alMsOIxnInxvLMdaNek,7153
 in2lambda/json_convert/__init__.py,sha256=2X3SLn6H449zXFprtZZU7M20elsOJ09mQr7EDnv04ow,87
-in2lambda/json_convert/json_convert.py,sha256=YzbQRbV4SiODxJJe_A9eczEbp7qtBkgHyppAQlxvxns,3600
-in2lambda/json_convert/minimal_template.json,sha256=zWsxA_9OxCtL4q6S6vj2ezqUtSYiXTSTfVc4E4xFOJ4,555
+in2lambda/json_convert/json_convert.py,sha256=VPigakcUYvZCm2PPRm0umrA0BIvEOFNfwl-NLfcr4lM,3625
+in2lambda/json_convert/minimal_template.json,sha256=ctwpbvOqIs_okToSCRkRB3z5CRn1GNbrUegu6PuLngM,551
 in2lambda/katex_convert/__init__.py,sha256=D0X21-NQXNrWwu_klZeCaQaqtV9vHfFv1PlrtuVAHlI,96
 in2lambda/katex_convert/delete_list.txt,sha256=Ywx8ltUbrvSxGaQVoTSXfXAe4FfPSCuRchkSCICYjHU,1753
 in2lambda/katex_convert/katex_convert.py,sha256=3UUw84432lOBnPLJwAw68MMyFPrD6ijxyYR-qVhJhnw,4909
 in2lambda/katex_convert/replace_list.txt,sha256=y5ciG4orj64eqEKsOVaQ95Zx7Xx0y4Awa4JIS27HVSw,611
-in2lambda/main.py,sha256=QFbLVJ-OYf8J1rkiKpMdV71NqGbnPs9E4Q5b0mXA718,5957
+in2lambda/main.py,sha256=RSoHtn9e1y34xHxScwjMUshrP5RAuGJayqX_WXveajA,6006
 in2lambda/py.typed,sha256=gN7aphE6U0Jj-OffDD7hw1OkRs9gg6OPOrVpN5eAnCA,56
-in2lambda-0.3.0.dist-info/LICENSE,sha256=vEyoprnh_ic_ZQ-woDohxEIE8GJOyXqbYZ-5cH42FG4,1072
-in2lambda-0.3.0.dist-info/METADATA,sha256=5z7aZ22VlXQF0jpnhXg-DA2ekkVdKwUJmRdxDRyocpk,1782
-in2lambda-0.3.0.dist-info/WHEEL,sha256=d2fvjOD7sXsVzChCqf0Ty0JbHKBaLYwDbGQDwQTnJ50,88
-in2lambda-0.3.0.dist-info/entry_points.txt,sha256=xhkZ_lmsx7SgdhjJC-DvkFFqu-Ff-wD4Poir55bdUSM,48
-in2lambda-0.3.0.dist-info/RECORD,,
+in2lambda-0.3.2.dist-info/LICENSE,sha256=vEyoprnh_ic_ZQ-woDohxEIE8GJOyXqbYZ-5cH42FG4,1072
+in2lambda-0.3.2.dist-info/METADATA,sha256=7DjyXejaoAtbgGr2kItJ-1I_5xHiNv_y8BKrOcODtCE,1833
+in2lambda-0.3.2.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+in2lambda-0.3.2.dist-info/entry_points.txt,sha256=xhkZ_lmsx7SgdhjJC-DvkFFqu-Ff-wD4Poir55bdUSM,48
+in2lambda-0.3.2.dist-info/RECORD,,

{in2lambda-0.3.0.dist-info → in2lambda-0.3.2.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 1.7.0
+Generator: poetry-core 1.8.1
 Root-Is-Purelib: true
 Tag: py3-none-any