LightWin 0.9.3__tar.gz → 0.9.4__tar.gz

{lightwin-0.9.3 → lightwin-0.9.4}/.gitignore

@@ -176,7 +176,6 @@ data/test_instructions/results_tests/*
 src/lightwin/data/ads/*
 
 docs/source/manual/notebooks/*.py
-images/
 source/build/
 source/untitled*.py
 *.c

{lightwin-0.9.3 → lightwin-0.9.4}/CHANGELOG.md

@@ -10,6 +10,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 Adhere to development best practices.
 In particular, follow advices listed in the great [Scientific Python library development guide](https://learn.scientific-python.org/development/).
 
+## [0.9.4] -- 2025-05-06
+
+### Added
+
+- Wrote the [documentation](https://lightwin.readthedocs.io/en/latest/manual/get_method.html) for the magic `get` methods.
+- Added `get` examples in the example notebook.
+
 ## [0.9.3] -- 2025-04-09
 
 ### Fixed
@@ -17,6 +24,10 @@ In particular, follow advices listed in the great [Scientific Python library dev
 - The `lightwin.config_manager` symlink pointing to `lightwin.config.config_manager` did not resolve on Windows.
   It was deleted and all `import lightwin.config_manager` were replaced by `import lightwin.config.config_manager`.
 
+### Changed
+
+- `import lightwin.config_manager` no longer works! Replace all occurrences by `import lightwin.config.config_manager`.
+
 ## [0.9.2] -- 2025-04-07
 
 ### Added

{lightwin-0.9.3/src/LightWin.egg-info → lightwin-0.9.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: LightWin
-Version: 0.9.3
+Version: 0.9.4
 Summary: Automatically compensate cavity failures in linacs
 Author-email: Adrien Plaçais <placais@lpsc.in2p3.fr>, Bruce Yee-Rendon <byee@post.j-parc.jp>, Didier Uriot <didier.uriot@cea.fr>, Frédéric Bouly <bouly@lpsc.in2p3.fr>, Jean-Michel Lagniel <jean-michel.lagniel@ganil.fr>
 Project-URL: changelog, https://github.com/AdrienPlacais/LightWin/blob/main/CHANGELOG.md

{lightwin-0.9.3 → lightwin-0.9.4}/docs/Makefile

@@ -6,7 +6,7 @@ SPHINXBUILD   ?= sphinx-build
 SPHINXAPIDOC  ?= sphinx-apidoc
 # Dirs
 SOURCEDIR     = .
-BUILDDIR      = ../../_tmp_LightWin-docs
+BUILDDIR      = _build/
 SRC_DIR       = ../src
 EXCLUDE_DIR   = ../src/lightwin/experimental/*
 APIDOC_DIR    = lightwin

{lightwin-0.9.3 → lightwin-0.9.4}/docs/lightwin/lightwin.rst

@@ -31,5 +31,4 @@ Submodules
 .. toctree::
    :maxdepth: 5
 
-   lightwin.config_manager
    lightwin.constants

lightwin-0.9.4/docs/manual/get_method.rst

@@ -0,0 +1,75 @@
+The `get` method
+================
+
+Most objects in LightWin implement a versatile `get` method.  
+This method provides a convenient way to access the data you're interested in without needing to write long or complex paths.
+
+If your development environment is properly configured for type completion, it should automatically suggest the list of valid keys you can use with this method.
+
+.. image:: images/get_example.png
+   :width: 400
+   :alt: Auto-completion example in an editor
+
+.. tip::
+   The first argument of the `get` method uses the standard Python `*args` syntax.  
+   This means you can request multiple keys at once:
+   
+   .. code-block:: python
+
+      energy, phase = simulation_output.get("w_kin", "phi_abs")
+
+   which is equivalent to:
+
+   .. code-block:: python
+
+      energy = simulation_output.get("w_kin")
+      phase = simulation_output.get("phi_abs")
+
+You can also refer to the documentation of each specific `get` method:
+
+* :meth:`.Accelerator.get`
+* :meth:`.BeamParameters.get`
+* :meth:`.Element.get`
+* :meth:`.FieldMap.get`
+* :meth:`.ListOfElements.get`
+* :meth:`.ParticleFullTrajectory.get`
+* :meth:`.RfField.get`
+* :meth:`.SimulationOutput.get`
+* :meth:`.TransferMatrix.get`
+
+Additional utility keyword arguments (`**kwargs`) are supported by some `get` methods.  
+Here are a few commonly used ones:
+
+.. list-table:: Common `**kwargs` for `get` methods
+   :widths: 25 25 50
+   :header-rows: 1
+
+   * - Keyword
+     - Purpose
+     - Notes
+   * - `elt`
+     - Access data for a specific :class:`.Element`
+     - See :meth:`.SimulationOutput.get`
+   * - `phase_space_name`
+     - Select data from a particular phase space
+     - See :meth:`.BeamParameters.get`
+   * - `pos`
+     - Retrieve data only at element entry or exit
+     - Requires `elt`; see :meth:`.SimulationOutput.get`
+   * - `to_deg`
+     - Convert phase values (keys containing `"phi"`) to degrees
+     - Defaults to `False`
+   * - `to_numpy`
+     - Convert the result to a NumPy array
+     - Defaults to `True`
+
+.. warning::
+   Use caution with the `to_deg` keyword.  
+   It may incorrectly convert keys such as `beta_phiw`, where `phiw` refers to a phase space name, not an angular quantity.  
+   To avoid this, use the `phase_space_name` keyword instead.
+
+If the requested key is not found, the method does **not** raise an error -- it simply returns an empty array.
+
+Some examples are provided at the end of the `example notebook`_.
+
+.. _example notebook: notebooks/example.ipynb#Accessing-data

{lightwin-0.9.3 → lightwin-0.9.4}/docs/manual/notebooks/example.ipynb

@@ -24,6 +24,15 @@
     "## Imports"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "d2692fb9-197f-42a8-976d-cdf76d03ead3",
+   "metadata": {},
+   "source": [
+    "Note that the first import is only used to import packaged data file.\n",
+    "See also: https://learn.scientific-python.org/development/patterns/data-files/"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": 1,
@@ -37,8 +46,6 @@
    },
    "outputs": [],
    "source": [
-    "# This is only to import packaged data file\n",
-    "# See also: https://learn.scientific-python.org/development/patterns/data-files/\n",
     "from importlib import resources\n",
     "from pprint import pprint\n",
     "\n",
@@ -52,7 +59,6 @@
    "id": "077309da-a621-4157-93ff-d58558517fce",
    "metadata": {
     "editable": true,
-    "jp-MarkdownHeadingCollapsed": true,
     "slideshow": {
      "slide_type": ""
     },
@@ -254,7 +260,7 @@
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "\u001b[0;37m[INFO    ] [log_manager.py      ]\u001b[0m Starting log for LightWin - Version: 0.9.3.dev5+g0425b693.d20250408, Commit: fb0b1237100e4632c8604ef7123ed5bc6736e353\n",
+      "\u001b[0;37m[INFO    ] [log_manager.py      ]\u001b[0m Starting log for LightWin - Version: 0.9.3.dev5+g0425b693.d20250408, Commit: 6d2c05c9a0caaf7b3d1dc886fbb7150b8f32bfec\n",
       "\u001b[0;37m[INFO    ] [files_specs.py      ]\u001b[0m Setting project_path = PosixPath('/home/placais/LightWin/src/lightwin/data/ads/lw_results')\n",
       "Setting log_file = 'lightwin.log'\n"
      ]
@@ -736,19 +742,12 @@
    ]
   },
   {
-   "cell_type": "raw",
-   "id": "ab218e39-8f25-4d99-9e6f-4ff90e9be819",
-   "metadata": {
-    "editable": true,
-    "raw_mimetype": "text/restructuredtext",
-    "slideshow": {
-     "slide_type": ""
-    },
-    "tags": []
-   },
+   "cell_type": "markdown",
+   "id": "a9c9fd74-f9ce-4acd-885a-067e1de93412",
+   "metadata": {},
    "source": [
     "The following function will break and fix the linac.\n",
-    "Check out the source code of :mod:`.workflow_setup` if you want to understand and personnalize this workflow."
+    "Check out the source code of [the workflow_setup module](../../lightwin/lightwin.ui.workflow_setup.rst) if you want to understand and personnalize this workflow."
    ]
   },
   {
@@ -783,7 +782,7 @@
       "\u001b[0;37m[INFO    ] [factory.py          ]\u001b[0m First initialisation of ListOfElements, ecompassing all linac. Created with dat_file = PosixPath('/home/placais/LightWin/src/lightwin/data/ads/ads.dat')\n",
       "\u001b[0;37m[INFO    ] [list_of_elements.py ]\u001b[0m Successfully created a ListOfElements with self.w_kin_in = 20.0 MeV and self.phi_abs_in = 0.0 rad.\n",
       "\u001b[1;33m[WARNING ] [factory.py          ]\u001b[0m You asked LW a simulation in absolute phase, while there is at least one cavity in relative phase in the .dat file used by TW. You can expect a phase difference between LightWin results and TraceWin results for the same input .dat, after the first failed cavity. No difference should appear with the output .dat, or when using TraceWin solver within LightWin.\n",
-      "\u001b[0;37m[INFO    ] [beam_calculator.py  ]\u001b[0m Elapsed time in beam calculation: 0:00:00.613207\n",
+      "\u001b[0;37m[INFO    ] [beam_calculator.py  ]\u001b[0m Elapsed time in beam calculation: 0:00:00.641279\n",
       "\u001b[0;37m[INFO    ] [design_space.py     ]\u001b[0m Created variables:\n",
       "====================================================================================================\n",
       "Variable                  | Element         | x_0      | Lower lim | Upper lim\n",
@@ -836,7 +835,7 @@
       "====================================================================================================\n",
       "\u001b[0;37m[INFO    ] [factory.py          ]\u001b[0m Initalisation of ListOfElements from already initialized elements: FM8 to DR42.\n",
       "\u001b[0;37m[INFO    ] [list_of_elements.py ]\u001b[0m Successfully created a ListOfElements with self.w_kin_in = 22.995191173309475 MeV and self.phi_abs_in = 110.83968907012192 rad.\n",
-      "\u001b[0;37m[INFO    ] [beam_calculator.py  ]\u001b[0m Elapsed time in beam calculation: 0:00:00.587210\n",
+      "\u001b[0;37m[INFO    ] [beam_calculator.py  ]\u001b[0m Elapsed time in beam calculation: 0:00:00.622758\n",
       "\u001b[0;37m[INFO    ] [algorithm.py        ]\u001b[0m Objective functions results:\n",
       "  # |             What, where, etc             |  wgt. |      ideal value      |      final val.      \n",
       "  0 |                   w_kin @elt  DR42 (out) |   1.0 | +2.70893353168837e+01 | -1.28670398424902e-05\n",
@@ -862,7 +861,7 @@
       "Norm. $\\epsilon_{\\phi W}$ [$\\pi$.rad.MeV]              -0.000%   -0.000%             0.000\n",
       "$M_{z\\delta}$                                            0.000     0.000               nan\n",
       "----------------------------------------------------------------------------------------------------\n",
-      "\u001b[0;37m[INFO    ] [fault_scenario.py   ]\u001b[0m Elapsed time for optimization: 0:00:54.186253\n"
+      "\u001b[0;37m[INFO    ] [fault_scenario.py   ]\u001b[0m Elapsed time for optimization: 0:00:50.918212\n"
      ]
     },
     {
@@ -912,7 +911,7 @@
   },
   {
    "cell_type": "raw",
-   "id": "518b860e-7480-47ac-bc87-041a3422b9cd",
+   "id": "8527ea01-e926-4176-9163-98e56d3e6f0c",
    "metadata": {
     "editable": true,
     "raw_mimetype": "text/restructuredtext",
@@ -925,6 +924,297 @@
     ".. todo::\n",
     "   Better display of Figures in ``HTML`` documentation."
    ]
+  },
+  {
+   "cell_type": "raw",
+   "id": "f2bed95a-6c4b-4688-a35a-dc5c2d4a1036",
+   "metadata": {
+    "editable": true,
+    "raw_mimetype": "text/x-rst",
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "source": [
+    ".. todo::\n",
+    "   Better display of Figures in ``HTML`` documentation. ll"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "6e46d546-c560-4bba-a84e-6b3f6f87e1f4",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "source": [
+    "## Notes on objects hierarchy"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "2eddc76d-250c-4a31-9465-480c162376a5",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "source": [
+    "The unique [FaultScenario](../../lightwin/lightwin.failures.fault_scenario.rst#lightwin.failures.fault_scenario.FaultScenario) we studied can be accessed *via*:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 14,
+   "id": "97132a2c-64fe-490f-8845-a0e106454bfe",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "outputs": [],
+   "source": [
+    "fault_scenario = fault_scenarios[0]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "83f03e10-7afb-42c5-b67f-38e56b2efa16",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "source": [
+    "It holds two [Accelerator](../../lightwin/lightwin.core.accelerator.accelerator.rst#lightwin.core.accelerator.accelerator.Accelerator) objects, each containing a [ListOfElements](../../lightwin/lightwin.core.list_of_elements.list_of_elements.rst#lightwin.core.list_of_elements.list_of_elements.ListOfElements)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
+   "id": "ba2ae320-b66c-43b4-99d9-488e99fb7e79",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "outputs": [],
+   "source": [
+    "reference_accelerator = fault_scenario.ref_acc\n",
+    "reference_elts = reference_accelerator.elts\n",
+    "\n",
+    "fixed_accelerator = fault_scenario.fix_acc\n",
+    "fixed_elts = fixed_accelerator.elts"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "9bfc651d-cc14-40f9-8c62-3549f172c577",
+   "metadata": {},
+   "source": [
+    "The results are stored in a [SimulationOutput](../../lightwin/lightwin.beam_calculation.simulation_output.simulation_output.rst#lightwin.beam_calculation.simulation_output.simulation_output.SimulationOutput) object.\n",
+    "They are stored in a dictionary, which keys are the name of the [BeamCalculator](../../lightwin/lightwin.beam_calculation.beam_calculator.rst#lightwin.beam_calculation.beam_calculator.BeamCalculator) that were used (in this case, we should only have `\"CyEnvelope1D_0\"`)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "id": "6e83f9d5-87fe-4f70-ae5e-0c583e291f51",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "{'CyEnvelope1D_0': SimulationOutput:\n",
+      "\tz_abs            +0.00000e+00 -> +2.45598e+02 | (20245,)\n",
+      "\tParticleFullTrajectory:\n",
+      "\t\tw_kin            +2.00000e+01 -> +5.02242e+02 | (20245,)\n",
+      "\t\tphi_abs          +0.00000e+00 -> +1.19573e+03 | (20245,)\n",
+      "\tBeamParameters:\n",
+      "\t\tPhase space phiw:\n",
+      "\t\t\talpha            -1.76610e-01 -> +1.78597e-01 | (20245,)\n",
+      "\t\t\tbeta             +3.71099e+01 -> +6.73786e-01 | (20245,)\n",
+      "\t\t\teps              +3.38012e-02 -> +3.37897e-02 | (20245,)\n",
+      "\t\t\tenvelope_pos     +1.11998e+00 -> +1.50888e-01 | (20245,)\n",
+      "\t\t\tenvelope_energy  +3.06472e-02 -> +2.27483e-01 | (20245,)\n",
+      "\t\t\tmismatch_factor   (not set)\n",
+      "\t\tPhase space z:\n",
+      "\t\t\talpha            +1.76610e-01 -> -1.78597e-01 | (20245,)\n",
+      "\t\t\tbeta             +2.59322e+00 -> +8.32309e+00 | (20245,)\n",
+      "\t\t\teps              +3.00000e-01 -> +2.99898e-01 | (20245,)\n",
+      "\t\t\tenvelope_pos     +1.93596e+00 -> +1.46378e+00 | (20245,)\n",
+      "\t\t\tenvelope_energy  +7.58100e-01 -> +1.78653e-01 | (20245,)\n",
+      "\t\t\tmismatch_factor   (not set)\n",
+      "\t\tPhase space zdelta:\n",
+      "\t\t\talpha            +1.76610e-01 -> -1.78597e-01 | (20245,)\n",
+      "\t\t\tbeta             +2.48611e+01 -> +3.53108e+01 | (20245,)\n",
+      "\t\t\teps              +3.00000e-02 -> +2.99898e-02 | (20245,)\n",
+      "\t\t\tenvelope_pos     +1.89556e+00 -> +9.53428e-01 | (20245,)\n",
+      "\t\t\tenvelope_energy  +7.74259e-02 -> +2.74283e-02 | (20245,)\n",
+      "\t\t\tmismatch_factor  +0.00000e+00 -> +1.90749e-05 | (20245,)\n",
+      "}\n"
+     ]
+    }
+   ],
+   "source": [
+    "fixed_simulation_outputs = fixed_accelerator.simulation_outputs\n",
+    "pprint(fixed_simulation_outputs)\n",
+    "solver_name = list(fixed_simulation_outputs.keys())[0]\n",
+    "\n",
+    "fixed_simulation_output = fixed_simulation_outputs[solver_name]\n",
+    "reference_simulation_outputs = reference_accelerator.simulation_outputs[solver_name]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f679bc61-7403-46b9-ab2e-10b56424c782",
+   "metadata": {},
+   "source": [
+    "## Accessing data"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "bb40c397-112b-412d-8194-4cc1226d75c4",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "source": [
+    "The easiest way to access the calculated data is to use the [get method](https://lightwin.readthedocs.io/en/latest/manual/get_method.html)."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "id": "657ca734-f59c-4b41-8f02-66289db7d756",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "array([ 20.       ,  20.       ,  20.       , ..., 502.2415884,\n",
+       "       502.2415884, 502.2415884], shape=(20245,))"
+      ]
+     },
+     "execution_count": 17,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "fixed_simulation_output.get(\"w_kin\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "id": "b6162177-a650-463e-95d3-8c20f526d332",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "array(-23.56086376)"
+      ]
+     },
+     "execution_count": 18,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "fixed_simulation_output.get(\"phi_s\", to_deg=True, elt=\"FM53\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "id": "3b9a2e72-75db-4543-903f-f1608379fe19",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "array([0.20323928, 0.20323928, 0.20323928, ..., 0.75878131, 0.75878131,\n",
+       "       0.75878131], shape=(20245,))"
+      ]
+     },
+     "execution_count": 19,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "fixed_simulation_output.get(\"beta\", phase_space_name=\"phiw\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "id": "a82c718b-d392-4dd8-ab4f-d10a46fbe79a",
+   "metadata": {
+    "editable": true,
+    "slideshow": {
+     "slide_type": ""
+    },
+    "tags": []
+   },
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "0.05203248440319068"
+      ]
+     },
+     "execution_count": 20,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "fixed_simulation_output.get(\"envelope_energy_zdelta\", elt=\"FM48\", pos=\"out\", to_numpy=False)"
+   ]
   }
  ],
  "metadata": {

{lightwin-0.9.3 → lightwin-0.9.4/src/LightWin.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: LightWin
-Version: 0.9.3
+Version: 0.9.4
 Summary: Automatically compensate cavity failures in linacs
 Author-email: Adrien Plaçais <placais@lpsc.in2p3.fr>, Bruce Yee-Rendon <byee@post.j-parc.jp>, Didier Uriot <didier.uriot@cea.fr>, Frédéric Bouly <bouly@lpsc.in2p3.fr>, Jean-Michel Lagniel <jean-michel.lagniel@ganil.fr>
 Project-URL: changelog, https://github.com/AdrienPlacais/LightWin/blob/main/CHANGELOG.md

{lightwin-0.9.3 → lightwin-0.9.4}/src/LightWin.egg-info/SOURCES.txt

@@ -95,7 +95,6 @@ docs/lightwin/lightwin.config.key_val_conf_spec.rst
 docs/lightwin/lightwin.config.rst
 docs/lightwin/lightwin.config.table_spec.rst
 docs/lightwin/lightwin.config.toml_formatter.rst
-docs/lightwin/lightwin.config_manager.rst
 docs/lightwin/lightwin.constants.rst
 docs/lightwin/lightwin.core.accelerator.accelerator.rst
 docs/lightwin/lightwin.core.accelerator.factory.rst
@@ -289,18 +288,7 @@ docs/manual/usage.breaking_and_fixing.rst
 docs/manual/usage.compatibility_with_tracewin.rst
 docs/manual/usage.general_structure.rst
 docs/manual/usage.rst
-docs/manual/configuration_entries/beam.csv
-docs/manual/configuration_entries/beam_calculator_envelope_1d.csv
-docs/manual/configuration_entries/beam_calculator_envelope_3d.csv
-docs/manual/configuration_entries/beam_calculator_tracewin.csv
-docs/manual/configuration_entries/design_space_calculated.csv
-docs/manual/configuration_entries/design_space_from_file.csv
-docs/manual/configuration_entries/evaluator.csv
-docs/manual/configuration_entries/files.csv
-docs/manual/configuration_entries/plots.csv
-docs/manual/configuration_entries/wtf_k_out_of_n.csv
-docs/manual/configuration_entries/wtf_l_neighboring_lattices.csv
-docs/manual/configuration_entries/wtf_manual.csv
+docs/manual/images/get_example.png
 docs/manual/notebooks/absolute_vs_relative_phases.ipynb
 docs/manual/notebooks/example.ipynb
 docs/manual/troubles/module_not_found.rst