Skip to content

Commit fd00712

Browse files
committed
Fix latex, RST warnings
1 parent 318a973 commit fd00712

5 files changed

Lines changed: 52 additions & 127 deletions

File tree

build.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -171,7 +171,7 @@ def summarize_latex_logfile(logs):
171171
if args.parallel or args.emit_gh_annotations:
172172
html_args.insert(3, '--no-color')
173173
latex_env = os.environ.copy()
174-
latex_env["LATEXMKOPTS"] = "-interaction=batchmode"
174+
latex_env["LATEXMKOPTS"] = "-interaction=nonstopmode"
175175

176176
gh_annotations = []
177177

docs/conf.py

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -190,6 +190,8 @@
190190

191191
def setup(app):
192192
from sphinx.util.texescape import tex_replacements
193+
tex_replacements.append(('≤', r'\(\leq\)'))
194+
tex_replacements.append(('≥', r'\(\geq\)'))
193195
tex_replacements.append(('μ', r'\(\mu\)'))
194196
tex_replacements.append(('°', r'\(^\circ\)'))
195197
tex_replacements.append(('℃', r'\(^\circ\)C'))

docs/instruments/core_facilities/Koch_flow.rst

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -72,12 +72,12 @@ Training Details
7272
* If you need to do a longer sort for an experiment, you could sign up for the 1-hour assisted use, then separately sign up for more time immediately after to finish your sort.
7373

7474
Sony MA-900
75-
-----------
75+
===========
7676

7777
The Sony MA900 cell sorter has a `SOP <https://docs.google.com/document/d/1toqMY_qnDy0_YDkcEr2ktDJWcteKe0Pj42_scukqT5s/edit>`__ that you can follow for startup and shutdown.
7878

7979
Startup
80-
^^^^^^^
80+
~~~~~~~
8181

8282
You only need to start up the Sony if you want to use it over the weekend, on holidays, or outside of normal hours.
8383
During the week, core staff will do the start up in the morning.
@@ -121,7 +121,7 @@ The Sony is generally very easy to startup once you've seen how to; you mostly f
121121
* You don’t need to include startup time when signing up to sort on weekends/holidays (e.g. don’t pay for startup time).
122122

123123
Sample Prep and Sorting
124-
^^^^^^^^^^^^^^^^^^^^^^^
124+
~~~~~~~~~~~~~~~~~~~~~~~
125125

126126
1. Get ice. Keep your samples on ice as much as possible after dissociation.
127127
2. Dissociate cells using appropriate method. Centrifuge the cells to pellet them.
@@ -236,7 +236,7 @@ Sample Prep and Sorting
236236
6. Add on extra time for setting up the workspace, setting voltages and gates, swapping samples, the final Bleach Cleaning and DI Rinse steps, and exporting your data.
237237

238238
Shutdown
239-
^^^^^^^^
239+
~~~~~~~~
240240

241241
Follow the shutdown SOP, with the exception that on step 7 ("Turn off the air compressor and blue switch on the air-line"),
242242
do **not** turn off the blue switch on the air-line,

docs/protocols/tc/virus/viral_titer.rst

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ Note that individual cells with detectable expression may be contain one or more
9898

9999
First, let's define the **multiplicity of infection (MOI)**, :math:`\lambda`, as the ratio of viral transducing units (TU) to number of cells, *n*:
100100

101-
.. math:: \lambda = \frac{\text{# TU}}{n}
101+
.. math:: \lambda = \frac{\text{number of TU}}{n}
102102

103103
We can obtain a particular MOI in an experiment by using a calculated **volume of virus**, *v*, if we know the **viral titer**, *t*:
104104

@@ -122,12 +122,10 @@ However, it is difficult to quantify the exact number of transductions in indivi
122122
cells with at least one transduction:
123123

124124
.. math::
125-
\begin{align}
126125
P(x>0) &= 1 - P(x=0) \\
127126
&= 1 - \frac{\lambda^0 e^{-\lambda}}{0!} \\
128127
&= 1 - e^{-\lambda} \\
129128
&= 1 - e^{v / n \ \times \ t}
130-
\end{align}
131129
132130
Thus, the flow cytometry data from the experiment above can give us a fraction of expressing cells, which we can use with known values of *v* and *n* (experimental parameters)
133131
to find *t*, the viral titer. To make this calculation more accurate, we can measure the fraction of expressing cells for several different volumes of virus---exactly the

docs/training/onboarding/day_0_setup.rst

Lines changed: 44 additions & 119 deletions
Original file line numberDiff line numberDiff line change
@@ -50,10 +50,12 @@ EHS system and add all necessary trainings to your profile.
5050
.. note::
5151
To complete the Signature: Read Dept. Chemical Hygiene Plan training, please read the Chemical Hygiene Plan and then sign the attestation form.
5252
The attestation form is available at:
53-
https://web-cert.mit.edu/cheme/resources/lab/ehs/ehs_cert.html
54-
You will need an MIT web certificate to access and complete the form.
55-
If you do not yet have a web certificate, you can obtain one here:
56-
https://ist.mit.edu/mit-apps/certaid
53+
https://web-cert.mit.edu/cheme/resources/lab/ehs/ehs_cert.html
54+
55+
MIT certificates were phased out in summer 2026. There will be some new method to do this.
56+
57+
In the past, you had to get a web certificate from:
58+
https://ist.mit.edu/mit-apps/certaid
5759

5860
1. If you are going to be helping with mouse work, still under the
5961
'My Profile' tab, you should click **Join Another Group** under training
@@ -295,140 +297,63 @@ Coding and collaboration
295297
and select the 64-bit installer for your OS.
296298

297299
When installing, select **Add Python to PATH**; this ensures that when you type ``python`` at a terminal, you get this version you
298-
just installed. Other software can also access this "default" installation.
300+
just installed. Other software can also access this "default" installation. After installing, restart VS Code.
301+
302+
.. admonition:: What is PATH?
303+
304+
``PATH`` is a "environment variable", e.g. something that any program running
305+
in the "environment" of your computer can access. It is a list of folders where software can be found.
306+
In a command line, when you type a program name (like ``ls``, or ``python``, or ``git``)
307+
without specifying where the program is, your computer iterates through every folder in ``PATH`` to see
308+
if it can find the program there.
309+
310+
Bonus fact: virtual environments work by temporarily messing with ``PATH``, redirecting e.g. Python to
311+
the virtual environment install.
299312

300313
.. admonition:: Fixing Python “command not found” (Windows & macOS)
301314
:class: warning
302-
303-
This protocol addresses a common issue where Python is installed correctly,
304-
but typing ``python`` or ``pip`` in a terminal results in an error such as:
315+
316+
If you see errors like
305317

306318
- ``'python' is not recognized as an internal or external command``
307319
- ``command not found: python``
308320

309-
The most common cause is that Python exists on disk, but its directory
310-
is missing from the PATH environment variable.
311-
312-
Windows (Command Prompt / PowerShell)
313-
------------------------------------------------------------
314-
315-
Confirm that Python is installed
316-
--------------------------------
317-
318-
1. Open **PowerShell**
319-
2. Navigate to the Python installation directory, for example::
320-
321-
C:\Users\<USERNAME>\AppData\Local\Python\pythoncore-3.14-64\
322-
323-
3. In PowerShell, run Python directly using the call operator ``&``::
324-
325-
& "C:\Users\<USERNAME>\AppData\Local\Python\pythoncore-3.14-64\python.exe" --version
326-
327-
If a Python version is printed, Python is installed correctly and the issue
328-
is related to PATH configuration.
329-
330-
------------------------------------------------------------
331-
Fix PATH using the Environment Variables GUI (recommended)
332-
------------------------------------------------------------
333-
334-
**Do not use ``setx PATH``**, as it can truncate PATH and break other software.
335-
336-
1. Press the **Windows key**
337-
2. Search for **Edit environment variables**
338-
3. Open **Edit the system environment variables**
339-
4. Click **Environment Variables…**
340-
341-
You will see two sections:
342-
- **User variables for <USERNAME>** (top box)
343-
- **System variables** (bottom box)
344-
345-
5. In the **User variables** section, select **Path**
346-
6. Click **Edit…**
347-
348-
You will now see a list of directories that make up your PATH.
349-
350-
7. Click **New**
351-
8. Add::
352-
353-
C:\Users\<USERNAME>\AppData\Local\Python\pythoncore-3.14-64\
354-
355-
9. Click **New** again
356-
10. Add::
357-
358-
C:\Users\<USERNAME>\AppData\Local\Python\pythoncore-3.14-64\Scripts\
359-
360-
11. Click **OK** to close the Path editor
361-
12. Click **OK** to close the Environment Variables window
362-
363-
**Important:** Close all open PowerShell and Command Prompt windows,
364-
then open a new terminal.
365-
366-
Verify the fix::
367-
368-
python --version
369-
pip --version
370-
where.exe python
371-
where.exe pip
372-
373-
If ``where.exe python`` points to the ``pythoncore`` directory, PATH is fixed.
374-
375-
Common Windows pitfalls
376-
------------------------------------------------------------
377-
378-
PowerShell vs Command Prompt
379-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
380-
- PowerShell requires ``&`` to execute a quoted executable path
381-
- Command Prompt does not
382-
383-
App execution aliases
384-
~~~~~~~~~~~~~~~~~~~~~
385-
Windows may redirect ``python`` to the Microsoft Store.
386-
387-
To disable this:
388-
1. Open the Start menu
389-
2. Search for **App execution aliases**
390-
3. Turn **OFF** ``python.exe`` and ``python3.exe``
391-
392-
macOS (differences from Windows)
393-
------------------------------------------------------------
394-
395-
On macOS, PATH issues are handled through shell configuration files,
396-
not a graphical environment variables editor.
397-
398-
Check Python::
321+
then you likely forgot do the above step (clicking Add Python to PATH),
322+
or you didn't restart VS Code.
399323

400-
which python3
401-
python3 --version
324+
The easiest remediation is simply uninstall Python and reinstall it, while
325+
clicking the box.
402326

403-
Fix PATH (zsh default):
327+
If you don't want to do that for some reason, you can manually add Python to PATH.
404328

405-
1. Edit your shell configuration file::
329+
**Windows**
406330

407-
nano ~/.zshrc
331+
You need to find where Python is installed. This will vary! The easiest way to do this
332+
is just search for ``python.exe`` to locate where that folder is. Say that the location is
408333

409-
2. Add (example for Homebrew)::
334+
``C:\Users\<USERNAME>\AppData\Local\Python\python-3.14\python.exe``
410335

411-
export PATH="/opt/homebrew/bin:$PATH"
336+
Then:
412337

413-
3. Reload::
338+
1. Press the Windows key on your keyboard to bring up the search.
339+
2. Search for *Edit environment variables*
340+
3. In the box that shows up, hit *Edit the system environment variables*.
341+
4. Click *Environment Variables*.
342+
5. In the **User variables for <USERNAME>** box, find the **Path** variable and hit Edit.
343+
6. In the list of directories that shows up, hit **New** and add the folder containing Python
344+
identified earlier.
345+
7. Hit OK in the boxes and **restart any open terminals and VSCode to pick up the change**. The most
346+
reliable method here is logging out and logging back in.
414347

415-
source ~/.zshrc
348+
**macOS / Linux**
416349

417-
Verify::
350+
On macOS and Linux, you handle path by editing your shell configuration file, normally either
351+
at ``~/.zshrc`` for zsh or ``~/.bashrc`` for Bash.
418352

419-
python3 --version
420-
pip3 --version
353+
In these lines, you should add an export call to add the Python location to the end of path, like:
421354

422-
Key takeaways
423-
------------------------------------------------------------
424355

425-
- Python is often installed correctly, but missing from PATH
426-
- On Windows:
427-
- Edit the existing **Path** variable
428-
- Do not create new variables
429-
- Avoid ``setx PATH``
430-
- On macOS:
431-
- PATH is managed in ``~/.zshrc`` or ``~/.bashrc``
356+
``export PATH="$PATH:/path/to/python/that/you/found``
432357

433358
.. admonition:: On snakes and Anaconda
434359

0 commit comments

Comments
 (0)