diff --git a/_modules/fbpic/fields/smoothing.html b/_modules/fbpic/fields/smoothing.html
index ce49d94..7a420ef 100644
--- a/_modules/fbpic/fields/smoothing.html
+++ b/_modules/fbpic/fields/smoothing.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>fbpic.fields.smoothing — FBPIC 0.24.0 documentation</title>
+ <title>fbpic.fields.smoothing — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../../_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
diff --git a/_modules/fbpic/lpa_utils/boosted_frame.html b/_modules/fbpic/lpa_utils/boosted_frame.html
index cbd24b0..38f2d2d 100644
--- a/_modules/fbpic/lpa_utils/boosted_frame.html
+++ b/_modules/fbpic/lpa_utils/boosted_frame.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>fbpic.lpa_utils.boosted_frame — FBPIC 0.24.0 documentation</title>
+ <title>fbpic.lpa_utils.boosted_frame — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../../_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
diff --git a/_modules/fbpic/lpa_utils/bunch.html b/_modules/fbpic/lpa_utils/bunch.html
index b89596d..6eb965f 100644
--- a/_modules/fbpic/lpa_utils/bunch.html
+++ b/_modules/fbpic/lpa_utils/bunch.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>fbpic.lpa_utils.bunch — FBPIC 0.24.0 documentation</title>
+ <title>fbpic.lpa_utils.bunch — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../../_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
diff --git a/_modules/fbpic/lpa_utils/external_fields.html b/_modules/fbpic/lpa_utils/external_fields.html
index a8a3191..a395a6f 100644
--- a/_modules/fbpic/lpa_utils/external_fields.html
+++ b/_modules/fbpic/lpa_utils/external_fields.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>fbpic.lpa_utils.external_fields — FBPIC 0.24.0 documentation</title>
+ <title>fbpic.lpa_utils.external_fields — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../../_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
diff --git a/_modules/fbpic/lpa_utils/laser/laser.html b/_modules/fbpic/lpa_utils/laser/laser.html
index e3aadfb..0349696 100644
--- a/_modules/fbpic/lpa_utils/laser/laser.html
+++ b/_modules/fbpic/lpa_utils/laser/laser.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>fbpic.lpa_utils.laser.laser — FBPIC 0.24.0 documentation</title>
+ <title>fbpic.lpa_utils.laser.laser — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../../../_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../../search.html" method="get">
diff --git a/_modules/fbpic/lpa_utils/laser/laser_profiles.html b/_modules/fbpic/lpa_utils/laser/laser_profiles.html
index 8820272..d489adf 100644
--- a/_modules/fbpic/lpa_utils/laser/laser_profiles.html
+++ b/_modules/fbpic/lpa_utils/laser/laser_profiles.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>fbpic.lpa_utils.laser.laser_profiles — FBPIC 0.24.0 documentation</title>
+ <title>fbpic.lpa_utils.laser.laser_profiles — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../../../_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../../search.html" method="get">
@@ -928,6 +928,8 @@ <h1>Source code for fbpic.lpa_utils.laser.laser_profiles</h1><div class="highlig
<span class="k">return</span><span class="p">(</span> <span class="n">Ex</span><span class="o">.</span><span class="n">real</span><span class="p">,</span> <span class="n">Ey</span><span class="o">.</span><span class="n">real</span> <span class="p">)</span></div>
+<div class="viewcode-block" id="FromLasyFileLaser">
+<a class="viewcode-back" href="../../../../api_reference/lpa_utilities/laser_profiles/from_lasy_file.html#fbpic.lpa_utils.laser.FromLasyFileLaser">[docs]</a>
<span class="k">class</span> <span class="nc">FromLasyFileLaser</span><span class="p">(</span> <span class="n">LaserProfile</span> <span class="p">):</span>
<span class="w"> </span><span class="sd">"""Class that emits a laser from a lasy file"""</span>
@@ -935,54 +937,57 @@ <h1>Source code for fbpic.lpa_utils.laser.laser_profiles</h1><div class="highlig
<span class="w"> </span><span class="sd">"""</span>
<span class="sd"> Define a laser whose profile is determined by a</span>
<span class="sd"> `lasy <https://lasydoc.readthedocs.io/en/latest/>`_ file.</span>
-<span class="sd"> </span>
-<span class="sd"> When the laser is initialized by this function, FBPIC forces the beginning of </span>
-<span class="sd"> the time axis in the ``lasy`` file to be zero (irrespective of the metadata for </span>
+
+<span class="sd"> When the laser is initialized by this function, FBPIC forces the beginning of</span>
+<span class="sd"> the time axis in the ``lasy`` file to be zero (irrespective of the metadata for</span>
<span class="sd"> ``tmin`` that is actually present in the ``lasy`` file). This convention was chosen</span>
<span class="sd"> for convenience, because ``tmin`` in ``lasy`` could otherwise result in large delays</span>
<span class="sd"> before emitting the laser, especially when using ``lasy``'s ``propagate`` feature.</span>
+<span class="sd"> .. warning::</span>
+
+<span class="sd"> This laser profile can only be emitted with the ``antenna`` method</span>
+<span class="sd"> (not with the ``direct`` method).</span>
+
<span class="sd"> Parameters</span>
<span class="sd"> ----------</span>
+
<span class="sd"> filename: string</span>
<span class="sd"> The path to the ``lasy`` file.</span>
<span class="sd"> t_start: float (in seconds), optional, default: 0</span>
<span class="sd"> Physical time (in the simulation), at which the laser will start being</span>
<span class="sd"> emitted. This can be used in order to introduce a time delay that was</span>
-<span class="sd"> not originally present in the ``lasy`` file. (As explained above, FBPIC ignores any </span>
+<span class="sd"> not originally present in the ``lasy`` file. (As explained above, FBPIC ignores any</span>
<span class="sd"> initial time offset in the ``lasy``. This offset is replaced by `t_start` (or zero if unspecified).</span>
-<span class="sd"> .. warning::</span>
-
-<span class="sd"> This laser profile can only be emitted with the ``antenna`` method</span>
-<span class="sd"> (not with the ``direct`` method).</span>
-<span class="sd"> </span>
-<span class="sd"> Example</span>
-<span class="sd"> ---------</span>
-<span class="sd"> .. code-block:: python</span>
-<span class="sd"> # Creating the lasy file</span>
-<span class="sd"> laser_profile = GaussianProfile(wavelength,polarization,</span>
-<span class="sd"> energy,spot_size,pulse_duration,t_peak=0)</span>
-<span class="sd"> dimensions = 'rt' # Use cylindrical geometry</span>
-<span class="sd"> lo = (0,-2.5*pulse_duration) # Lower bounds of the simulation box</span>
-<span class="sd"> hi = (5*spot_size,2.5*pulse_duration) # Upper bounds of the simulation box</span>
-<span class="sd"> num_points = (300,500) # Number of points in each dimension</span>
-<span class="sd"> laser = Laser(dimensions,lo,hi,num_points,laser_profile)</span>
-<span class="sd"> laser.propagate(-1e-3) # Propagate backwards by 1 mm</span>
-<span class="sd"> laser.write_to_file('lasy_laser', 'h5')</span>
-<span class="sd"> # Note that, in the lasy file, tmin is now a large, negative number.</span>
-<span class="sd"> # (The peak of laser intensity still occurs 2.5*pulse_duration after tmin.)</span>
-<span class="sd"> # FBPIC ignores tmin when reading the file, and sets the start of </span>
-<span class="sd"> # the lasy time axis to zero instead. So, by default, the peak of </span>
-<span class="sd"> # the laser intensity would occur at `t= 2.5*pulse_duration` in FBPIC.</span>
-<span class="sd"> laser_profile = FromLasyFileLaser( 'lasy_laser_00000.h5', t_start=0.5*pulse_duration )</span>
-<span class="sd"> add_laser_pulse(sim, laser_profile, method='antenna', z0_antenna=0)</span>
-<span class="sd"> # Here, modify the `t_start`, which will result in the peak of intensity being </span>
-<span class="sd"> # emitted at `(2.5+0.5)*pulse_duration` instead of `2.5*pulse_duration`.</span>
-<span class="sd"> # Since the `z0_antenna` was set to `0` here, this is as if the centroid </span>
-<span class="sd"> # of the laser would have been initialized at `z = -3*c*pulse_duration` at `t=0`</span>
-<span class="sd"> # (with then ``direct`` method).</span>
+<span class="sd"> Example</span>
+<span class="sd"> -------</span>
+
+<span class="sd"> .. code-block:: python</span>
+
+<span class="sd"> # Creating the lasy file</span>
+<span class="sd"> laser_profile = GaussianProfile(wavelength,polarization,</span>
+<span class="sd"> energy,spot_size,pulse_duration,t_peak=0)</span>
+<span class="sd"> dimensions = 'rt' # Use cylindrical geometry</span>
+<span class="sd"> lo = (0,-2.5*pulse_duration) # Lower bounds of the simulation box</span>
+<span class="sd"> hi = (5*spot_size,2.5*pulse_duration) # Upper bounds of the simulation box</span>
+<span class="sd"> num_points = (300,500) # Number of points in each dimension</span>
+<span class="sd"> laser = Laser(dimensions,lo,hi,num_points,laser_profile)</span>
+<span class="sd"> laser.propagate(-1e-3) # Propagate backwards by 1 mm</span>
+<span class="sd"> laser.write_to_file('lasy_laser', 'h5')</span>
+<span class="sd"> # Note that, in the lasy file, tmin is now a large, negative number.</span>
+<span class="sd"> # (The peak of laser intensity still occurs 2.5*pulse_duration after tmin.)</span>
+<span class="sd"> # FBPIC ignores tmin when reading the file, and sets the start of</span>
+<span class="sd"> # the lasy time axis to zero instead. So, by default, the peak of</span>
+<span class="sd"> # the laser intensity would occur at `t= 2.5*pulse_duration` in FBPIC.</span>
+<span class="sd"> laser_profile = FromLasyFileLaser( 'lasy_laser_00000.h5', t_start=0.5*pulse_duration )</span>
+<span class="sd"> add_laser_pulse(sim, laser_profile, method='antenna', z0_antenna=0)</span>
+<span class="sd"> # Here, modify the `t_start`, which will result in the peak of intensity being</span>
+<span class="sd"> # emitted at `(2.5+0.5)*pulse_duration` instead of `2.5*pulse_duration`.</span>
+<span class="sd"> # Since the `z0_antenna` was set to `0` here, this is as if the centroid</span>
+<span class="sd"> # of the laser would have been initialized at `z = -3*c*pulse_duration` at `t=0`</span>
+<span class="sd"> # (with then ``direct`` method).</span>
<span class="sd"> """</span>
<span class="c1"># Initialize propagation direction and mark as GPU capable</span>
<span class="n">LaserProfile</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">propagation_direction</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="n">gpu_capable</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
@@ -990,6 +995,21 @@ <h1>Source code for fbpic.lpa_utils.laser.laser_profiles</h1><div class="highlig
<span class="c1"># Open and read the lasy file</span>
<span class="n">f</span> <span class="o">=</span> <span class="n">h5py</span><span class="o">.</span><span class="n">File</span><span class="p">(</span> <span class="n">filename</span><span class="p">,</span> <span class="n">mode</span><span class="o">=</span><span class="s2">"r"</span> <span class="p">)</span>
+
+ <span class="c1"># Check lasy version</span>
+ <span class="n">valid_version</span> <span class="o">=</span> <span class="kc">False</span>
+ <span class="k">if</span> <span class="p">(</span><span class="s1">'softwareVersion'</span> <span class="ow">in</span> <span class="n">f</span><span class="o">.</span><span class="n">attrs</span><span class="p">):</span>
+ <span class="n">version_string</span> <span class="o">=</span> <span class="n">f</span><span class="o">.</span><span class="n">attrs</span><span class="p">[</span><span class="s1">'softwareVersion'</span><span class="p">]</span><span class="o">.</span><span class="n">decode</span><span class="p">()</span>
+ <span class="n">version_list</span> <span class="o">=</span> <span class="nb">tuple</span><span class="p">(</span><span class="nb">int</span><span class="p">(</span><span class="n">number</span><span class="p">)</span> <span class="k">for</span> <span class="n">number</span> <span class="ow">in</span> <span class="n">version_string</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">'.'</span><span class="p">))</span>
+ <span class="k">if</span> <span class="n">version_list</span> <span class="o">>=</span> <span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="mi">3</span><span class="p">,</span><span class="mi">0</span><span class="p">):</span>
+ <span class="n">valid_version</span> <span class="o">=</span> <span class="kc">True</span>
+ <span class="k">if</span> <span class="ow">not</span> <span class="n">valid_version</span><span class="p">:</span>
+ <span class="k">raise</span> <span class="ne">RuntimeError</span><span class="p">(</span>
+ <span class="s2">"The `lasy` version that was used to create the file </span><span class="si">%s</span><span class="s2"> "</span>
+ <span class="s2">"is obsolete and not supported by FBPIC. Please upgrade your lasy "</span>
+ <span class="s2">"version to at least 0.3.0 (e.g. with `pip install --upgrade lasy`) "</span>
+ <span class="s2">"and re-create the file </span><span class="si">%s</span><span class="s2">."</span> <span class="o">%</span><span class="p">(</span><span class="n">filename</span><span class="p">,</span> <span class="n">filename</span><span class="p">)</span> <span class="p">)</span>
+
<span class="n">dset</span> <span class="o">=</span> <span class="n">f</span><span class="p">[</span><span class="s1">'/data/0/meshes/laserEnvelope'</span><span class="p">]</span>
<span class="bp">self</span><span class="o">.</span><span class="n">omega</span> <span class="o">=</span> <span class="n">dset</span><span class="o">.</span><span class="n">attrs</span><span class="p">[</span><span class="s1">'angularFrequency'</span><span class="p">]</span>
<span class="bp">self</span><span class="o">.</span><span class="n">pol</span> <span class="o">=</span> <span class="n">dset</span><span class="o">.</span><span class="n">attrs</span><span class="p">[</span><span class="s1">'polarization'</span><span class="p">]</span>
@@ -1133,7 +1153,8 @@ <h1>Source code for fbpic.lpa_utils.laser.laser_profiles</h1><div class="highlig
<span class="c1"># one that was meant when creating the lasy file</span>
<span class="p">))</span>
- <span class="k">return</span><span class="p">(</span> <span class="p">(</span><span class="n">E</span> <span class="o">*</span> <span class="bp">self</span><span class="o">.</span><span class="n">pol</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span><span class="o">.</span><span class="n">real</span><span class="p">,</span> <span class="p">(</span><span class="n">E</span> <span class="o">*</span> <span class="bp">self</span><span class="o">.</span><span class="n">pol</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span><span class="o">.</span><span class="n">real</span> <span class="p">)</span>
+ <span class="k">return</span><span class="p">(</span> <span class="p">(</span><span class="n">E</span> <span class="o">*</span> <span class="bp">self</span><span class="o">.</span><span class="n">pol</span><span class="p">[</span><span class="mi">0</span><span class="p">])</span><span class="o">.</span><span class="n">real</span><span class="p">,</span> <span class="p">(</span><span class="n">E</span> <span class="o">*</span> <span class="bp">self</span><span class="o">.</span><span class="n">pol</span><span class="p">[</span><span class="mi">1</span><span class="p">])</span><span class="o">.</span><span class="n">real</span> <span class="p">)</span></div>
+
</pre></div>
</div>
diff --git a/_modules/fbpic/main.html b/_modules/fbpic/main.html
index 9e31bfc..eeba164 100644
--- a/_modules/fbpic/main.html
+++ b/_modules/fbpic/main.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>fbpic.main — FBPIC 0.24.0 documentation</title>
+ <title>fbpic.main — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../_static/doctools.js?v=888ff710"></script>
<script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
diff --git a/_modules/fbpic/openpmd_diag/boosted_field_diag.html b/_modules/fbpic/openpmd_diag/boosted_field_diag.html
index 72b5a8e..fb5fe34 100644
--- a/_modules/fbpic/openpmd_diag/boosted_field_diag.html
+++ b/_modules/fbpic/openpmd_diag/boosted_field_diag.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>fbpic.openpmd_diag.boosted_field_diag — FBPIC 0.24.0 documentation</title>
+ <title>fbpic.openpmd_diag.boosted_field_diag — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../../_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
diff --git a/_modules/fbpic/openpmd_diag/boosted_particle_diag.html b/_modules/fbpic/openpmd_diag/boosted_particle_diag.html
index 8fe9510..8f10e1e 100644
--- a/_modules/fbpic/openpmd_diag/boosted_particle_diag.html
+++ b/_modules/fbpic/openpmd_diag/boosted_particle_diag.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>fbpic.openpmd_diag.boosted_particle_diag — FBPIC 0.24.0 documentation</title>
+ <title>fbpic.openpmd_diag.boosted_particle_diag — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../../_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
diff --git a/_modules/fbpic/openpmd_diag/checkpoint_restart.html b/_modules/fbpic/openpmd_diag/checkpoint_restart.html
index eb6f2a9..92ee09c 100644
--- a/_modules/fbpic/openpmd_diag/checkpoint_restart.html
+++ b/_modules/fbpic/openpmd_diag/checkpoint_restart.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>fbpic.openpmd_diag.checkpoint_restart — FBPIC 0.24.0 documentation</title>
+ <title>fbpic.openpmd_diag.checkpoint_restart — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../../_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
diff --git a/_modules/fbpic/openpmd_diag/field_diag.html b/_modules/fbpic/openpmd_diag/field_diag.html
index e8cbe07..7b42562 100644
--- a/_modules/fbpic/openpmd_diag/field_diag.html
+++ b/_modules/fbpic/openpmd_diag/field_diag.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>fbpic.openpmd_diag.field_diag — FBPIC 0.24.0 documentation</title>
+ <title>fbpic.openpmd_diag.field_diag — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../../_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
diff --git a/_modules/fbpic/openpmd_diag/particle_density_diag.html b/_modules/fbpic/openpmd_diag/particle_density_diag.html
index e76d673..54ca2e5 100644
--- a/_modules/fbpic/openpmd_diag/particle_density_diag.html
+++ b/_modules/fbpic/openpmd_diag/particle_density_diag.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>fbpic.openpmd_diag.particle_density_diag — FBPIC 0.24.0 documentation</title>
+ <title>fbpic.openpmd_diag.particle_density_diag — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../../_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
diff --git a/_modules/fbpic/openpmd_diag/particle_diag.html b/_modules/fbpic/openpmd_diag/particle_diag.html
index d66d396..9b20a60 100644
--- a/_modules/fbpic/openpmd_diag/particle_diag.html
+++ b/_modules/fbpic/openpmd_diag/particle_diag.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>fbpic.openpmd_diag.particle_diag — FBPIC 0.24.0 documentation</title>
+ <title>fbpic.openpmd_diag.particle_diag — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../../_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
diff --git a/_modules/fbpic/utils/random_seed.html b/_modules/fbpic/utils/random_seed.html
index b248d59..8a79bab 100644
--- a/_modules/fbpic/utils/random_seed.html
+++ b/_modules/fbpic/utils/random_seed.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>fbpic.utils.random_seed — FBPIC 0.24.0 documentation</title>
+ <title>fbpic.utils.random_seed — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../../_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
diff --git a/_modules/index.html b/_modules/index.html
index 4e3c70c..2ea83a9 100644
--- a/_modules/index.html
+++ b/_modules/index.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Overview: module code — FBPIC 0.24.0 documentation</title>
+ <title>Overview: module code — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/_sources/api_reference/lpa_utilities/laser.rst.txt b/_sources/api_reference/lpa_utilities/laser.rst.txt
index 7320353..a6a9507 100644
--- a/_sources/api_reference/lpa_utilities/laser.rst.txt
+++ b/_sources/api_reference/lpa_utilities/laser.rst.txt
@@ -59,6 +59,7 @@ own custom laser profiles.
laser_profiles/donut_laguerre
laser_profiles/flattened
laser_profiles/few_cycle
+ laser_profiles/from_lasy_file
Combining (summing) laser profiles
**********************************
diff --git a/_sources/api_reference/lpa_utilities/laser_profiles/from_lasy_file.rst.txt b/_sources/api_reference/lpa_utilities/laser_profiles/from_lasy_file.rst.txt
new file mode 100644
index 0000000..9589b48
--- /dev/null
+++ b/_sources/api_reference/lpa_utilities/laser_profiles/from_lasy_file.rst.txt
@@ -0,0 +1,4 @@
+Profile from a file produced by ``lasy``
+****************************************
+
+.. autoclass:: fbpic.lpa_utils.laser.FromLasyFileLaser
diff --git a/_sources/index.rst.txt b/_sources/index.rst.txt
index 204ceeb..223ea17 100644
--- a/_sources/index.rst.txt
+++ b/_sources/index.rst.txt
@@ -68,7 +68,8 @@ and Manuel Kirchen at
benefitted from the contributions of Soeren Jalas (CFEL), Kevin Peters (CFEL),
Irene Dornmair (CFEL), Laurids Jeppe (CFEL), Igor Andriyash (Laboratoire d'Optique Appliquee),
Omri Seemann (Weizmann Institute), Daniel Seipt (University of Michigan),
-Samuel Yoffe (University of Strathclyde) and David Grote (LLNL and LBNL).
+Samuel Yoffe (University of Strathclyde), David Grote (LLNL and LBNL)
+and Anton Golovanov (Weizmann Institute).
FBPIC's algorithms are documented in following scientific publications:
diff --git a/_sources/install/install_local.rst.txt b/_sources/install/install_local.rst.txt
index f2fc8ea..39cd30a 100644
--- a/_sources/install/install_local.rst.txt
+++ b/_sources/install/install_local.rst.txt
@@ -77,6 +77,13 @@ MPI-related error, try installing ``mpi4py`` using MacPorts and
sudo port select --set mpi openmpi-gcc48-fortran
pip install mpi4py
+If you are running on an Apple Silicon machine, `mkl` is not available via `conda`. You can use `brew` instead:
+
+::
+
+ brew install onednn
+
+
Running simulations
-------------------
diff --git a/_static/documentation_options.js b/_static/documentation_options.js
index e0927a1..5d62d54 100644
--- a/_static/documentation_options.js
+++ b/_static/documentation_options.js
@@ -1,5 +1,5 @@
const DOCUMENTATION_OPTIONS = {
- VERSION: '0.24.0',
+ VERSION: '0.25.0',
LANGUAGE: 'en',
COLLAPSE_INDEX: false,
BUILDER: 'html',
diff --git a/advanced/3d_visualization.html b/advanced/3d_visualization.html
index a6c9826..fb2ea8e 100644
--- a/advanced/3d_visualization.html
+++ b/advanced/3d_visualization.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>3D visualization using PyVista — FBPIC 0.24.0 documentation</title>
+ <title>3D visualization using PyVista — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -32,7 +32,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/advanced/advanced.html b/advanced/advanced.html
index 8c316a7..ea1edac 100644
--- a/advanced/advanced.html
+++ b/advanced/advanced.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Advanced use — FBPIC 0.24.0 documentation</title>
+ <title>Advanced use — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/advanced/boosted_frame.html b/advanced/boosted_frame.html
index 8f09d06..c6865d3 100644
--- a/advanced/boosted_frame.html
+++ b/advanced/boosted_frame.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Running boosted-frame simulations — FBPIC 0.24.0 documentation</title>
+ <title>Running boosted-frame simulations — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script async="async" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
@@ -34,7 +34,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/advanced/parameter_scans.html b/advanced/parameter_scans.html
index 6952af9..c83af56 100644
--- a/advanced/parameter_scans.html
+++ b/advanced/parameter_scans.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Performing parameter scans in parallel — FBPIC 0.24.0 documentation</title>
+ <title>Performing parameter scans in parallel — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/advanced/profiling.html b/advanced/profiling.html
index e29cb94..5468c4a 100644
--- a/advanced/profiling.html
+++ b/advanced/profiling.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Profiling the code — FBPIC 0.24.0 documentation</title>
+ <title>Profiling the code — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/api_reference/api_reference.html b/api_reference/api_reference.html
index c2889f6..6432e14 100644
--- a/api_reference/api_reference.html
+++ b/api_reference/api_reference.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>API reference — FBPIC 0.24.0 documentation</title>
+ <title>API reference — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/api_reference/boost_converter.html b/api_reference/boost_converter.html
index 35b39f9..46edbba 100644
--- a/api_reference/boost_converter.html
+++ b/api_reference/boost_converter.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Conversion to boosted-frame — FBPIC 0.24.0 documentation</title>
+ <title>Conversion to boosted-frame — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/api_reference/checkpoint_restart.html b/api_reference/checkpoint_restart.html
index c627fe5..1e75a59 100644
--- a/api_reference/checkpoint_restart.html
+++ b/api_reference/checkpoint_restart.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Checkpoints and restarts — FBPIC 0.24.0 documentation</title>
+ <title>Checkpoints and restarts — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/api_reference/diagnostics.html b/api_reference/diagnostics.html
index 28d62bc..158bd64 100644
--- a/api_reference/diagnostics.html
+++ b/api_reference/diagnostics.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>The openPMD diagnostics — FBPIC 0.24.0 documentation</title>
+ <title>The openPMD diagnostics — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/api_reference/lpa_utilities/beam.html b/api_reference/lpa_utilities/beam.html
index 8d10be4..0737416 100644
--- a/api_reference/lpa_utilities/beam.html
+++ b/api_reference/lpa_utilities/beam.html
@@ -4,21 +4,21 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Beam initialization — FBPIC 0.24.0 documentation</title>
+ <title>Beam initialization — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../_static/doctools.js?v=888ff710"></script>
<script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../_static/js/theme.js"></script>
<link rel="index" title="Index" href="../../genindex.html" />
<link rel="search" title="Search" href="../../search.html" />
<link rel="next" title="External fields" href="external_fields.html" />
- <link rel="prev" title="Few-cycle profile" href="laser_profiles/few_cycle.html" />
+ <link rel="prev" title="Profile from a file produced by lasy" href="laser_profiles/from_lasy_file.html" />
</head>
<body class="wy-body-for-nav">
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
@@ -318,7 +318,7 @@ <h1>Beam initialization<a class="headerlink" href="#beam-initialization" title="
</div>
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
- <a href="laser_profiles/few_cycle.html" class="btn btn-neutral float-left" title="Few-cycle profile" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+ <a href="laser_profiles/from_lasy_file.html" class="btn btn-neutral float-left" title="Profile from a file produced by lasy" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
<a href="external_fields.html" class="btn btn-neutral float-right" title="External fields" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
diff --git a/api_reference/lpa_utilities/external_fields.html b/api_reference/lpa_utilities/external_fields.html
index 34f9977..8a344eb 100644
--- a/api_reference/lpa_utilities/external_fields.html
+++ b/api_reference/lpa_utilities/external_fields.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>External fields — FBPIC 0.24.0 documentation</title>
+ <title>External fields — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../_static/doctools.js?v=888ff710"></script>
<script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
diff --git a/api_reference/lpa_utilities/laser.html b/api_reference/lpa_utilities/laser.html
index 7235025..2b7f077 100644
--- a/api_reference/lpa_utilities/laser.html
+++ b/api_reference/lpa_utilities/laser.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Laser initialization — FBPIC 0.24.0 documentation</title>
+ <title>Laser initialization — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../_static/doctools.js?v=888ff710"></script>
<script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script async="async" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
@@ -34,7 +34,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
@@ -197,6 +197,7 @@ <h2>Laser profiles<a class="headerlink" href="#laser-profiles" title="Link to th
<li class="toctree-l1"><a class="reference internal" href="laser_profiles/donut_laguerre.html">Donut-like Laguerre-Gauss profile</a></li>
<li class="toctree-l1"><a class="reference internal" href="laser_profiles/flattened.html">Flattened Gaussian profile</a></li>
<li class="toctree-l1"><a class="reference internal" href="laser_profiles/few_cycle.html">Few-cycle profile</a></li>
+<li class="toctree-l1"><a class="reference internal" href="laser_profiles/from_lasy_file.html">Profile from a file produced by <code class="docutils literal notranslate"><span class="pre">lasy</span></code></a></li>
</ul>
</div>
<section id="combining-summing-laser-profiles">
diff --git a/api_reference/lpa_utilities/laser_profiles/donut_laguerre.html b/api_reference/lpa_utilities/laser_profiles/donut_laguerre.html
index e9eb590..886ebde 100644
--- a/api_reference/lpa_utilities/laser_profiles/donut_laguerre.html
+++ b/api_reference/lpa_utilities/laser_profiles/donut_laguerre.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Donut-like Laguerre-Gauss profile — FBPIC 0.24.0 documentation</title>
+ <title>Donut-like Laguerre-Gauss profile — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script async="async" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
@@ -34,7 +34,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
diff --git a/api_reference/lpa_utilities/laser_profiles/few_cycle.html b/api_reference/lpa_utilities/laser_profiles/few_cycle.html
index 89a42ea..250d329 100644
--- a/api_reference/lpa_utilities/laser_profiles/few_cycle.html
+++ b/api_reference/lpa_utilities/laser_profiles/few_cycle.html
@@ -4,21 +4,21 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Few-cycle profile — FBPIC 0.24.0 documentation</title>
+ <title>Few-cycle profile — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script async="async" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
<script src="../../../_static/js/theme.js"></script>
<link rel="index" title="Index" href="../../../genindex.html" />
<link rel="search" title="Search" href="../../../search.html" />
- <link rel="next" title="Beam initialization" href="../beam.html" />
+ <link rel="next" title="Profile from a file produced by lasy" href="from_lasy_file.html" />
<link rel="prev" title="Flattened Gaussian profile" href="flattened.html" />
</head>
@@ -34,7 +34,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
@@ -168,7 +168,7 @@ <h1>Few-cycle profile<a class="headerlink" href="#few-cycle-profile" title="Link
</div>
<footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
<a href="flattened.html" class="btn btn-neutral float-left" title="Flattened Gaussian profile" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
- <a href="../beam.html" class="btn btn-neutral float-right" title="Beam initialization" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+ <a href="from_lasy_file.html" class="btn btn-neutral float-right" title="Profile from a file produced by lasy" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
</div>
<hr/>
diff --git a/api_reference/lpa_utilities/laser_profiles/flattened.html b/api_reference/lpa_utilities/laser_profiles/flattened.html
index 87134c7..01a0fa1 100644
--- a/api_reference/lpa_utilities/laser_profiles/flattened.html
+++ b/api_reference/lpa_utilities/laser_profiles/flattened.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Flattened Gaussian profile — FBPIC 0.24.0 documentation</title>
+ <title>Flattened Gaussian profile — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script async="async" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
@@ -34,7 +34,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
diff --git a/api_reference/lpa_utilities/laser_profiles/from_lasy_file.html b/api_reference/lpa_utilities/laser_profiles/from_lasy_file.html
new file mode 100644
index 0000000..1442c9b
--- /dev/null
+++ b/api_reference/lpa_utilities/laser_profiles/from_lasy_file.html
@@ -0,0 +1,188 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" >
+<head>
+ <meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
+
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+ <title>Profile from a file produced by lasy — FBPIC 0.25.0 documentation</title>
+ <link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
+ <link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
+ <!--[if lt IE 9]>
+ <script src="../../../_static/js/html5shiv.min.js"></script>
+ <![endif]-->
+
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
+ <script src="../../../_static/doctools.js?v=888ff710"></script>
+ <script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
+ <script src="../../../_static/js/theme.js"></script>
+ <link rel="index" title="Index" href="../../../genindex.html" />
+ <link rel="search" title="Search" href="../../../search.html" />
+ <link rel="next" title="Beam initialization" href="../beam.html" />
+ <link rel="prev" title="Few-cycle profile" href="few_cycle.html" />
+</head>
+
+<body class="wy-body-for-nav">
+ <div class="wy-grid-for-nav">
+ <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+ <div class="wy-side-scroll">
+ <div class="wy-side-nav-search" >
+
+
+
+ <a href="../../../index.html" class="icon icon-home">
+ FBPIC
+ </a>
+ <div class="version">
+ 0.25.0
+ </div>
+<div role="search">
+ <form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
+ <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+ <input type="hidden" name="check_keywords" value="yes" />
+ <input type="hidden" name="area" value="default" />
+ </form>
+</div>
+ </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+ <ul class="current">
+<li class="toctree-l1"><a class="reference internal" href="../../../overview/overview.html">Overview of the code</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../install/installation.html">Installation</a></li>
+<li class="toctree-l1"><a class="reference internal" href="../../../how_to_run.html">How to run the code</a></li>
+<li class="toctree-l1 current"><a class="reference internal" href="../../api_reference.html">API reference</a><ul class="current">
+<li class="toctree-l2"><a class="reference internal" href="../../simulation.html">The Simulation class</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../particles.html">The Particles class</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../diagnostics.html">The openPMD diagnostics</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../checkpoint_restart.html">Checkpoints and restarts</a></li>
+<li class="toctree-l2 current"><a class="reference internal" href="../lpa_utilities.html">Laser-plasma utilities</a><ul class="current">
+<li class="toctree-l3 current"><a class="reference internal" href="../laser.html">Laser initialization</a><ul class="current">
+<li class="toctree-l4"><a class="reference internal" href="../laser.html#generic-function-for-arbitrary-laser-profile">Generic function for arbitrary laser profile</a></li>
+<li class="toctree-l4 current"><a class="reference internal" href="../laser.html#laser-profiles">Laser profiles</a></li>
+<li class="toctree-l4"><a class="reference internal" href="../laser.html#compact-function-for-a-gaussian-pulse">Compact function for a Gaussian pulse</a></li>
+</ul>
+</li>
+<li class="toctree-l3"><a class="reference internal" href="../beam.html">Beam initialization</a></li>
+<li class="toctree-l3"><a class="reference internal" href="../external_fields.html">External fields</a></li>
+</ul>
+</li>
+<li class="toctree-l2"><a class="reference internal" href="../../boost_converter.html">Conversion to boosted-frame</a></li>
+<li class="toctree-l2"><a class="reference internal" href="../../smoothing.html">Field smoothing</a></li>
+</ul>
+</li>
+<li class="toctree-l1"><a class="reference internal" href="../../../advanced/advanced.html">Advanced use</a></li>
+</ul>
+
+ </div>
+ </div>
+ </nav>
+
+ <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu" >
+ <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+ <a href="../../../index.html">FBPIC</a>
+ </nav>
+
+ <div class="wy-nav-content">
+ <div class="rst-content">
+ <div role="navigation" aria-label="Page navigation">
+ <ul class="wy-breadcrumbs">
+ <li><a href="../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+ <li class="breadcrumb-item"><a href="../../api_reference.html">API reference</a></li>
+ <li class="breadcrumb-item"><a href="../lpa_utilities.html">Laser-plasma utilities</a></li>
+ <li class="breadcrumb-item"><a href="../laser.html">Laser initialization</a></li>
+ <li class="breadcrumb-item active">Profile from a file produced by <code class="docutils literal notranslate"><span class="pre">lasy</span></code></li>
+ <li class="wy-breadcrumbs-aside">
+ <a href="../../../_sources/api_reference/lpa_utilities/laser_profiles/from_lasy_file.rst.txt" rel="nofollow"> View page source</a>
+ </li>
+ </ul>
+ <hr/>
+</div>
+ <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+ <div itemprop="articleBody">
+
+ <section id="profile-from-a-file-produced-by-lasy">
+<h1>Profile from a file produced by <code class="docutils literal notranslate"><span class="pre">lasy</span></code><a class="headerlink" href="#profile-from-a-file-produced-by-lasy" title="Link to this heading">¶</a></h1>
+<dl class="py class">
+<dt class="sig sig-object py" id="fbpic.lpa_utils.laser.FromLasyFileLaser">
+<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">fbpic.lpa_utils.laser.</span></span><span class="sig-name descname"><span class="pre">FromLasyFileLaser</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">filename</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">t_start</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">0.0</span></span></em><span class="sig-paren">)</span><a class="reference internal" href="../../../_modules/fbpic/lpa_utils/laser/laser_profiles.html#FromLasyFileLaser"><span class="viewcode-link"><span class="pre">[source]</span></span></a><a class="headerlink" href="#fbpic.lpa_utils.laser.FromLasyFileLaser" title="Link to this definition">¶</a></dt>
+<dd><p>Define a laser whose profile is determined by a
+<a class="reference external" href="https://lasydoc.readthedocs.io/en/latest/">lasy</a> file.</p>
+<p>When the laser is initialized by this function, FBPIC forces the beginning of
+the time axis in the <code class="docutils literal notranslate"><span class="pre">lasy</span></code> file to be zero (irrespective of the metadata for
+<code class="docutils literal notranslate"><span class="pre">tmin</span></code> that is actually present in the <code class="docutils literal notranslate"><span class="pre">lasy</span></code> file). This convention was chosen
+for convenience, because <code class="docutils literal notranslate"><span class="pre">tmin</span></code> in <code class="docutils literal notranslate"><span class="pre">lasy</span></code> could otherwise result in large delays
+before emitting the laser, especially when using <code class="docutils literal notranslate"><span class="pre">lasy</span></code>’s <code class="docutils literal notranslate"><span class="pre">propagate</span></code> feature.</p>
+<div class="admonition warning">
+<p class="admonition-title">Warning</p>
+<p>This laser profile can only be emitted with the <code class="docutils literal notranslate"><span class="pre">antenna</span></code> method
+(not with the <code class="docutils literal notranslate"><span class="pre">direct</span></code> method).</p>
+</div>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>filename</strong> (<em>string</em>) – The path to the <code class="docutils literal notranslate"><span class="pre">lasy</span></code> file.</p></li>
+<li><p><strong>t_start</strong> (<em>float</em><em> (</em><em>in seconds</em><em>)</em><em>, </em><em>optional</em><em>, </em><em>default: 0</em>) – Physical time (in the simulation), at which the laser will start being
+emitted. This can be used in order to introduce a time delay that was
+not originally present in the <code class="docutils literal notranslate"><span class="pre">lasy</span></code> file. (As explained above, FBPIC ignores any
+initial time offset in the <code class="docutils literal notranslate"><span class="pre">lasy</span></code>. This offset is replaced by <cite>t_start</cite> (or zero if unspecified).</p></li>
+</ul>
+</dd>
+</dl>
+<p class="rubric">Example</p>
+<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="c1"># Creating the lasy file</span>
+<span class="n">laser_profile</span> <span class="o">=</span> <span class="n">GaussianProfile</span><span class="p">(</span><span class="n">wavelength</span><span class="p">,</span><span class="n">polarization</span><span class="p">,</span>
+ <span class="n">energy</span><span class="p">,</span><span class="n">spot_size</span><span class="p">,</span><span class="n">pulse_duration</span><span class="p">,</span><span class="n">t_peak</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>
+<span class="n">dimensions</span> <span class="o">=</span> <span class="s1">'rt'</span> <span class="c1"># Use cylindrical geometry</span>
+<span class="n">lo</span> <span class="o">=</span> <span class="p">(</span><span class="mi">0</span><span class="p">,</span><span class="o">-</span><span class="mf">2.5</span><span class="o">*</span><span class="n">pulse_duration</span><span class="p">)</span> <span class="c1"># Lower bounds of the simulation box</span>
+<span class="n">hi</span> <span class="o">=</span> <span class="p">(</span><span class="mi">5</span><span class="o">*</span><span class="n">spot_size</span><span class="p">,</span><span class="mf">2.5</span><span class="o">*</span><span class="n">pulse_duration</span><span class="p">)</span> <span class="c1"># Upper bounds of the simulation box</span>
+<span class="n">num_points</span> <span class="o">=</span> <span class="p">(</span><span class="mi">300</span><span class="p">,</span><span class="mi">500</span><span class="p">)</span> <span class="c1"># Number of points in each dimension</span>
+<span class="n">laser</span> <span class="o">=</span> <span class="n">Laser</span><span class="p">(</span><span class="n">dimensions</span><span class="p">,</span><span class="n">lo</span><span class="p">,</span><span class="n">hi</span><span class="p">,</span><span class="n">num_points</span><span class="p">,</span><span class="n">laser_profile</span><span class="p">)</span>
+<span class="n">laser</span><span class="o">.</span><span class="n">propagate</span><span class="p">(</span><span class="o">-</span><span class="mf">1e-3</span><span class="p">)</span> <span class="c1"># Propagate backwards by 1 mm</span>
+<span class="n">laser</span><span class="o">.</span><span class="n">write_to_file</span><span class="p">(</span><span class="s1">'lasy_laser'</span><span class="p">,</span> <span class="s1">'h5'</span><span class="p">)</span>
+<span class="c1"># Note that, in the lasy file, tmin is now a large, negative number.</span>
+<span class="c1"># (The peak of laser intensity still occurs 2.5*pulse_duration after tmin.)</span>
+<span class="c1"># FBPIC ignores tmin when reading the file, and sets the start of</span>
+<span class="c1"># the lasy time axis to zero instead. So, by default, the peak of</span>
+<span class="c1"># the laser intensity would occur at `t= 2.5*pulse_duration` in FBPIC.</span>
+<span class="n">laser_profile</span> <span class="o">=</span> <span class="n">FromLasyFileLaser</span><span class="p">(</span> <span class="s1">'lasy_laser_00000.h5'</span><span class="p">,</span> <span class="n">t_start</span><span class="o">=</span><span class="mf">0.5</span><span class="o">*</span><span class="n">pulse_duration</span> <span class="p">)</span>
+<span class="n">add_laser_pulse</span><span class="p">(</span><span class="n">sim</span><span class="p">,</span> <span class="n">laser_profile</span><span class="p">,</span> <span class="n">method</span><span class="o">=</span><span class="s1">'antenna'</span><span class="p">,</span> <span class="n">z0_antenna</span><span class="o">=</span><span class="mi">0</span><span class="p">)</span>
+<span class="c1"># Here, modify the `t_start`, which will result in the peak of intensity being</span>
+<span class="c1"># emitted at `(2.5+0.5)*pulse_duration` instead of `2.5*pulse_duration`.</span>
+<span class="c1"># Since the `z0_antenna` was set to `0` here, this is as if the centroid</span>
+<span class="c1"># of the laser would have been initialized at `z = -3*c*pulse_duration` at `t=0`</span>
+<span class="c1"># (with then ``direct`` method).</span>
+</pre></div>
+</div>
+</dd></dl>
+
+</section>
+
+
+ </div>
+ </div>
+ <footer><div class="rst-footer-buttons" role="navigation" aria-label="Footer">
+ <a href="few_cycle.html" class="btn btn-neutral float-left" title="Few-cycle profile" accesskey="p" rel="prev"><span class="fa fa-arrow-circle-left" aria-hidden="true"></span> Previous</a>
+ <a href="../beam.html" class="btn btn-neutral float-right" title="Beam initialization" accesskey="n" rel="next">Next <span class="fa fa-arrow-circle-right" aria-hidden="true"></span></a>
+ </div>
+
+ <hr/>
+
+ <div role="contentinfo">
+ <p>© Copyright 2016, FBPIC contributors.</p>
+ </div>
+
+ Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+ <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+ provided by <a href="https://readthedocs.org">Read the Docs</a>.
+
+
+</footer>
+ </div>
+ </div>
+ </section>
+ </div>
+ <script>
+ jQuery(function () {
+ SphinxRtdTheme.Navigation.enable(true);
+ });
+ </script>
+
+</body>
+</html>
\ No newline at end of file
diff --git a/api_reference/lpa_utilities/laser_profiles/gaussian.html b/api_reference/lpa_utilities/laser_profiles/gaussian.html
index 00537cc..e84699d 100644
--- a/api_reference/lpa_utilities/laser_profiles/gaussian.html
+++ b/api_reference/lpa_utilities/laser_profiles/gaussian.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Gaussian profile — FBPIC 0.24.0 documentation</title>
+ <title>Gaussian profile — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script async="async" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
@@ -34,7 +34,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
diff --git a/api_reference/lpa_utilities/laser_profiles/laguerre.html b/api_reference/lpa_utilities/laser_profiles/laguerre.html
index 1f4f46e..0180cf4 100644
--- a/api_reference/lpa_utilities/laser_profiles/laguerre.html
+++ b/api_reference/lpa_utilities/laser_profiles/laguerre.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Laguerre-Gauss profile — FBPIC 0.24.0 documentation</title>
+ <title>Laguerre-Gauss profile — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../../_static/doctools.js?v=888ff710"></script>
<script src="../../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script async="async" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
@@ -34,7 +34,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../../search.html" method="get">
diff --git a/api_reference/lpa_utilities/lpa_utilities.html b/api_reference/lpa_utilities/lpa_utilities.html
index 738e1f6..697c067 100644
--- a/api_reference/lpa_utilities/lpa_utilities.html
+++ b/api_reference/lpa_utilities/lpa_utilities.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Laser-plasma utilities — FBPIC 0.24.0 documentation</title>
+ <title>Laser-plasma utilities — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../../_static/doctools.js?v=888ff710"></script>
<script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
diff --git a/api_reference/particles.html b/api_reference/particles.html
index b6f6612..814ee3f 100644
--- a/api_reference/particles.html
+++ b/api_reference/particles.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>The Particles class — FBPIC 0.24.0 documentation</title>
+ <title>The Particles class — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/api_reference/simulation.html b/api_reference/simulation.html
index 484e924..88ec848 100644
--- a/api_reference/simulation.html
+++ b/api_reference/simulation.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>The Simulation class — FBPIC 0.24.0 documentation</title>
+ <title>The Simulation class — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/api_reference/smoothing.html b/api_reference/smoothing.html
index 9adf4eb..81e6c1b 100644
--- a/api_reference/smoothing.html
+++ b/api_reference/smoothing.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Field smoothing — FBPIC 0.24.0 documentation</title>
+ <title>Field smoothing — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/example_input/boosted_frame_script.html b/example_input/boosted_frame_script.html
index d808fe0..29beb7a 100644
--- a/example_input/boosted_frame_script.html
+++ b/example_input/boosted_frame_script.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Boosted-frame simulation of laser-wakefield acceleration — FBPIC 0.24.0 documentation</title>
+ <title>Boosted-frame simulation of laser-wakefield acceleration — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/example_input/ionization_script.html b/example_input/ionization_script.html
index b817a7a..e8834c6 100644
--- a/example_input/ionization_script.html
+++ b/example_input/ionization_script.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Laser-wakefield acceleration with ionization — FBPIC 0.24.0 documentation</title>
+ <title>Laser-wakefield acceleration with ionization — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/example_input/lwfa_script.html b/example_input/lwfa_script.html
index 0d3b042..78aec70 100644
--- a/example_input/lwfa_script.html
+++ b/example_input/lwfa_script.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Standard simulation of laser-wakefield acceleration — FBPIC 0.24.0 documentation</title>
+ <title>Standard simulation of laser-wakefield acceleration — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/genindex.html b/genindex.html
index c80fbe4..bba7667 100644
--- a/genindex.html
+++ b/genindex.html
@@ -3,14 +3,14 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Index — FBPIC 0.24.0 documentation</title>
+ <title>Index — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="_static/documentation_options.js?v=a9084e48"></script>
+ <script src="_static/documentation_options.js?v=d8dd0411"></script>
<script src="_static/doctools.js?v=888ff710"></script>
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="_static/js/theme.js"></script>
@@ -30,7 +30,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
@@ -175,6 +175,8 @@ <h2 id="F">F</h2>
<li><a href="api_reference/diagnostics.html#fbpic.openpmd_diag.FieldDiagnostic">FieldDiagnostic (class in fbpic.openpmd_diag)</a>
</li>
<li><a href="api_reference/lpa_utilities/laser_profiles/flattened.html#fbpic.lpa_utils.laser.FlattenedGaussianLaser">FlattenedGaussianLaser (class in fbpic.lpa_utils.laser)</a>
+</li>
+ <li><a href="api_reference/lpa_utilities/laser_profiles/from_lasy_file.html#fbpic.lpa_utils.laser.FromLasyFileLaser">FromLasyFileLaser (class in fbpic.lpa_utils.laser)</a>
</li>
</ul></td>
</tr></table>
diff --git a/how_to_run.html b/how_to_run.html
index c38bdaa..c4144e5 100644
--- a/how_to_run.html
+++ b/how_to_run.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>How to run the code — FBPIC 0.24.0 documentation</title>
+ <title>How to run the code — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="_static/documentation_options.js?v=a9084e48"></script>
+ <script src="_static/documentation_options.js?v=d8dd0411"></script>
<script src="_static/doctools.js?v=888ff710"></script>
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
diff --git a/index.html b/index.html
index 3d2c307..ca6f8fa 100644
--- a/index.html
+++ b/index.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>FBPIC documentation — FBPIC 0.24.0 documentation</title>
+ <title>FBPIC documentation — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="_static/documentation_options.js?v=a9084e48"></script>
+ <script src="_static/documentation_options.js?v=d8dd0411"></script>
<script src="_static/doctools.js?v=888ff710"></script>
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="_static/js/theme.js"></script>
@@ -32,7 +32,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="search.html" method="get">
@@ -131,7 +131,8 @@ <h2>Research & Attribution<a class="headerlink" href="#research-attribution"
benefitted from the contributions of Soeren Jalas (CFEL), Kevin Peters (CFEL),
Irene Dornmair (CFEL), Laurids Jeppe (CFEL), Igor Andriyash (Laboratoire d’Optique Appliquee),
Omri Seemann (Weizmann Institute), Daniel Seipt (University of Michigan),
-Samuel Yoffe (University of Strathclyde) and David Grote (LLNL and LBNL).</p>
+Samuel Yoffe (University of Strathclyde), David Grote (LLNL and LBNL)
+and Anton Golovanov (Weizmann Institute).</p>
<p>FBPIC’s algorithms are documented in following scientific publications:</p>
<blockquote>
<div><ul class="simple">
diff --git a/install/install_comet.html b/install/install_comet.html
index 4691629..b7fab30 100644
--- a/install/install_comet.html
+++ b/install/install_comet.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Installation on Comet (SDSC) — FBPIC 0.24.0 documentation</title>
+ <title>Installation on Comet (SDSC) — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/install/install_juwels.html b/install/install_juwels.html
index cc778c6..36fb471 100644
--- a/install/install_juwels.html
+++ b/install/install_juwels.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Installation on JUWELS (JSC) — FBPIC 0.24.0 documentation</title>
+ <title>Installation on JUWELS (JSC) — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/install/install_lawrencium.html b/install/install_lawrencium.html
index b3a19c3..7cfd337 100644
--- a/install/install_lawrencium.html
+++ b/install/install_lawrencium.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Installation on Lawrencium (LBNL) — FBPIC 0.24.0 documentation</title>
+ <title>Installation on Lawrencium (LBNL) — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/install/install_local.html b/install/install_local.html
index 7962e70..2528a08 100644
--- a/install/install_local.html
+++ b/install/install_local.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Installation on a local computer — FBPIC 0.24.0 documentation</title>
+ <title>Installation on a local computer — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
@@ -158,6 +158,10 @@ <h2>Potential issues<a class="headerlink" href="#potential-issues" title="Link t
<span class="n">pip</span> <span class="n">install</span> <span class="n">mpi4py</span>
</pre></div>
</div>
+<p>If you are running on an Apple Silicon machine, <cite>mkl</cite> is not available via <cite>conda</cite>. You can use <cite>brew</cite> instead:</p>
+<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">brew</span> <span class="n">install</span> <span class="n">onednn</span>
+</pre></div>
+</div>
</section>
<section id="running-simulations">
<h2>Running simulations<a class="headerlink" href="#running-simulations" title="Link to this heading">¶</a></h2>
diff --git a/install/install_perlmutter.html b/install/install_perlmutter.html
index 906bd5e..a5ea9ac 100644
--- a/install/install_perlmutter.html
+++ b/install/install_perlmutter.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Installation on Perlmutter (NERSC) — FBPIC 0.24.0 documentation</title>
+ <title>Installation on Perlmutter (NERSC) — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/install/install_summit.html b/install/install_summit.html
index 527b0fc..1247d58 100644
--- a/install/install_summit.html
+++ b/install/install_summit.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Installation on Summit (OLCF) — FBPIC 0.24.0 documentation</title>
+ <title>Installation on Summit (OLCF) — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/install/installation.html b/install/installation.html
index 31ffbd1..974b29b 100644
--- a/install/installation.html
+++ b/install/installation.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Installation — FBPIC 0.24.0 documentation</title>
+ <title>Installation — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/objects.inv b/objects.inv
index e38e08e..69986e7 100644
Binary files a/objects.inv and b/objects.inv differ
diff --git a/overview/overview.html b/overview/overview.html
index ba291dd..1a91288 100644
--- a/overview/overview.html
+++ b/overview/overview.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Overview of the code — FBPIC 0.24.0 documentation</title>
+ <title>Overview of the code — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/overview/parallelisation.html b/overview/parallelisation.html
index d9286af..db1de1d 100644
--- a/overview/parallelisation.html
+++ b/overview/parallelisation.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Parallelization of FBPIC — FBPIC 0.24.0 documentation</title>
+ <title>Parallelization of FBPIC — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="../_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/overview/pic_algorithm.html b/overview/pic_algorithm.html
index 96a9791..8f5e054 100644
--- a/overview/pic_algorithm.html
+++ b/overview/pic_algorithm.html
@@ -4,14 +4,14 @@
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.18.1: http://docutils.sourceforge.net/" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>FBPIC algorithm & features — FBPIC 0.24.0 documentation</title>
+ <title>FBPIC algorithm & features — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
<!--[if lt IE 9]>
<script src="../_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="../_static/documentation_options.js?v=a9084e48"></script>
+ <script src="../_static/documentation_options.js?v=d8dd0411"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
<script async="async" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
@@ -34,7 +34,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
diff --git a/search.html b/search.html
index 65fcdbc..c810e18 100644
--- a/search.html
+++ b/search.html
@@ -3,7 +3,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
- <title>Search — FBPIC 0.24.0 documentation</title>
+ <title>Search — FBPIC 0.25.0 documentation</title>
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="_static/css/theme.css" type="text/css" />
@@ -11,7 +11,7 @@
<script src="_static/js/html5shiv.min.js"></script>
<![endif]-->
- <script src="_static/documentation_options.js?v=a9084e48"></script>
+ <script src="_static/documentation_options.js?v=d8dd0411"></script>
<script src="_static/doctools.js?v=888ff710"></script>
<script src="_static/sphinx_highlight.js?v=dc90522c"></script>
<script src="_static/js/theme.js"></script>
@@ -33,7 +33,7 @@
FBPIC
</a>
<div class="version">
- 0.24.0
+ 0.25.0
</div>
<div role="search">
<form id="rtd-search-form" class="wy-form" action="#" method="get">
diff --git a/searchindex.js b/searchindex.js
index 32c30b9..d85d238 100644
--- a/searchindex.js
+++ b/searchindex.js
@@ -1 +1 @@
-Search.setIndex({"docnames": ["advanced/3d_visualization", "advanced/advanced", "advanced/boosted_frame", "advanced/parameter_scans", "advanced/profiling", "api_reference/api_reference", "api_reference/boost_converter", "api_reference/checkpoint_restart", "api_reference/diagnostics", "api_reference/lpa_utilities/beam", "api_reference/lpa_utilities/external_fields", "api_reference/lpa_utilities/laser", "api_reference/lpa_utilities/laser_profiles/donut_laguerre", "api_reference/lpa_utilities/laser_profiles/few_cycle", "api_reference/lpa_utilities/laser_profiles/flattened", "api_reference/lpa_utilities/laser_profiles/gaussian", "api_reference/lpa_utilities/laser_profiles/laguerre", "api_reference/lpa_utilities/lpa_utilities", "api_reference/particles", "api_reference/simulation", "api_reference/smoothing", "example_input/boosted_frame_script", "example_input/ionization_script", "example_input/lwfa_script", "how_to_run", "index", "install/install_comet", "install/install_juwels", "install/install_lawrencium", "install/install_local", "install/install_perlmutter", "install/install_summit", "install/installation", "overview/overview", "overview/parallelisation", "overview/pic_algorithm"], "filenames": ["advanced/3d_visualization.rst", "advanced/advanced.rst", "advanced/boosted_frame.rst", "advanced/parameter_scans.rst", "advanced/profiling.rst", "api_reference/api_reference.rst", "api_reference/boost_converter.rst", "api_reference/checkpoint_restart.rst", "api_reference/diagnostics.rst", "api_reference/lpa_utilities/beam.rst", "api_reference/lpa_utilities/external_fields.rst", "api_reference/lpa_utilities/laser.rst", "api_reference/lpa_utilities/laser_profiles/donut_laguerre.rst", "api_reference/lpa_utilities/laser_profiles/few_cycle.rst", "api_reference/lpa_utilities/laser_profiles/flattened.rst", "api_reference/lpa_utilities/laser_profiles/gaussian.rst", "api_reference/lpa_utilities/laser_profiles/laguerre.rst", "api_reference/lpa_utilities/lpa_utilities.rst", "api_reference/particles.rst", "api_reference/simulation.rst", "api_reference/smoothing.rst", "example_input/boosted_frame_script.rst", "example_input/ionization_script.rst", "example_input/lwfa_script.rst", "how_to_run.rst", "index.rst", "install/install_comet.rst", "install/install_juwels.rst", "install/install_lawrencium.rst", "install/install_local.rst", "install/install_perlmutter.rst", "install/install_summit.rst", "install/installation.rst", "overview/overview.rst", "overview/parallelisation.rst", "overview/pic_algorithm.rst"], "titles": ["3D visualization using PyVista", "Advanced use", "Running boosted-frame simulations", "Performing parameter scans in parallel", "Profiling the code", "API reference", "Conversion to boosted-frame", "Checkpoints and restarts", "The openPMD diagnostics", "Beam initialization", "External fields", "Laser initialization", "Donut-like Laguerre-Gauss profile", "Few-cycle profile", "Flattened Gaussian profile", "Gaussian profile", "Laguerre-Gauss profile", "Laser-plasma utilities", "The Particles class", "The Simulation class", "Field smoothing", "Boosted-frame simulation of laser-wakefield acceleration", "Laser-wakefield acceleration with ionization", "Standard simulation of laser-wakefield acceleration", "How to run the code", "FBPIC documentation", "Installation on Comet (SDSC)", "Installation on JUWELS (JSC)", "Installation on Lawrencium (LBNL)", "Installation on a local computer", "Installation on Perlmutter (NERSC)", "Installation on Summit (OLCF)", "Installation", "Overview of the code", "Parallelization of FBPIC", "FBPIC algorithm & features"], "terms": {"The": [0, 2, 4, 5, 6, 7, 9, 10, 11, 12, 13, 14, 15, 16, 21, 22, 23, 24, 25, 27, 29, 33, 34], "python": [0, 3, 4, 11, 21, 22, 23, 24, 26, 27, 28, 29, 30, 31], "packag": [0, 5, 24, 27, 29, 30, 34], "can": [0, 1, 2, 3, 4, 7, 8, 9, 10, 11, 18, 19, 21, 22, 23, 24, 25, 27, 28, 29, 34, 35], "easili": [0, 17], "produc": [0, 2, 7, 8, 35], "output": [0, 2, 4, 8, 19, 24, 27, 35], "data": [0, 2, 4, 7, 8, 19, 24], "instal": [0, 4, 24, 25], "openpmd": [0, 5, 7, 9, 18, 24, 28], "viewer": [0, 24, 28], "pip": [0, 24, 26, 27, 28, 29, 30, 31], "For": [0, 2, 4, 7, 9, 10, 11, 12, 14, 16, 19, 25, 26, 27, 28, 32, 34, 35], "simpl": [0, 2, 9], "static": [0, 2, 6], "you": [0, 1, 2, 4, 5, 9, 11, 18, 19, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 34, 35], "follow": [0, 2, 4, 7, 9, 11, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34], "code": [0, 1, 2, 9, 11, 12, 13, 14, 15, 16, 19, 21, 23, 25, 29, 34, 35], "an": [0, 2, 3, 6, 8, 9, 10, 11, 12, 14, 16, 18, 19, 20, 21, 22, 24, 26, 27, 28, 29, 33, 34, 35], "exampl": [0, 2, 3, 4, 10, 11, 27], "from": [0, 1, 4, 6, 7, 8, 9, 11, 12, 14, 15, 16, 18, 19, 21, 22, 23, 25, 27, 29, 34, 35], "openpmd_view": 0, "import": [0, 2, 4, 11, 21, 22, 23, 24, 27, 33, 35], "openpmdtimeseri": 0, "open": [0, 4, 19, 21, 22, 23, 25, 27, 28], "simul": [0, 1, 3, 5, 9, 10, 11, 12, 16, 17, 18, 22, 25, 34, 35], "t": [0, 2, 8, 10, 11, 12, 13, 14, 15, 16, 19, 21, 26, 30, 35], "sim_output": 0, "diag": [0, 2, 8, 21, 22, 23], "hdf5": [0, 9, 24], "creat": [0, 4, 8, 18, 19, 21, 22, 23, 24, 26, 28, 30, 31], "plotter": 0, "set_background": 0, "white": 0, "retriev": [0, 8], "rho": [0, 8, 19, 21, 22], "field": [0, 2, 5, 7, 9, 11, 12, 13, 15, 16, 17, 18, 19, 21, 22, 23, 24, 25, 34, 35], "theta": [0, 9, 12, 14, 16, 19, 21, 22, 23, 35], "none": [0, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 21, 23], "argument": [0, 2, 10, 19], "construct": 0, "cartesian": [0, 35], "grid": [0, 8, 9, 10, 11, 19, 34], "cylindr": [0, 19, 25], "meta": 0, "get_field": 0, "iter": [0, 4, 7, 8, 9, 19, 21, 22, 23, 34], "1": [0, 2, 4, 6, 8, 9, 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 27, 28, 30, 31, 35], "which": [0, 2, 4, 5, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 24, 29, 34, 35], "deposit": [0, 19, 34, 35], "uniformgrid": 0, "dimens": 0, "shape": [0, 10, 19], "origin": [0, 2, 7, 25, 35], "xmin": 0, "1e6": 0, "ymin": 0, "zmin": [0, 19, 21, 22, 23], "space": [0, 2, 8, 9, 11, 17, 19, 25, 34], "dx": 0, "dy": 0, "dz": 0, "point_data": 0, "valu": [0, 2, 3, 7, 8, 10, 11, 18, 19, 26, 28, 30, 31, 35], "flatten": [0, 11], "order": [0, 2, 3, 4, 6, 10, 11, 12, 14, 16, 19, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 35], "f": [0, 10, 12, 16], "add": [0, 4, 9, 17, 19, 21, 22, 23, 27, 28], "cutoff": 0, "via": [0, 27, 28, 34], "clim": 0, "sinc": [0, 2, 3, 7, 22, 26], "otherwis": [0, 8, 9, 19], "show": [0, 2, 19, 24], "onli": [0, 2, 3, 4, 8, 9, 11, 13, 19, 21, 23, 24, 27, 31, 34, 35], "small": [0, 4, 11, 19, 34], "densiti": [0, 2, 6, 9, 19, 21, 22, 23, 34, 35], "spike": 0, "add_volum": 0, "0": [0, 2, 6, 8, 9, 11, 12, 13, 14, 15, 16, 18, 19, 21, 22, 23, 27, 28, 29, 30, 31, 35], "4e6": 0, "opac": 0, "sigmoid": 0, "cmap": 0, "viridi": 0, "mapper": 0, "gpu": [0, 3, 10, 19, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 34], "show_scalar_bar": 0, "fals": [0, 2, 3, 9, 19, 20, 21, 22, 23, 30], "A": [0, 6, 8, 9, 18, 19, 21, 22, 23, 29, 30, 34], "good": [0, 2, 7, 19, 21, 22, 23], "start": [0, 7, 18, 25, 26, 27, 28], "camera": 0, "posit": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 19, 21, 22, 23], "three": 0, "ar": [0, 2, 4, 5, 7, 8, 9, 10, 11, 12, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 30, 34, 35], "focu": [0, 9, 11, 13, 14, 15], "up": [0, 2, 5, 7, 21, 22, 24], "vector": [0, 11, 13, 14, 15], "viewport": 0, "camera_posit": 0, "74": 0, "32": [0, 19, 21, 22, 23, 24, 34], "51": 0, "88": 0, "lwfa": 0, "thi": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34, 35], "section": [1, 2, 5, 11, 17, 21, 24, 25, 26, 29, 32, 33, 34], "contain": [1, 2, 3, 4, 6, 7, 8, 9, 10, 11, 13, 18, 19, 22, 27], "sever": [1, 3, 6, 7, 18, 25, 35], "tip": 1, "help": [1, 19, 21, 22, 23], "get": [1, 25, 34], "more": [1, 2, 4, 7, 9, 11, 12, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 34, 35], "perform": [1, 2, 19, 21, 22, 23, 27, 30, 34, 35], "faster": [1, 19, 24, 25, 28, 34, 35], "result": [1, 8, 19, 20, 34], "topic": [1, 33], "profil": [1, 21, 22, 23], "paramet": [1, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 34], "scan": [1, 19, 34], "parallel": [1, 19, 25, 33], "run": [1, 3, 4, 7, 10, 19, 21, 22, 23, 25, 34, 35], "boost": [1, 5, 9, 10, 11, 18, 19, 24, 25], "frame": [1, 5, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 24, 25], "3d": [1, 24, 35], "visual": 1, "pyvista": [1, 24], "page": [2, 4, 11, 25, 28, 32], "give": [2, 19, 33], "quick": 2, "overview": [2, 25], "speed": [2, 8, 19, 22, 23], "certain": 2, "type": [2, 4, 6, 11, 19, 21, 22, 23, 24, 26, 27, 28, 29, 30, 31], "magnitud": [2, 35], "after": [2, 10, 11, 19, 27, 34], "explain": [2, 11, 27, 32], "case": [2, 3, 4, 7, 8, 9, 11, 13, 18, 19, 34, 35], "laser": [2, 3, 5, 6, 7, 12, 13, 14, 15, 16, 18, 24, 25, 34, 35], "wakefield": [2, 16, 17, 24, 25, 35], "acceler": [2, 17, 19, 24, 25, 34, 35], "discuss": 2, "how": [2, 3, 11, 19, 25, 26, 27, 29, 32, 33, 34], "handl": [2, 34], "most": [2, 25, 34], "aspect": 2, "fbpic": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 32, 33], "us": [2, 3, 5, 6, 7, 8, 9, 10, 11, 14, 18, 19, 21, 22, 23, 24, 25, 27, 28, 29, 31, 32, 33, 34, 35], "understand": [2, 25], "instead": [2, 3, 8, 9, 10, 13, 18, 24, 27, 29, 34, 35], "refer": [2, 18, 24, 25], "laboratori": 2, "short": [2, 13, 19, 33], "consist": [2, 4, 9, 10, 11, 17, 27, 34, 35], "differ": [2, 3, 8, 13, 18, 24, 32, 34, 35], "lorentz": [2, 6, 8, 9, 10, 11, 19], "move": [2, 6, 7, 8, 11, 19, 21, 22, 23, 25], "same": [2, 3, 4, 6, 7, 12, 16, 18, 19, 20, 24, 26, 28, 30, 31, 34, 35], "direct": [2, 9, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 27, 34, 35], "i": [2, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 35], "character": 2, "its": [2, 8, 9, 11, 15, 17, 18, 19, 25, 34], "factor": [2, 6, 8, 9, 10, 11, 19], "gamma_b": 2, "when": [2, 4, 7, 9, 10, 11, 12, 13, 15, 16, 19, 21, 23, 24, 26, 27, 31, 34, 35], "chang": [2, 8, 21, 28], "time": [2, 4, 6, 7, 8, 9, 10, 11, 12, 13, 15, 16, 18, 21, 22, 23, 26, 27, 28, 30, 34], "computation": [2, 21, 22, 23, 34], "favor": 2, "In": [2, 3, 4, 7, 9, 10, 11, 12, 13, 16, 18, 19, 24, 25, 26, 27, 28, 29, 30, 31, 33, 34, 35], "stretch": 2, "ha": [2, 6, 8, 9, 10, 12, 16, 19, 26, 27, 28, 31, 34, 35], "lower": [2, 34], "frequenc": [2, 11, 13, 15, 20, 34], "allow": [2, 4, 9, 10, 11, 17, 19, 21, 35], "loop": [2, 7, 10], "larger": [2, 22, 35], "step": [2, 4, 10, 19, 21, 22, 23, 26, 27, 29, 35], "cell": [2, 8, 9, 19, 21, 22, 23, 25, 28, 34, 35], "size": [2, 7, 9, 14, 24, 34], "z": [2, 6, 9, 10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 34, 35], "than": [2, 7, 19, 20, 22, 24, 25, 34], "while": [2, 3, 27, 35], "still": [2, 8, 9, 34], "resolv": [2, 12, 16, 19, 35], "precis": [2, 7, 8, 11, 12, 14, 15, 16, 19, 22, 35], "delta": [2, 11, 15, 35], "z_": [2, 14], "approx": [2, 19], "2": [2, 4, 6, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 21, 22, 23, 24, 26, 27, 28, 34, 35], "t_": 2, "plasma": [2, 5, 6, 16, 19, 21, 22, 23, 25, 34, 35], "shorter": 2, "relativist": [2, 9, 17, 21, 25, 35], "toward": [2, 12, 13, 14, 15, 16], "impli": [2, 35], "need": [2, 4, 7, 8, 10, 21, 22, 23, 24, 27, 28, 29, 31], "propag": [2, 6, 9, 11, 12, 13, 14, 15, 16, 34, 35], "through": [2, 11, 25, 29], "similarli": [2, 34], "These": [2, 8, 34, 35], "repres": [2, 18, 19, 35], "below": [2, 5, 8, 9, 10, 12, 16, 17, 18, 19, 21, 22, 23, 24, 26, 32, 34, 35], "On": [2, 3, 24, 29], "whole": [2, 19], "take": [2, 6, 9, 19, 21, 22, 23, 27, 34, 35], "account": [2, 6, 9, 11, 12, 15, 16, 19, 31, 35], "longer": [2, 18, 22, 23], "timestep": [2, 8, 10, 17, 19, 21, 22, 23, 35], "requir": [2, 7, 11, 12, 16, 18, 19, 21, 22, 23, 24, 27, 29, 34, 35], "reduc": [2, 24, 34], "n_": 2, "frac": [2, 11, 12, 13, 14, 15, 16], "beta_b": 2, "howev": [2, 3, 10, 11, 34, 35], "abov": [2, 6, 8, 9, 10, 11, 12, 13, 14, 15, 16, 19, 22, 24, 26, 27, 28, 29, 31, 34, 35], "formula": [2, 6, 11, 12, 13, 14, 15, 16], "approxim": [2, 34], "calcul": [2, 6, 9, 19, 21, 22, 23, 25], "correct": [2, 19, 27, 34], "practic": [2, 34, 35], "see": [2, 4, 5, 8, 10, 12, 13, 14, 16, 17, 19, 21, 22, 23, 24, 25, 26, 28, 29, 34, 35], "note": [2, 10, 11, 18, 19, 24, 27, 31, 34], "also": [2, 11, 18, 19, 21, 22, 23, 24, 25, 27, 29, 31, 34, 35], "theori": 2, "optim": 2, "close": [2, 14, 19, 25, 35], "gamma_": 2, "wake": 2, "e": [2, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 21, 22, 23, 24, 27, 29, 31, 34, 35], "associ": [2, 22], "phase": [2, 9, 11, 12, 13, 14, 15, 16], "veloc": [2, 6, 11, 21], "group": [2, 21], "puls": [2, 12, 13, 14, 15, 16, 17], "setup": [2, 4, 19, 24, 27], "due": [2, 11, 34, 35], "limit": [2, 13, 18, 19, 24, 25, 34, 35], "spatial": [2, 34, 35], "tempor": [2, 11, 15], "detail": [2, 4, 11, 19, 35], "gener": [2, 9, 19, 25, 32, 34, 35], "paper": [2, 25, 35], "read": [2, 14, 24, 25, 32, 33], "descript": [2, 25], "speedup": 2, "higher": [2, 34, 35], "becaus": [2, 7, 8, 10, 13, 34, 35], "each": [2, 3, 4, 7, 8, 9, 10, 11, 17, 18, 19, 20, 24, 27, 28, 31, 34, 35], "macroparticl": [2, 6, 9, 18, 19, 21, 22, 35], "typic": [2, 6, 18, 19, 21, 22, 23, 28, 30, 34, 35], "particl": [2, 5, 6, 7, 9, 10, 17, 19, 21, 22, 23, 24, 25, 34, 35], "least": [2, 19, 25], "keep": 2, "per": [2, 3, 4, 6, 7, 8, 9, 11, 19, 21, 22, 23, 24, 26, 27, 28, 30, 31, 34, 35], "self": [2, 9, 10, 11, 17, 30, 35], "inject": [2, 7, 17, 19, 35], "less": [2, 19, 34, 35], "beam": [2, 12, 16, 17, 19, 34, 35], "therefor": [2, 3, 4, 17, 24, 34], "statist": 2, "evalu": [2, 18, 35], "g": [2, 3, 4, 6, 7, 8, 9, 11, 16, 17, 18, 19, 24, 27, 29, 31, 34, 35], "emitt": [2, 9, 35], "charg": [2, 8, 9, 17, 18, 19, 22, 25, 34, 35], "extrem": 2, "compar": [2, 25, 35], "total": [2, 6, 8, 12, 16], "mai": [2, 3, 8, 16, 18, 35], "occur": [2, 34], "all": [2, 3, 6, 7, 8, 9, 10, 11, 18, 19, 21, 22, 23, 24, 26, 35], "involv": 2, "occasion": 2, "make": [2, 3, 8, 18, 19, 21, 22, 23, 25, 31, 35], "sure": [2, 3, 8, 19, 31, 35], "properli": [2, 12, 16, 19, 33], "converg": 2, "ion": [2, 18, 19, 21, 22], "essenti": 2, "motionless": 2, "current": [2, 7, 8, 18, 19, 34, 35], "boldsymbol": [2, 11, 12, 13, 14, 15, 16], "j": [2, 8, 14, 26, 28, 30, 31], "thei": [2, 24, 34, 35], "neglig": [2, 34], "electron": [2, 6, 8, 9, 17, 18, 19, 21, 22, 23, 35], "reason": [2, 7], "algorithm": [2, 4, 25, 33, 34], "updat": [2, 9, 11, 34], "featur": [2, 3, 10, 24, 25, 33], "often": [2, 7], "omit": 2, "save": [2, 7, 9, 22], "comput": [2, 3, 4, 18, 19, 22, 24, 30, 31, 32, 34, 35], "And": [2, 4, 24], "fact": [2, 13, 31, 35], "initialize_ion": [2, 19], "set": [2, 3, 4, 5, 9, 10, 11, 18, 19, 22, 24, 27, 29, 34, 35], "default": [2, 8, 9, 11, 12, 13, 14, 15, 16, 19, 24, 29, 34], "valid": [2, 11, 18], "do": [2, 4, 11, 18, 24, 29], "non": [2, 16, 35], "includ": [2, 4, 8, 11, 12, 15, 16, 25, 35], "them": [2, 6, 11, 19, 33, 34, 35], "either": [2, 8, 9, 10, 11, 12, 13, 14, 15, 16, 19, 24, 34], "flag": [2, 19], "true": [2, 4, 9, 11, 19, 21, 22, 23, 34], "ad": [2, 8, 9, 10, 11, 19, 34], "separ": [2, 3, 18, 34], "add_new_speci": [2, 18, 19, 21, 22, 23, 35], "wavelength": [2, 11, 12, 13, 14, 15, 16, 21], "etc": [2, 7, 9, 11, 19], "known": 2, "correspond": [2, 4, 6, 8, 9, 10, 11, 15, 17, 18, 19, 22, 23], "fortun": 2, "function": [2, 5, 7, 9, 10, 17, 18, 19, 21, 22, 23, 24, 35], "class": [2, 5, 6, 8, 10, 12, 13, 14, 15, 16, 17, 20], "convers": [2, 5, 10, 21], "automat": [2, 9, 10, 11, 19], "so": [2, 7, 10, 11, 12, 13, 16, 18, 19, 24, 25, 29, 34], "user": [2, 4, 8, 10, 21, 24, 26, 28, 34, 35], "pass": [2, 18, 19, 20, 34], "along": [2, 9, 10, 19, 21, 22, 23, 35], "instanc": [2, 10, 11, 18, 19, 24, 31, 35], "main": [2, 5, 19, 21, 22, 23, 25, 29], "box": [2, 7, 11, 19, 21, 22, 23, 34], "pleas": [2, 10, 24, 25, 31, 34], "look": [2, 5, 11], "document": [2, 8, 12, 16, 17, 21, 22, 23, 24], "api": [2, 24, 25], "support": [2, 8, 9, 11, 24, 25], "If": [2, 4, 5, 7, 8, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 24, 25, 27, 29], "lpa_util": [2, 6, 9, 10, 11, 12, 13, 14, 15, 16, 21, 22, 23], "boosted_fram": [2, 6, 21], "boostconvert": [2, 6, 9, 21], "implement": [2, 11, 18, 21, 22, 23, 24, 25, 27, 34], "common": [2, 34, 35], "quantiti": [2, 6, 8, 11, 19], "addition": 2, "provid": [2, 3, 8, 11, 12, 13, 14, 15, 16, 17, 26, 28], "method": [2, 9, 11, 18, 19, 21, 34], "script": [2, 3, 4, 7, 11, 19, 21, 22, 23, 26, 27, 28, 30, 31], "although": [2, 8, 9, 34, 35], "desir": 2, "have": [2, 4, 7, 8, 9, 10, 11, 18, 19, 21, 22, 23, 25, 34, 35], "usual": [2, 4, 11], "easier": 2, "interpret": 2, "fly": [2, 8], "thu": [2, 9, 10, 11, 13, 15, 18, 24, 35], "directli": [2, 4, 8, 11, 18, 19, 27], "openpmd_diag": [2, 7, 8, 21, 22, 23], "backtransformedfielddiagnost": [2, 8, 21], "backtransformedparticlediagnost": [2, 8, 21], "regular": [2, 7, 34], "fielddiagnost": [2, 8, 21, 22, 23], "particlediagnost": [2, 8, 21, 22, 23], "diagnost": [2, 5, 7, 21, 22, 23, 35], "By": [2, 8, 9, 10, 19, 35], "store": [2, 7, 18, 22], "folder": [2, 4, 19, 27], "lab_diag": 2, "raw": 2, "simultan": [2, 4, 34], "between": [2, 3, 7, 8, 9, 19, 21, 24, 27, 34], "file": [2, 7, 8, 9, 18, 22, 23, 24, 26, 28, 30, 31], "fill": [2, 7], "progress": [2, 11, 19], "right": [2, 8, 11, 12, 13, 14, 15, 16, 19, 22, 23], "hand": [2, 7], "side": [2, 4, 11], "left": [2, 3, 8, 11, 12, 13, 14, 15, 16, 19, 22, 23, 34], "chosen": [2, 18, 35], "insuffici": 2, "some": [2, 3, 8, 11, 24], "incomplet": 2, "being": [2, 6, 10, 28], "zero": 2, "potenti": [2, 10, 11, 13, 14, 15, 34], "affect": [2, 19], "degrad": 2, "suppress": [2, 21], "galilean": [2, 19, 21, 25], "here": [2, 3, 4, 11, 25, 27, 28, 29, 35], "inform": [2, 4, 7, 8, 18, 19, 21, 22, 23, 24, 25, 26, 27, 28, 34], "simpli": [2, 4], "v_comov": [2, 19, 21], "v_": 2, "comov": [2, 19], "c": [2, 6, 11, 12, 13, 14, 15, 16, 21, 22, 23, 24, 26, 28, 29, 30, 31, 35], "sqrt": [2, 6, 11, 12, 13, 16, 21], "again": [2, 7, 28], "effect": [2, 6, 9, 19, 34, 35], "where": [2, 3, 4, 8, 9, 11, 12, 13, 14, 15, 16, 19, 21, 22, 23, 24, 26, 28, 30, 31, 35], "r_": 2, "term": [2, 11, 12, 15, 16, 34], "condit": 2, "met": 2, "our": 2, "knowledg": 2, "exist": [2, 4, 7, 11], "solut": 2, "doe": [2, 4, 9, 10, 16, 22, 25, 34, 35], "check": [2, 27, 34], "whether": [2, 9, 11, 19, 20, 21, 22, 23, 26], "given": [2, 4, 7, 9, 11, 12, 13, 15, 16, 19], "respons": [2, 16, 34], "ensur": [2, 9, 19, 34], "we": [2, 4, 8, 9, 10, 25, 34], "interact": [2, 6, 21, 22, 23, 27, 35], "defin": [2, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 21, 24, 35], "window": [2, 6, 7, 8, 11, 19, 21, 22, 23, 25], "length": [2, 6, 9, 13, 21, 22, 23], "l_": 2, "cross": [2, 19, 34], "beta_": 2, "would": [2, 34], "consequ": 2, "those": 2, "new": [2, 7, 9, 11, 18, 19, 22, 25, 30, 31], "gamma": [2, 6, 8], "beta": 2, "expos": 2, "interaction_tim": [2, 6, 21], "slide": [2, 6, 21, 22, 23], "across": [2, 6, 21, 22, 23, 24, 34], "initi": [2, 6, 7, 8, 10, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 35], "addit": [2, 11, 12, 15, 16, 19, 24, 25, 29], "access": [2, 4, 5, 21, 22, 23, 25, 28, 34], "sim": [2, 4, 7, 8, 9, 10, 11, 21, 22, 23, 35], "dt": [2, 19, 21, 22, 23], "figur": 2, "expect": [2, 13, 27], "reduct": 2, "let": 2, "assum": [2, 6, 11, 12, 13, 14, 15, 16, 19, 22], "100": [2, 21, 22, 23], "mu": 2, "m": [2, 4, 8, 9, 11, 12, 14, 16, 19, 21, 22, 23, 25, 29, 30, 35], "12": [2, 24, 28], "mm": 2, "10": [2, 8, 9, 19, 21, 22, 23, 27, 28], "24": [2, 27, 28], "3": [2, 9, 11, 19, 21, 23, 27, 28, 31, 35], "match": [2, 19, 34], "42": 2, "highlight": 2, "two": [2, 4, 8, 11, 19, 27, 28, 33], "choos": [2, 29, 35], "first": [2, 4, 8, 11, 19, 21, 24, 25, 29, 31], "seen": 2, "scale": [2, 24, 34, 35], "law": 2, "ll": 2, "second": [2, 6, 8, 9, 11, 12, 13, 14, 15, 16, 19, 21, 22, 23], "optimum": 2, "befor": [2, 7, 8, 19, 22, 23, 24, 28, 31], "slow": [2, 8], "down": [2, 8, 21], "As": [2, 19, 24, 27, 34, 35], "minim": [2, 9, 19, 34], "revers": 2, "too": [2, 11, 34], "high": [2, 19, 30, 34], "advis": [2, 27], "fulfil": 2, "maximum": [2, 11, 12, 13, 14, 15, 16, 18, 19], "effici": [2, 3, 34, 35], "next": [2, 4, 34], "basic": [2, 19, 25, 33], "been": [2, 8, 9, 19, 26, 28], "cover": 2, "alreadi": [2, 22], "previou": [2, 22, 23], "tricki": 2, "restrict": 2, "ourselv": 2, "homogen": 2, "fundament": 2, "lambda_": 2, "l": [2, 6, 12, 14, 16], "p": [2, 11, 12, 16, 26, 27, 28, 31], "period": [2, 7, 8, 10, 18, 19, 21, 22, 23], "oscil": [2, 11, 12, 13, 14, 15, 16], "tau_": [2, 13], "final": [2, 8, 11, 27], "itself": 2, "normal": [2, 6, 9, 11, 13, 14, 15, 19, 27], "low": [2, 20], "equal": 2, "increas": [2, 12, 14, 16, 19, 22, 23, 24, 35], "propto": [2, 14], "contract": 2, "wave": [2, 11, 12, 15, 16, 19, 21, 22, 23, 34, 35], "becom": [2, 4, 13, 24, 34], "appar": 2, "supra": 2, "lumin": 2, "sub": [2, 34], "critic": 2, "discrep": 2, "both": [2, 4, 11, 25, 26, 34], "caus": [2, 29, 34], "diverg": [2, 19], "approach": [2, 13], "longitudin": [2, 9, 19, 34], "shown": [2, 34], "decreas": [2, 34, 35], "well": [2, 13, 18, 25, 34], "gtrsim": 2, "should": [2, 4, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20, 21, 24, 26, 27, 28, 29, 31, 34, 35], "alwai": [2, 7, 8, 9, 11], "much": [2, 25, 34], "smaller": [2, 34], "satisfi": [2, 11, 19], "cluster": [3, 4, 7, 26, 28, 30, 31, 32], "singl": [3, 18, 19, 21, 22, 23, 24, 27, 34], "node": [3, 24, 26, 27, 28, 30, 31, 34], "sometim": [3, 9, 24, 27, 29, 34, 35], "pic": [3, 4, 7, 10, 19, 22, 23, 25, 34], "part": [3, 4, 11, 15, 19], "intens": [3, 11, 12, 13, 14, 15, 16], "launch": [3, 4, 19, 31, 34], "possibl": [3, 8, 19, 24], "other": [3, 7, 8, 9, 11, 19, 25, 30, 32, 34, 35], "idl": 3, "command": [3, 4, 24, 27, 29], "mpirun": [3, 4, 19, 24, 28], "wherebi": 3, "mpi": [3, 7, 19, 21, 22, 23, 24, 26, 27, 29, 31, 34], "rank": [3, 4, 7, 8, 19, 31], "activ": [3, 18, 19, 22, 24, 27, 28, 30, 31], "use_all_mpi_rank": [3, 19], "object": [3, 5, 6, 7, 8, 9, 10, 11, 18, 19, 21, 22, 23, 24, 25, 34], "instruct": [3, 4, 24, 28, 29, 32], "one": [3, 4, 7, 8, 9, 11, 13, 16, 19, 21, 24, 27, 28, 31, 34, 35], "structur": [3, 9, 11, 21, 22, 23], "input": [3, 7, 11, 19, 21, 22, 23, 26, 28, 30, 31], "specifi": [3, 7, 8, 10, 19], "vari": [3, 12, 16, 35], "parametric_script": 3, "py": [3, 4, 21, 22, 23, 24, 26, 27, 28, 30, 31], "find": [4, 29], "domin": [4, 35], "your": [4, 19, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 35], "particular": [4, 13, 19, 32], "dump": 4, "quickli": 4, "cprofil": 4, "": [4, 8, 10, 13, 24, 25, 26, 34, 35], "fbpic_script": [4, 24, 26, 28, 30, 31], "log": [4, 13, 28, 31, 35], "editor": 4, "analysi": [4, 35], "graphic": 4, "interfac": [4, 29, 34], "binari": [4, 30], "o": [4, 24, 28], "prof": 4, "snakeviz": 4, "tool": 4, "nvprof": 4, "nsight": 4, "system": [4, 24, 28, 30, 35], "standard": [4, 13, 19, 24, 27, 34, 35], "nsy": 4, "stat": 4, "print": [4, 19, 21, 22, 23], "termin": [4, 21, 22, 23], "devic": [4, 24, 27], "host": [4, 25], "nvvp": 4, "click": [4, 21, 22, 23], "select": [4, 8, 9, 21, 23, 24, 29, 34], "sy": 4, "navig": 4, "ran": 4, "end": [4, 7, 9, 11, 22, 23], "qdrep": 4, "machin": [4, 24], "wa": [4, 17, 25, 27], "mean": [4, 9, 19, 27, 35], "remot": 4, "transfer": [4, 34], "local": [4, 19, 28, 32, 34], "cuda": [4, 19, 24, 29, 30, 31], "toolkit": 4, "veri": [4, 7, 25, 35], "larg": [4, 19, 21, 22, 23, 25, 34, 35], "recommend": [4, 8, 9, 18, 19, 25, 34], "number": [4, 6, 7, 8, 9, 12, 14, 16, 18, 19, 20, 21, 22, 23, 24, 31, 34, 35], "1000": [4, 35], "One": [4, 6, 11], "wai": [4, 9, 11, 13, 19], "write": [4, 8, 21, 22, 23], "process": [4, 7, 18, 24, 27, 34], "modifi": [4, 7, 10, 11, 19, 21, 22, 23, 24], "line": [4, 28, 30], "begin": [4, 7, 21, 22, 23, 24, 25], "mpi4pi": [4, 24, 26, 27, 28, 29, 30, 34], "comm_world": 4, "comm": [4, 8, 18, 21, 22, 23], "replac": [4, 24, 26, 28, 29, 30, 31], "n_step": [4, 21, 22, 23], "just": 4, "compil": [4, 10], "pr": 4, "enabl": [4, 24, 27], "disabl": [4, 24], "dump_stat": 4, "cpu_": 4, "d": [4, 25], "txt": 4, "w": [4, 9, 14, 31, 35], "output_fil": 4, "stdout": 4, "print_stat": 4, "sort": 4, "__stdout__": 4, "Then": [4, 26, 27, 28, 29, 30, 31], "4": [4, 8, 9, 13, 19, 21, 22, 23, 24, 26, 27, 28, 30, 34], "np": [4, 10, 21, 22, 23, 28], "gpu_": 4, "q": [4, 9, 13, 19, 21, 22, 23], "name": [4, 8, 9, 11, 15, 24, 26, 28, 30, 31], "depend": [4, 12, 16, 19, 24, 27, 29, 34], "distribut": [4, 6, 9, 14, 19, 24, 29], "openmpi": [4, 26, 29], "ompi_comm_world_rank": 4, "mpich": [4, 27, 28], "pmi_rank": 4, "unsur": 4, "printenv": 4, "grep": 4, "load": [4, 7, 9, 22, 23, 26, 28, 30, 31], "timelin": 4, "within": [4, 8, 10, 13, 19, 24, 26, 28, 30, 31, 34], "multipl": [4, 19, 21, 22, 23, 24, 34], "brows": 4, "describ": [5, 11, 26, 34], "checkpoint": [5, 22, 23], "restart": [5, 22, 23], "util": [5, 19, 22], "smooth": [5, 19], "specif": [5, 8, 17, 32], "index": 5, "search": 5, "bar": [5, 19], "websit": 5, "gamma0": [6, 9, 21], "sourc": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 19, 20, 25, 28, 29, 30, 31], "float": [6, 8, 9, 10, 11, 12, 13, 14, 15, 16, 19, 21], "boost_particle_arrai": 6, "x": [6, 8, 9, 10, 11, 12, 13, 14, 15, 16, 19, 21, 27], "y": [6, 9, 10, 19, 21, 27], "ux": [6, 8, 9], "ui": [6, 9], "uz": [6, 8, 9, 21, 23], "inv_gamma": 6, "transform": [6, 9, 19, 21, 35], "fix": [6, 19], "t_boost": 6, "without": [6, 7, 18, 24, 34], "ani": [6, 7, 19, 21, 22, 23, 31, 35], "electromagnet": [6, 19, 21, 22, 23, 34, 35], "bunch": [6, 9, 21, 25], "1darrai": [6, 21], "meter": [6, 8, 9, 11, 12, 13, 14, 15, 16, 19, 21, 22, 23], "lab": [6, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 21, 25, 28], "element": [6, 18, 21], "dimensionless": [6, 9, 11, 12, 13, 14, 15, 16, 19], "momenta": [6, 9, 19], "invers": [6, 34], "return": [6, 9, 10, 18, 19, 21, 22, 23], "arrai": [6, 7, 9, 10, 18, 19, 21, 24], "copropag_dens": 6, "lab_frame_var": 6, "beta_object": 6, "convert": [6, 10, 11, 19, 21], "list": [6, 7, 8, 10, 11, 18, 19, 25], "copropag": [6, 35], "n": [6, 9, 14, 18, 19, 21, 22, 23, 24, 26, 30, 31], "beta0": 6, "option": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 29], "whose": 6, "copropag_length": 6, "warn": 6, "transvers": [6, 9, 12, 14, 16, 19, 21], "motion": [6, 9], "l_interact": [6, 21, 22, 23], "l_window": 6, "v_window": [6, 21, 22, 23], "onc": [6, 24, 26, 28], "v_plasma": 6, "t_interact": [6, 21, 22, 23], "longitudinal_momentum": 6, "u_z": 6, "static_dens": 6, "static_length": 6, "v": [6, 19, 21, 22, 23], "wavenumb": 6, "k": [6, 19], "long": 7, "later": 7, "risk": 7, "crash": [7, 29], "finit": [7, 19, 21, 22, 23, 24, 25, 35], "walltim": 7, "hpc": [7, 26, 32, 34], "thank": [7, 35], "set_periodic_checkpoint": [7, 22, 23], "checkpoint_dir": 7, "format": 7, "directori": [7, 8, 9, 26, 28, 29, 30, 31], "subdirectori": [7, 26, 28, 30], "b": [7, 8, 11, 21, 35], "processor": [7, 18], "nb": [7, 21, 23, 24], "regist": 7, "written": [7, 8, 18, 19], "wherea": 7, "integ": [7, 9, 18, 19, 20, 35], "string": [7, 8, 9, 10, 11, 18, 19], "path": [7, 8, 9, 26, 27], "restart_from_checkpoint": [7, 22, 23], "overwritten": 7, "boundari": [7, 19, 21, 22, 23, 34], "presenc": 7, "antenna": [7, 11, 21], "success": [7, 8], "rather": 7, "scratch": [7, 28, 30], "call": [7, 10, 11], "infer": 7, "latest": [7, 22, 23, 26], "avail": [7, 8, 11, 24, 28], "dure": [8, 11, 24], "form": [8, 9, 10, 19, 20], "remov": 8, "attribut": [8, 10], "fldobject": [8, 21], "fieldtyp": [8, 10, 21], "write_dir": 8, "iteration_min": 8, "iteration_max": 8, "inf": [8, 19], "dt_period": [8, 21], "int": [8, 9, 12, 13, 14, 15, 16, 18, 19, 20, 21, 22, 23], "whenev": 8, "divis": 8, "physic": [8, 9, 11, 18, 19, 24, 25, 34, 35], "point": [8, 35], "boundarycommun": [8, 18], "gather": [8, 10, 35], "proc": 8, "guard": [8, 19, 34], "own": 8, "indic": [8, 9, 12, 13, 14, 15, 16, 20], "posix": 8, "work": [8, 19, 27, 33, 34], "inclus": 8, "exclus": 8, "speci": [8, 9, 10, 18, 19, 21, 22, 23], "particle_data": 8, "momentum": 8, "weight": [8, 9, 35], "subsampling_fract": 8, "dictionari": [8, 9, 18, 19, 20], "elec": [8, 22, 23], "assign": 8, "commun": [8, 19, 21, 22, 23, 24, 27, 34], "respect": [8, 11, 12, 13, 14, 15, 16, 19, 21, 25], "turn": [8, 11], "off": [8, 19, 21, 22, 23, 28, 34], "track": [8, 18, 21, 22, 23], "id": [8, 18, 22, 23], "dict": [8, 9, 19], "rule": [8, 9], "micron": [8, 9, 11, 12, 13, 14, 15, 16], "mc": [8, 9], "5": [8, 9, 11, 21, 22, 23, 31], "subsampl": 8, "probabl": 8, "particlechargedensitydiagnost": [8, 22], "dataset": 8, "similar": [8, 10, 27, 34], "recontruct": 8, "zmin_lab": 8, "zmax_lab": 8, "v_lab": 8, "dt_snapshots_lab": 8, "ntot_snapshots_lab": 8, "gamma_boost": [8, 10, 11, 19, 21], "t_min_snapshots_lab": 8, "t_max_snapshots_lab": 8, "seri": 8, "snapshot": [8, 21], "virtual": [8, 11, 24, 34], "edg": [8, 19], "interv": [8, 21, 34], "accumul": 8, "memori": [8, 34, 35], "disk": [8, 21], "backward": [8, 9, 11, 19], "stagger": [8, 35], "awar": [8, 24, 31, 35], "error": [8, 29], "moreov": 8, "brought": 8, "spectral": [8, 11, 19, 25], "real": [8, 35], "former": [8, 9], "boostedfielddiagnost": 8, "renam": 8, "compat": [8, 9, 19, 29], "extract": [8, 9], "about": [8, 18, 19, 34], "boostedparticlediagnost": 8, "variou": 9, "gaussian": [9, 12, 13, 16, 19, 21, 22, 23], "flat": [9, 14], "top": [9, 19], "add_particle_bunch": [9, 21], "p_zmin": [9, 19, 21, 22, 23], "p_zmax": [9, 19, 21, 23], "p_rmin": [9, 19], "p_rmax": [9, 19, 21, 23], "p_nr": [9, 19, 21, 22, 23, 35], "p_nz": [9, 19, 21, 22, 23], "p_nt": [9, 19, 21, 22, 23], "dens_func": [9, 19, 21, 22, 23], "forward": [9, 11, 27], "z_injection_plan": 9, "initialize_self_field": 9, "boost_positions_in_dens_func": [9, 19, 21], "introduc": [9, 11], "uniform": [9, 19, 35], "accord": 9, "coulomb": [9, 19], "kg": [9, 19], "mass": [9, 18, 19], "maxim": [9, 19, 21, 23], "r": [9, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 25, 35], "callabl": [9, 10, 19], "1d": [9, 10, 19, 21], "den": [9, 19], "rel": [9, 19, 21, 22, 23, 32, 34], "express": [9, 10, 13, 14, 18, 19, 35], "taken": [9, 11, 12, 15, 16, 19], "ballist": 9, "bool": [9, 11, 19, 20], "add_particle_bunch_gaussian": 9, "sig_r": 9, "sig_z": 9, "n_emit": 9, "sig_gamma": 9, "n_physical_particl": 9, "n_macroparticl": 9, "tf": 9, "zf": [9, 11, 12, 13, 14, 15, 16, 21, 22], "save_beam": 9, "symmetr": 9, "focus": [9, 17], "out": [9, 11, 13, 21, 22, 23], "rm": 9, "absolut": 9, "energi": [9, 12, 16], "spread": 9, "reach": [9, 11, 15, 18], "npz": 9, "fold": 9, "rotat": 9, "symmetri": [9, 25, 35], "everi": 9, "pi": [9, 10, 11, 12, 13, 14, 15, 16, 21, 22], "plane": [9, 11, 12, 13, 14, 15, 16], "exactli": 9, "offset": 9, "add_particle_bunch_from_arrai": 9, "numpi": [9, 10, 21, 22, 23], "add_particle_bunch_openpmd": 9, "ts_path": 9, "z_off": 9, "timeseri": 9, "moment": 9, "There": [9, 10, 11], "h5": 9, "data0005000": 9, "shift": [9, 11], "phasespac": 9, "center": [9, 11, 15, 26], "add_particle_bunch_fil": 9, "filenam": 9, "text": [9, 26, 28, 30, 31], "seven": 9, "column": 9, "header": 9, "unitless": 9, "arbitrari": 9, "old": 9, "add_elec_bunch": 9, "flexibl": 9, "appli": [10, 17, 20, 34], "evolv": [10, 17], "external_field": 10, "externalfield": 10, "field_func": 10, "amplitud": [10, 11, 12, 13, 15, 16, 21, 22, 23], "length_scal": 10, "numba": [10, 24, 26, 27, 28, 29, 30, 31], "ufunc": 10, "n_ptcl": 10, "design": [10, 17], "overwrit": 10, "were": [10, 35], "To": [10, 11, 22, 24, 27, 29], "avoid": [10, 30, 35], "insid": [10, 11, 19, 21], "definit": 10, "math": [10, 11], "modul": [10, 24, 25, 26, 28, 30, 31], "mathemat": 10, "ex": 10, "ei": 10, "ez": 10, "bx": 10, "bz": 10, "magnet": 10, "undul": 10, "polar": [10, 11, 12, 13, 14, 15, 16, 34, 35], "tesla": 10, "cm": 10, "def": [10, 21, 22, 23], "co": [10, 11, 12, 15, 16, 35], "principl": 10, "necessarili": [10, 24, 34], "could": 10, "proport": [10, 34], "intern": [10, 21, 22, 23], "reli": 10, "variabl": [10, 19, 24, 27], "constraint": [10, 28], "add_laser_puls": [11, 21, 22, 23], "add_las": [11, 21], "present": 11, "entir": [11, 34], "immedi": 11, "manner": [11, 19], "equat": [11, 18, 19, 34, 35], "nabla": 11, "cdot": 11, "emit": 11, "advantag": [11, 24, 25, 27, 34], "opposit": 11, "unwant": 11, "interest": 11, "rapidli": 11, "exit": 11, "laser_profil": [11, 21, 22, 23], "z0_antenna": [11, 21], "v_antenna": 11, "interpol": [11, 35], "properti": 11, "laguerr": [11, 14], "gauss": 11, "waist": [11, 12, 13, 15, 16, 21, 22, 23], "durat": [11, 12, 13, 14, 15, 16, 21, 22, 23], "30": [11, 21, 22, 23, 26, 28, 30], "femtosecond": 11, "laguerregausslas": [11, 12, 16], "a0": [11, 12, 13, 14, 15, 16, 21, 22, 23], "6": [11, 14, 21, 22, 23, 26, 28, 31], "tau": [11, 12, 13, 14, 15, 16, 21, 22, 23], "15": [11, 21, 22, 23], "z0": [11, 12, 13, 14, 15, 16, 21, 22, 23], "even": [11, 16, 19, 25], "donut": 11, "like": [11, 22, 35], "few": [11, 34, 35], "cycl": [11, 19], "togeth": [11, 34, 35], "might": 11, "want": [11, 24, 27, 29], "circularli": 11, "linearli": [11, 12, 14, 15, 16, 35], "decompos": [11, 34], "orthogon": 11, "done": [11, 19, 21], "gaussianlas": [11, 13, 15, 21, 22, 23], "w0": [11, 14, 21, 22, 23], "linear_profile1": 11, "theta_pol": [11, 12, 13, 14, 15, 16], "cep_phas": [11, 12, 13, 14, 15, 16], "linear_profile2": 11, "circular_profil": 11, "experi": 11, "program": 11, "equival": [11, 13], "ctau": 11, "lambda0": [11, 12, 13, 14, 15, 16, 21], "8e": [11, 12, 13, 14, 15, 16, 21], "07": [11, 12, 13, 14, 15, 16], "phi2_chirp": [11, 15], "fw_propag": 11, "update_spectr": 11, "electr": [11, 12, 13, 15, 16, 18], "focal": [11, 12, 13, 14, 15, 16, 21, 22], "a_0": [11, 12, 13, 15, 16], "e_0": [11, 12, 13, 15, 16], "exp": [11, 12, 14, 15, 16], "w_0": [11, 12, 13, 14, 15, 16], "z_0": [11, 12, 13, 15, 16], "ct": [11, 12, 13, 15, 16], "k_0": [11, 12, 13, 15, 16], "phi_": [11, 12, 13, 15, 16], "cep": [11, 12, 13, 14, 15, 16], "lambda_0": [11, 12, 13, 14, 15, 16], "wavevector": [11, 12, 13, 15, 16], "m_e": [11, 12, 13, 15, 16, 21, 22, 23], "q_e": [11, 12, 13, 15, 16], "aris": [11, 12, 15, 16], "far": [11, 12, 14, 15, 16, 35], "goui": [11, 12, 15, 16], "wavefront": [11, 12, 15, 16], "curvatur": [11, 12, 15, 16], "simplic": [11, 12, 15, 16], "cours": [11, 12, 15, 16, 35], "awai": [11, 12, 15, 16], "peak": [11, 13, 14, 15], "centroid": [11, 12, 13, 14, 15, 16, 21, 22, 23], "radian": [11, 12, 13, 14, 15, 16], "angl": [11, 12, 13, 14, 15, 16], "axi": [11, 12, 13, 14, 15, 16, 19, 34, 35], "carrier": [11, 12, 13, 14, 15, 16], "envelopp": [11, 12, 13, 14, 15, 16], "amount": [11, 15, 34], "chirp": [11, 15], "packet": [11, 15], "omega_0": [11, 13, 15], "omega": [11, 15], "phi": [11, 15], "red": [11, 15, 35], "spectrum": [11, 15], "front": [11, 15], "blue": [11, 15, 35], "back": [11, 15, 21, 35], "wether": 11, "donutlikelaguerregausslas": [12, 16], "propagation_direct": [12, 13, 14, 15, 16], "unlik": [12, 16], "azimuth": [12, 16, 19], "cork": 12, "screw": 12, "pattern": 12, "independ": [12, 16, 19, 34, 35], "mathrm": [12, 14, 16], "qquad": [12, 14, 16], "_p": 12, "m_p": [12, 16, 21, 22], "polynomi": [12, 14, 16], "info": [12, 16], "siegman": [12, 16], "1986": [12, 16], "chapter": [12, 16], "16": [12, 16, 21, 22, 23, 34], "optic": [12, 13, 14, 16], "mode": [12, 16, 19, 21, 22, 23, 35], "nm": [12, 16, 19, 21, 22, 23], "ring": [12, 14, 16], "radial": [12, 16, 19, 21, 23, 35], "neg": [12, 13, 14, 15, 16, 34], "8": [12, 13, 14, 15, 16, 24, 27, 28], "ti": [12, 13, 14, 15, 16], "sapph": [12, 13, 14, 15, 16], "fewcyclelas": 13, "tau_fwhm": 13, "adapt": 13, "neglect": 13, "overcom": 13, "caron": 13, "potvileg": 13, "journal": 13, "modern": [13, 14, 34], "46": 13, "1881": 13, "1999": 13, "re": [13, 19], "z_r": 13, "ik_0": 13, "2q": 13, "rayleigh": 13, "z_f": 13, "iz_r": 13, "control": 13, "fwhm": 13, "gg": 13, "mani": [13, 19, 34], "envelop": 13, "full": [13, 35], "width": 13, "half": 13, "flattenedgaussianlas": 14, "santarsiero": 14, "et": [14, 25], "al": [14, 25], "1997": 14, "0_n": 14, "sum_": 14, "_n": 14, "binom": 14, "rightarrow": 14, "infti": 14, "jinc": 14, "j_1": 14, "foc": 14, "w_": 14, "spot": 14, "determin": [14, 19, 34], "somewhat": 14, "8th": 14, "supergaussian": 14, "theta0": 16, "delta_": 16, "theta_0": 16, "linear": [16, 19, 23, 34, 35], "driven": 16, "ponderomot": 16, "forc": [16, 30, 35], "maxima": 16, "helper": 17, "extern": 17, "ptcl": [18, 19], "It": [18, 19, 21, 24, 25, 26, 27, 28, 34], "append": [18, 26], "ioniz": [18, 19, 24, 25], "state": 18, "level": [18, 19, 22], "alloc": [18, 21, 22, 23, 26, 27, 28], "uniqu": 18, "make_ioniz": [18, 22, 24], "target_speci": [18, 22], "level_start": [18, 22], "level_max": 18, "model": [18, 25, 29], "adk": [18, 25], "instantan": 18, "averag": 18, "over": [18, 24], "rate": 18, "found": [18, 27], "chen": 18, "jcp": [18, 19], "236": 18, "2013": 18, "atom": [18, 22], "symbol": 18, "consid": [18, 25], "he": [18, 22], "helium": [18, 22], "nitrogen": [18, 22], "kei": [18, 19], "distinct": [18, 25], "neutral": [18, 19, 22], "exce": 18, "set_moving_window": [19, 21, 22, 23], "nz": [19, 21, 22, 23], "zmax": [19, 21, 22, 23], "nr": [19, 21, 22, 23], "rmax": [19, 21, 22, 23], "n_e": [19, 21, 22, 23], "n_order": [19, 21, 22, 23, 24, 34], "filter_curr": 19, "use_galilean": 19, "use_cuda": [19, 21, 22, 23], "n_guard": 19, "n_damp": 19, "64": 19, "exchange_period": 19, "current_correct": 19, "curl": [19, 34], "free": [19, 34, 35], "reflect": [19, 21, 22, 23], "particle_shap": 19, "verbose_level": [19, 34], "smoother": [19, 20], "use_ruyten_shap": 19, "use_modified_volum": 19, "cut": 19, "agument": 19, "hydrogen": 19, "docstr": 19, "mention": [19, 26, 28, 34], "label": [19, 35], "gridpoint": [19, 21, 22, 23, 35], "last": [19, 21], "stencil": [19, 21, 22, 23, 34], "deriv": [19, 21, 22, 23, 35], "maxwel": [19, 21, 22, 23, 34, 35], "solver": [19, 21, 22, 23, 24, 25, 35], "infinit": [19, 21, 22, 23, 34], "exact": [19, 21, 22, 23], "dispers": [19, 21, 22, 23, 34, 35], "relat": [19, 21, 22, 23, 29], "advic": [19, 21, 22, 23, 28], "cpu": [19, 21, 22, 23, 24, 25, 27, 28, 29, 31, 34], "multi": [19, 21, 22, 23, 24, 25, 34], "lead": [19, 21, 22, 23, 25, 34, 35], "overhead": [19, 21, 22, 23, 34], "accur": [19, 21, 22, 23, 25, 34], "trade": [19, 21, 22, 23, 34], "articl": [19, 34, 35], "filter": 19, "psatd": 19, "constant": [19, 21, 22, 23], "scheme": 19, "hypothesi": 19, "solv": [19, 35], "domain": [19, 24, 34], "damp": 19, "upper": 19, "exchang": [19, 34], "never": 19, "abl": [19, 28, 29], "travel": 19, "substanti": 19, "absorb": 19, "perfectli": 19, "layer": [19, 34], "significantli": 19, "costli": 19, "continu": [19, 27], "contribut": 19, "decomposit": [19, 24, 34], "share": [19, 30, 34], "str": 19, "cubic": 19, "third": 19, "binomialsmooth": [19, 20], "binomi": [19, 20], "compens": [19, 20], "ruyten": 19, "105": 19, "1993": 19, "http": [19, 21, 22, 23, 26, 27, 29], "doi": 19, "org": [19, 21, 22, 23, 27], "1006": 19, "jcph": 19, "1070": 19, "slightli": [19, 35], "volum": 19, "correctli": [19, 34], "uz_m": 19, "ux_m": 19, "uy_m": 19, "uz_th": 19, "ux_th": 19, "uy_th": 19, "continuous_inject": 19, "is_trac": 19, "evenli": 19, "explicitli": [19, 24], "except": [19, 26, 35], "suffici": 19, "word": 19, "thermal": 19, "passiv": 19, "tracer": 19, "new_speci": 19, "299792458": 19, "unus": 19, "kept": 19, "correct_curr": 19, "correct_d": 19, "use_true_rho": 19, "move_posit": 19, "move_momenta": 19, "show_progress": 19, "push": [19, 35], "freez": 19, "random_se": [19, 22], "set_random_se": [19, 22], "seed": [19, 22], "random": [19, 22], "repeatedli": 19, "despit": 19, "mont": 19, "carlo": 19, "n_pass": 20, "mitig": [20, 25], "impact": 20, "intermedi": 20, "boolean": 20, "download": [21, 22, 23, 24, 26, 27, 29], "link": [21, 22, 23, 27, 32], "usag": [21, 22, 23, 27], "suit": [21, 22, 23, 24, 25, 34], "boosted_frame_script": [21, 24], "enter": [21, 22, 23], "fbpic_object": [21, 22, 23], "__doc__": [21, 22, 23], "scipi": [21, 22, 23, 26, 27, 28, 29, 30], "relev": [21, 22, 23, 31], "arxiv": [21, 22, 23, 25, 35], "ab": [21, 22, 23], "1611": [21, 22, 23], "05712": [21, 22, 23], "600": 21, "75": 21, "150": 21, "advanc": [21, 25, 34, 35], "explan": 21, "min": 21, "50": [21, 22, 23], "zfoc": 21, "w_match": 21, "ramp_up": 21, "5e": 21, "plateau": 21, "ramp_down": 21, "e24": [21, 22], "labfram": 21, "divid": 21, "guid": [21, 26], "rel_delta_n_over_w2": 21, "81e": 21, "n_plasma": 21, "ones_lik": [21, 22, 23], "ramp": [21, 22, 23], "inv_ramp_up": 21, "inv_ramp_down": 21, "parabol": 21, "bunch_zmin": 21, "bunch_zmax": 21, "bunch_rmax": 21, "bunch_gamma": 21, "400": 21, "bunch_n": 21, "e23": 21, "75e27": 21, "nci": 21, "discret": [21, 35], "n_boosted_diag": 21, "n_lab_diag": 21, "dt_lab_diag_period": 21, "dt_boosted_diag_period": 21, "cach": [21, 27, 30], "backtransform": 21, "write_period": 21, "tag": 21, "track_bunch": 21, "carri": [21, 22, 23], "execut": [21, 23, 24, 26, 29, 34], "boosted_frame_sim": 21, "__name__": [21, 22, 23], "__main__": [21, 22, 23], "expens": [21, 22, 23, 35], "plasma_elec": 21, "plasma_ion": 21, "v_window_boost": 21, "configur": [21, 22, 23, 28], "fld": [21, 22, 23], "mix": 22, "pre": [22, 25], "ionization_script": 22, "800": [22, 23], "20": [22, 23, 31], "n_he": 22, "n_n": 22, "z_foc": 22, "diag_period": [22, 23], "save_checkpoint": [22, 23], "checkpoint_period": [22, 23], "use_restart": [22, 23], "track_electron": [22, 23], "ramp_length": [22, 23], "sine": 22, "sin": [22, 35], "supress": [22, 23], "distanc": [22, 23], "atoms_h": 22, "atoms_n": 22, "14": 22, "n5": 22, "5x": 22, "dedic": 22, "elec_from_n": 22, "els": [22, 23], "almost": 22, "everywher": 22, "individu": [22, 34], "lwfa_script": [23, 24], "500": 23, "18": 23, "e18": 23, "e6": 23, "ramp_start": 23, "40": 23, "environ": [24, 27, 28, 30], "parallelis": 24, "thread": [24, 25, 27, 34], "core": [24, 25, 27, 34], "export": [24, 26, 27, 30, 31], "mkl_num_thread": 24, "numba_num_thread": [24, 31], "altogeth": 24, "fbpic_disable_thread": 24, "happen": 24, "altern": [24, 34], "backend": 24, "omp_num_thread": [24, 31], "jupyt": 24, "notebook": [24, 28], "socket": [24, 27, 34], "ineffici": 24, "necessari": 24, "bind": 24, "spawn": 24, "bound": 24, "slurm": 24, "workload": 24, "manag": [24, 30], "srun": [24, 26, 27, 28, 30], "cpu_bind": 24, "gpudirect": [24, 27], "technologi": 24, "copi": [24, 26, 28, 30, 31, 34], "latenc": 24, "bandwidth": 24, "care": 24, "fbpic_enable_gpudirect": [24, 27, 30, 31], "compli": 24, "conda": [24, 26, 27, 28, 29, 30, 31], "forg": [24, 26, 28, 29, 30], "openpmd_notebook": 24, "pop": [24, 25], "capabl": 24, "learn": [24, 34], "tutori": 24, "github": [24, 25, 29], "repositori": 24, "render": 24, "fourier": [25, 35], "bessel": 25, "especi": 25, "represent": [25, 35], "fast": [25, 34], "situat": [25, 35], "brief": 25, "intrins": 25, "numer": [25, 34, 35], "cherenkov": [25, 34], "radiat": [25, 34], "ncr": [25, 34], "strongli": 25, "what": 25, "welcom": 25, "wish": 25, "develop": [25, 27], "remi": 25, "lehe": 25, "berkelei": [25, 28], "manuel": 25, "kirchen": 25, "cfel": 25, "hamburg": 25, "univers": 25, "benefit": 25, "soeren": 25, "jala": 25, "kevin": 25, "peter": 25, "iren": 25, "dornmair": 25, "laurid": 25, "jepp": 25, "igor": 25, "andriyash": 25, "laboratoir": 25, "optiqu": 25, "applique": 25, "omri": 25, "seemann": 25, "weizmann": 25, "institut": 25, "daniel": 25, "seipt": 25, "michigan": 25, "samuel": 25, "yoff": 25, "strathclyd": 25, "david": 25, "grote": 25, "llnl": 25, "lbnl": [25, 32], "scientif": 25, "public": 25, "cpc": 25, "2016": 25, "techniqu": 25, "2017": 25, "2020": 25, "project": [25, 31], "great": 25, "cite": 25, "san": 26, "diego": 26, "supercomput": [26, 27], "nvidia": [26, 27, 29, 30, 31, 34], "k80": 26, "p100": 26, "base": [26, 30, 31], "resourc": [26, 27], "miniconda": 26, "wget": [26, 27], "repo": [26, 27], "com": [26, 27, 29], "miniconda3": 26, "linux": [26, 27], "x86_64": [26, 27], "sh": [26, 27], "bash": [26, 27, 28, 30, 31], "ask": 26, "bashrc": [26, 27, 28], "answer": 26, "ye": 26, "cupi": [26, 27, 28, 29, 30, 31], "h5py": [26, 27, 28, 29, 30], "mkl": [26, 27, 28, 29, 30], "cudatoolkit": [26, 27, 28, 29, 30, 31], "9": [26, 31], "purg": [26, 31], "gnutool": 26, "gnu": [26, 30], "openmpi_ib": 26, "cuda92": 26, "env": 26, "mpicc": [26, 30], "opt": 26, "ib": 26, "bin": [26, 27, 28, 30, 31], "briefli": 26, "submit": 26, "request": [26, 28, 30, 31], "salloc": [26, 27, 28, 30], "gre": [26, 27, 28], "00": [26, 27, 28, 30, 31], "pty": [26, 27, 28], "connect": [26, 27], "cd": [26, 27, 28, 30, 31], "submission_fil": [26, 28, 30], "bracket": [26, 28, 30, 31], "proper": [26, 28, 30, 31], "sbatch": [26, 28, 30], "my_job": [26, 28, 30, 31], "requestednod": [26, 31], "requestedtim": [26, 28, 30, 31], "gputyp": 26, "ntask": [26, 27, 28, 30], "corespergpu": 26, "pmi2": 26, "nmpi": 26, "7": [26, 27, 30, 31], "juelich": 27, "centr": 27, "gcc": [27, 31], "mvapich2": 27, "gdr": 27, "archiv": 27, "anaconda3": [27, 31], "2019": 27, "03": 27, "cuda100": [27, 28], "NOT": 27, "built": 27, "against": 27, "librari": 27, "dir": [27, 30], "version": [27, 29, 35], "git": [27, 29], "bitbucket": 27, "shell": 27, "get_library_vers": 27, "pythonpath": 27, "home": 27, "juser": 27, "usernam": [27, 28], "lib": 27, "python3": [27, 29, 30], "site": 27, "clone": [27, 29, 31], "job": 27, "ressourc": 27, "2x24": 27, "60": 27, "minut": [27, 31], "multithread": 27, "best": [27, 34], "ideal": [27, 35], "v100": [27, 28, 31], "partit": [27, 28], "run_fil": 27, "task": [27, 28, 30], "consol": 27, "jureca": 27, "establish": 27, "ssh": [27, 28], "fz": 27, "de": 27, "lawrenc": 28, "nation": 28, "four": 28, "gtx": 28, "1080ti": 28, "password": 28, "otp": 28, "token": 28, "lrc": 28, "login": 28, "lbl": 28, "gov": 28, "fbpic_env": 28, "global": [28, 30], "yourusernam": [28, 30], "es1": 28, "es1_1080ti": 28, "qo": 28, "es_norm": 28, "u": 28, "gpuconstraint": 28, "requestedrank": [28, 30], "gpupernod": 28, "cpupertask": 28, "es1_v100": 28, "queue": 28, "squeue": 28, "anaconda": 29, "picmi": 29, "releas": 29, "shortcut": 29, "11": [29, 30], "cuda110": 29, "driver": 29, "smi": 29, "tabl": 29, "intel": 29, "pyfftw": [29, 31], "fft": 29, "mac": 29, "osx": 29, "observ": 29, "try": 29, "macport": 29, "uninstal": 29, "sudo": 29, "port": 29, "gcc48": 29, "fortran": 29, "Its": 30, "equip": 30, "a100": 30, "prepar": 30, "prgenv": 30, "cpe": 30, "deactiv": [30, 31], "interfer": 30, "config": 30, "auto_activate_bas": 30, "cc": 30, "target": 30, "accel": 30, "nvidia80": 30, "account_numb": [30, 31], "mpich_gpu_support_en": 30, "oakridg": 31, "leadership": 31, "facil": 31, "fftw": 31, "cython": 31, "49": 31, "memberwork": 31, "mkdir": 31, "project_id": 31, "cp": 31, "bsub": 31, "nnode": 31, "85": 31, "cupy_cache_dir": 31, "kernel_cach": 31, "fbpic_disable_cach": 31, "jsrun": 31, "submission_script": 31, "accountnumb": 31, "requestedmpirank": 31, "smpiarg": 31, "attempt": 31, "bjob": 31, "monitor": 31, "plateform": 32, "juwel": 32, "jsc": 32, "lawrencium": 32, "comet": 32, "sdsc": 32, "perlmutt": 32, "nersc": 32, "summit": 32, "olcf": 32, "demand": 34, "arithmet": 34, "oper": 34, "consumpt": 34, "unit": 34, "strategi": 34, "chunk": 34, "treat": 34, "protocol": 34, "imag": [34, 35], "illustr": 34, "map": 34, "onto": [34, 35], "architectur": 34, "ram": 34, "slower": 34, "area": 34, "network": 34, "layout": 34, "thousand": 34, "contrast": [34, 35], "hardwar": 34, "achiev": 34, "come": 34, "hundr": 34, "millisecond": 34, "fit": 34, "enough": [34, 35], "split": 34, "region": 34, "neighbor": 34, "overlap": 34, "resid": 34, "messag": 34, "poor": 34, "highli": 34, "farther": 34, "tunabl": 34, "accuraci": 34, "integr": 34, "oppos": 34, "evolut": [34, 35], "fdtd": 34, "classifi": 34, "extent": 34, "notat": 34, "extend": 34, "artifici": 34, "rang": 34, "modif": 34, "bring": 34, "govern": 34, "spuriou": [34, 35], "deterior": 34, "qualiti": 34, "identifi": 34, "guarante": 34, "influenc": 34, "slight": 34, "disadvantag": 34, "strictli": 34, "preserv": 34, "lump": 35, "At": 35, "schemat": 35, "view": 35, "calder": 35, "circ": 35, "2d": 35, "proportion": 35, "coordin": 35, "e_r": 35, "e_": 35, "further": 35, "departur": 35, "stake": 35, "vastli": 35, "nonetheless": 35, "cost": 35, "suggest": 35, "sum": 35, "appear": 35, "denot": 35, "post": 35, "artifact": 35, "growth": 35, "courant": 35, "freeli": 35, "resolut": 35, "geometri": 35, "hankel": 35, "n_z": 35, "n_r": 35, "notabl": 35}, "objects": {"fbpic.fields.smoothing": [[20, 0, 1, "", "BinomialSmoother"]], "fbpic.lpa_utils.boosted_frame": [[6, 0, 1, "", "BoostConverter"]], "fbpic.lpa_utils.boosted_frame.BoostConverter": [[6, 1, 1, "", "boost_particle_arrays"], [6, 1, 1, "", "copropag_density"], [6, 1, 1, "", "copropag_length"], [6, 1, 1, "", "gamma"], [6, 1, 1, "", "interaction_time"], [6, 1, 1, "", "longitudinal_momentum"], [6, 1, 1, "", "static_density"], [6, 1, 1, "", "static_length"], [6, 1, 1, "", "velocity"], [6, 1, 1, "", "wavenumber"]], "fbpic.lpa_utils.bunch": [[9, 2, 1, "", "add_particle_bunch"], [9, 2, 1, "", "add_particle_bunch_file"], [9, 2, 1, "", "add_particle_bunch_from_arrays"], [9, 2, 1, "", "add_particle_bunch_gaussian"], [9, 2, 1, "", "add_particle_bunch_openPMD"]], "fbpic.lpa_utils.external_fields": [[10, 0, 1, "", "ExternalField"]], "fbpic.lpa_utils.laser": [[12, 0, 1, "", "DonutLikeLaguerreGaussLaser"], [13, 0, 1, "", "FewCycleLaser"], [14, 0, 1, "", "FlattenedGaussianLaser"], [15, 0, 1, "", "GaussianLaser"], [16, 0, 1, "", "LaguerreGaussLaser"], [11, 2, 1, "", "add_laser"], [11, 2, 1, "", "add_laser_pulse"]], "fbpic.main": [[19, 0, 1, "", "Simulation"]], "fbpic.main.Simulation": [[19, 1, 1, "", "add_new_species"], [19, 1, 1, "", "set_moving_window"], [19, 1, 1, "", "step"]], "fbpic.openpmd_diag": [[8, 0, 1, "", "BackTransformedFieldDiagnostic"], [8, 0, 1, "", "BackTransformedParticleDiagnostic"], [8, 0, 1, "", "FieldDiagnostic"], [8, 0, 1, "", "ParticleChargeDensityDiagnostic"], [8, 0, 1, "", "ParticleDiagnostic"], [7, 2, 1, "", "restart_from_checkpoint"], [7, 2, 1, "", "set_periodic_checkpoint"]], "fbpic.particles": [[18, 0, 1, "", "Particles"]], "fbpic.particles.fbpic.particles.Particles.Particles": [[18, 1, 1, "", "make_ionizable"], [18, 1, 1, "", "track"]], "fbpic.utils.random_seed": [[19, 2, 1, "", "set_random_seed"]]}, "objtypes": {"0": "py:class", "1": "py:method", "2": "py:function"}, "objnames": {"0": ["py", "class", "Python class"], "1": ["py", "method", "Python method"], "2": ["py", "function", "Python function"]}, "titleterms": {"3d": 0, "visual": [0, 4, 24, 28], "us": [0, 1, 4], "pyvista": 0, "advanc": 1, "run": [2, 24, 26, 27, 28, 29, 30, 31], "boost": [2, 6, 8, 21], "frame": [2, 6, 8, 21], "simul": [2, 4, 7, 8, 19, 21, 23, 24, 26, 27, 28, 29, 30, 31], "principl": 2, "techniqu": 2, "lwfa": 2, "convert": 2, "input": 2, "paramet": [2, 3], "from": 2, "lab": 2, "result": [2, 4, 24, 28], "avoid": 2, "numer": 2, "cherenkov": 2, "instabl": 2, "nci": 2, "estim": 2, "number": 2, "pic": [2, 35], "iter": 2, "transform": [2, 8], "resolut": 2, "physic": 2, "object": 2, "perform": 3, "scan": 3, "parallel": [3, 34], "profil": [4, 11, 12, 13, 14, 15, 16], "code": [4, 24, 33], "execut": 4, "cpu": 4, "get": 4, "simpl": 4, "text": 4, "file": 4, "gpu": 4, "mpi": 4, "api": 5, "refer": 5, "convers": 6, "checkpoint": 7, "restart": 7, "set": [7, 28, 30], "The": [8, 18, 19, 35], "openpmd": 8, "diagnost": 8, "regular": 8, "field": [8, 10, 20], "particl": [8, 18], "densiti": 8, "back": 8, "beam": 9, "initi": [9, 11], "extern": 10, "laser": [11, 17, 21, 22, 23], "gener": 11, "function": 11, "arbitrari": 11, "combin": 11, "sum": 11, "creat": 11, "your": 11, "own": 11, "custom": 11, "compact": 11, "gaussian": [11, 14, 15], "puls": 11, "donut": 12, "like": 12, "laguerr": [12, 16], "gauss": [12, 16], "few": 13, "cycl": [13, 35], "flatten": 14, "plasma": 17, "util": 17, "class": [18, 19], "smooth": 20, "wakefield": [21, 22, 23], "acceler": [21, 22, 23], "ioniz": 22, "standard": 23, "how": 24, "script": 24, "exampl": 24, "fbpic": [25, 26, 27, 28, 29, 30, 31, 34, 35], "document": 25, "content": 25, "contribut": 25, "research": 25, "attribut": 25, "instal": [26, 27, 28, 29, 30, 31, 32], "comet": 26, "sdsc": 26, "anaconda": [26, 27, 28, 30, 31], "its": [26, 28, 30, 31], "depend": [26, 28, 30, 31], "prepar": [26, 28, 31], "new": [26, 28], "interact": [26, 28, 30, 31], "job": [26, 28, 30, 31], "batch": [26, 28, 30, 31], "juwel": 27, "jsc": 27, "load": 27, "cluster": 27, "modul": 27, "lawrencium": 28, "lbnl": 28, "connect": 28, "up": [28, 30], "through": 28, "jupyt": 28, "local": 29, "comput": 29, "potenti": 29, "issu": 29, "perlmutt": 30, "nersc": 30, "summit": 31, "olcf": 31, "environ": 31, "overview": 33, "two": 34, "level": 34, "intra": 34, "devic": 34, "inter": 34, "finit": 34, "order": 34, "spectral": [34, 35], "solver": 34, "algorithm": 35, "featur": 35, "introduct": 35, "distinct": 35, "cylindr": 35, "grid": 35, "azimuth": 35, "decomposit": 35, "analyt": 35, "integr": 35, "space": 35, "center": 35, "time": 35}, "envversion": {"sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1, "sphinx": 60}, "alltitles": {"3D visualization using PyVista": [[0, "d-visualization-using-pyvista"]], "Advanced use": [[1, "advanced-use"]], "Running boosted-frame simulations": [[2, "running-boosted-frame-simulations"]], "Principle of the boosted-frame technique (for LWFA)": [[2, "principle-of-the-boosted-frame-technique-for-lwfa"]], "Converting input parameters from the lab frame to the boosted frame": [[2, "converting-input-parameters-from-the-lab-frame-to-the-boosted-frame"]], "Converting simulation results from the boosted frame to the lab frame": [[2, "converting-simulation-results-from-the-boosted-frame-to-the-lab-frame"]], "Avoiding the Numerical Cherenkov Instability (NCI)": [[2, "avoiding-the-numerical-cherenkov-instability-nci"]], "Estimating the number of PIC iterations for boosted frame simulations": [[2, "estimating-the-number-of-pic-iterations-for-boosted-frame-simulations"]], "Transformation and resolution of physical objects in the boosted frame": [[2, "transformation-and-resolution-of-physical-objects-in-the-boosted-frame"]], "Performing parameter scans in parallel": [[3, "performing-parameter-scans-in-parallel"]], "Profiling the code": [[4, "profiling-the-code"]], "Profiling the code executed on CPU": [[4, "profiling-the-code-executed-on-cpu"]], "Getting the results in a simple text file": [[4, "getting-the-results-in-a-simple-text-file"], [4, "id1"]], "Using a visual profiler": [[4, "using-a-visual-profiler"], [4, "id2"]], "Profiling the code executed on GPU": [[4, "profiling-the-code-executed-on-gpu"]], "Profiling MPI simulations": [[4, "profiling-mpi-simulations"]], "Profiling the CPU code": [[4, "profiling-the-cpu-code"]], "Profiling the GPU code": [[4, "profiling-the-gpu-code"]], "API reference": [[5, "api-reference"]], "Conversion to boosted-frame": [[6, "conversion-to-boosted-frame"]], "Checkpoints and restarts": [[7, "checkpoints-and-restarts"]], "Setting checkpoints": [[7, "setting-checkpoints"]], "Restarting a simulation": [[7, "restarting-a-simulation"]], "The openPMD diagnostics": [[8, "the-openpmd-diagnostics"]], "Regular diagnostics": [[8, "regular-diagnostics"]], "Field diagnostic": [[8, "field-diagnostic"], [8, "id1"]], "Particle diagnostic": [[8, "particle-diagnostic"], [8, "id2"]], "Particle density diagnostic": [[8, "particle-density-diagnostic"]], "Back-transformed diagnostics (boosted-frame simulations)": [[8, "back-transformed-diagnostics-boosted-frame-simulations"]], "Beam initialization": [[9, "beam-initialization"]], "External fields": [[10, "external-fields"]], "Laser initialization": [[11, "laser-initialization"]], "Generic function for arbitrary laser profile": [[11, "generic-function-for-arbitrary-laser-profile"]], "Laser profiles": [[11, "laser-profiles"]], "Combining (summing) laser profiles": [[11, "combining-summing-laser-profiles"]], "Creating your own custom laser profile": [[11, "creating-your-own-custom-laser-profile"]], "Compact function for a Gaussian pulse": [[11, "compact-function-for-a-gaussian-pulse"]], "Donut-like Laguerre-Gauss profile": [[12, "donut-like-laguerre-gauss-profile"]], "Few-cycle profile": [[13, "few-cycle-profile"]], "Flattened Gaussian profile": [[14, "flattened-gaussian-profile"]], "Gaussian profile": [[15, "gaussian-profile"]], "Laguerre-Gauss profile": [[16, "laguerre-gauss-profile"]], "Laser-plasma utilities": [[17, "laser-plasma-utilities"]], "The Particles class": [[18, "the-particles-class"]], "The Simulation class": [[19, "the-simulation-class"]], "Field smoothing": [[20, "field-smoothing"]], "Boosted-frame simulation of laser-wakefield acceleration": [[21, "boosted-frame-simulation-of-laser-wakefield-acceleration"]], "Laser-wakefield acceleration with ionization": [[22, "laser-wakefield-acceleration-with-ionization"]], "Standard simulation of laser-wakefield acceleration": [[23, "standard-simulation-of-laser-wakefield-acceleration"]], "How to run the code": [[24, "how-to-run-the-code"]], "Script examples": [[24, "script-examples"]], "Running the simulation": [[24, "running-the-simulation"]], "Visualizing the simulation results": [[24, "visualizing-the-simulation-results"]], "FBPIC documentation": [[25, "fbpic-documentation"]], "Contents of the documentation": [[25, "contents-of-the-documentation"]], "Contributing to FBPIC": [[25, "contributing-to-fbpic"]], "Research & Attribution": [[25, "research-attribution"]], "Installation on Comet (SDSC)": [[26, "installation-on-comet-sdsc"]], "Installation of FBPIC": [[26, "installation-of-fbpic"], [27, "installation-of-fbpic"], [28, "installation-of-fbpic"], [30, "installation-of-fbpic"], [31, "installation-of-fbpic"]], "Installation of Anaconda": [[26, "installation-of-anaconda"], [27, "installation-of-anaconda"]], "Installation of FBPIC and its dependencies": [[26, "installation-of-fbpic-and-its-dependencies"], [28, "installation-of-fbpic-and-its-dependencies"], [30, "installation-of-fbpic-and-its-dependencies"], [31, "installation-of-fbpic-and-its-dependencies"]], "Running simulations": [[26, "running-simulations"], [27, "running-simulations"], [28, "running-simulations"], [29, "running-simulations"], [30, "running-simulations"], [31, "running-simulations"]], "Preparing a new simulation": [[26, "preparing-a-new-simulation"], [28, "preparing-a-new-simulation"]], "Interactive jobs": [[26, "interactive-jobs"], [28, "interactive-jobs"], [30, "interactive-jobs"], [31, "interactive-jobs"]], "Batch job": [[26, "batch-job"], [28, "batch-job"], [30, "batch-job"], [31, "batch-job"]], "Installation on JUWELS (JSC)": [[27, "installation-on-juwels-jsc"]], "Loading the cluster modules": [[27, "loading-the-cluster-modules"]], "Installation on Lawrencium (LBNL)": [[28, "installation-on-lawrencium-lbnl"]], "Connecting to Lawrencium": [[28, "connecting-to-lawrencium"]], "Setting up Anaconda": [[28, "setting-up-anaconda"], [30, "setting-up-anaconda"]], "Visualizing the results through Jupyter": [[28, "visualizing-the-results-through-jupyter"]], "Installation on a local computer": [[29, "installation-on-a-local-computer"]], "Installing FBPIC": [[29, "installing-fbpic"]], "Potential issues": [[29, "potential-issues"]], "Installation on Perlmutter (NERSC)": [[30, "installation-on-perlmutter-nersc"]], "Installation on Summit (OLCF)": [[31, "installation-on-summit-olcf"]], "Preparing the Anaconda environment": [[31, "preparing-the-anaconda-environment"]], "Installation": [[32, "installation"]], "Overview of the code": [[33, "overview-of-the-code"]], "Parallelization of FBPIC": [[34, "parallelization-of-fbpic"]], "Two-level parallelization": [[34, "two-level-parallelization"]], "Intra-device parallelization": [[34, "intra-device-parallelization"]], "Inter-device parallelization": [[34, "inter-device-parallelization"]], "Finite-order spectral solver": [[34, "finite-order-spectral-solver"]], "FBPIC algorithm & features": [[35, "fbpic-algorithm-features"]], "Introduction to the PIC cycle": [[35, "introduction-to-the-pic-cycle"]], "The distinctive features of FBPIC": [[35, "the-distinctive-features-of-fbpic"]], "Cylindrical grid with azimuthal decomposition": [[35, "cylindrical-grid-with-azimuthal-decomposition"]], "Analytical integration in spectral space": [[35, "analytical-integration-in-spectral-space"]], "Centering in time and space": [[35, "centering-in-time-and-space"]]}, "indexentries": {"boostconverter (class in fbpic.lpa_utils.boosted_frame)": [[6, "fbpic.lpa_utils.boosted_frame.BoostConverter"]], "boost_particle_arrays() (fbpic.lpa_utils.boosted_frame.boostconverter method)": [[6, "fbpic.lpa_utils.boosted_frame.BoostConverter.boost_particle_arrays"]], "copropag_density() (fbpic.lpa_utils.boosted_frame.boostconverter method)": [[6, "fbpic.lpa_utils.boosted_frame.BoostConverter.copropag_density"]], "copropag_length() (fbpic.lpa_utils.boosted_frame.boostconverter method)": [[6, "fbpic.lpa_utils.boosted_frame.BoostConverter.copropag_length"]], "gamma() (fbpic.lpa_utils.boosted_frame.boostconverter method)": [[6, "fbpic.lpa_utils.boosted_frame.BoostConverter.gamma"]], "interaction_time() (fbpic.lpa_utils.boosted_frame.boostconverter method)": [[6, "fbpic.lpa_utils.boosted_frame.BoostConverter.interaction_time"]], "longitudinal_momentum() (fbpic.lpa_utils.boosted_frame.boostconverter method)": [[6, "fbpic.lpa_utils.boosted_frame.BoostConverter.longitudinal_momentum"]], "static_density() (fbpic.lpa_utils.boosted_frame.boostconverter method)": [[6, "fbpic.lpa_utils.boosted_frame.BoostConverter.static_density"]], "static_length() (fbpic.lpa_utils.boosted_frame.boostconverter method)": [[6, "fbpic.lpa_utils.boosted_frame.BoostConverter.static_length"]], "velocity() (fbpic.lpa_utils.boosted_frame.boostconverter method)": [[6, "fbpic.lpa_utils.boosted_frame.BoostConverter.velocity"]], "wavenumber() (fbpic.lpa_utils.boosted_frame.boostconverter method)": [[6, "fbpic.lpa_utils.boosted_frame.BoostConverter.wavenumber"]], "restart_from_checkpoint() (in module fbpic.openpmd_diag)": [[7, "fbpic.openpmd_diag.restart_from_checkpoint"]], "set_periodic_checkpoint() (in module fbpic.openpmd_diag)": [[7, "fbpic.openpmd_diag.set_periodic_checkpoint"]], "backtransformedfielddiagnostic (class in fbpic.openpmd_diag)": [[8, "fbpic.openpmd_diag.BackTransformedFieldDiagnostic"]], "backtransformedparticlediagnostic (class in fbpic.openpmd_diag)": [[8, "fbpic.openpmd_diag.BackTransformedParticleDiagnostic"]], "fielddiagnostic (class in fbpic.openpmd_diag)": [[8, "fbpic.openpmd_diag.FieldDiagnostic"]], "particlechargedensitydiagnostic (class in fbpic.openpmd_diag)": [[8, "fbpic.openpmd_diag.ParticleChargeDensityDiagnostic"]], "particlediagnostic (class in fbpic.openpmd_diag)": [[8, "fbpic.openpmd_diag.ParticleDiagnostic"]], "add_particle_bunch() (in module fbpic.lpa_utils.bunch)": [[9, "fbpic.lpa_utils.bunch.add_particle_bunch"]], "add_particle_bunch_file() (in module fbpic.lpa_utils.bunch)": [[9, "fbpic.lpa_utils.bunch.add_particle_bunch_file"]], "add_particle_bunch_from_arrays() (in module fbpic.lpa_utils.bunch)": [[9, "fbpic.lpa_utils.bunch.add_particle_bunch_from_arrays"]], "add_particle_bunch_gaussian() (in module fbpic.lpa_utils.bunch)": [[9, "fbpic.lpa_utils.bunch.add_particle_bunch_gaussian"]], "add_particle_bunch_openpmd() (in module fbpic.lpa_utils.bunch)": [[9, "fbpic.lpa_utils.bunch.add_particle_bunch_openPMD"]], "externalfield (class in fbpic.lpa_utils.external_fields)": [[10, "fbpic.lpa_utils.external_fields.ExternalField"]], "add_laser() (in module fbpic.lpa_utils.laser)": [[11, "fbpic.lpa_utils.laser.add_laser"]], "add_laser_pulse() (in module fbpic.lpa_utils.laser)": [[11, "fbpic.lpa_utils.laser.add_laser_pulse"]], "donutlikelaguerregausslaser (class in fbpic.lpa_utils.laser)": [[12, "fbpic.lpa_utils.laser.DonutLikeLaguerreGaussLaser"]], "fewcyclelaser (class in fbpic.lpa_utils.laser)": [[13, "fbpic.lpa_utils.laser.FewCycleLaser"]], "flattenedgaussianlaser (class in fbpic.lpa_utils.laser)": [[14, "fbpic.lpa_utils.laser.FlattenedGaussianLaser"]], "gaussianlaser (class in fbpic.lpa_utils.laser)": [[15, "fbpic.lpa_utils.laser.GaussianLaser"]], "laguerregausslaser (class in fbpic.lpa_utils.laser)": [[16, "fbpic.lpa_utils.laser.LaguerreGaussLaser"]], "fbpic.particles.particles (built-in class)": [[18, "fbpic.particles.Particles"]], "make_ionizable() (fbpic.particles.fbpic.particles.particles.particles method)": [[18, "fbpic.particles.fbpic.particles.Particles.Particles.make_ionizable"]], "track() (fbpic.particles.fbpic.particles.particles.particles method)": [[18, "fbpic.particles.fbpic.particles.Particles.Particles.track"]], "simulation (class in fbpic.main)": [[19, "fbpic.main.Simulation"]], "add_new_species() (fbpic.main.simulation method)": [[19, "fbpic.main.Simulation.add_new_species"]], "set_moving_window() (fbpic.main.simulation method)": [[19, "fbpic.main.Simulation.set_moving_window"]], "set_random_seed() (in module fbpic.utils.random_seed)": [[19, "fbpic.utils.random_seed.set_random_seed"]], "step() (fbpic.main.simulation method)": [[19, "fbpic.main.Simulation.step"]], "binomialsmoother (class in fbpic.fields.smoothing)": [[20, "fbpic.fields.smoothing.BinomialSmoother"]]}})
\ No newline at end of file
+Search.setIndex({"docnames": ["advanced/3d_visualization", "advanced/advanced", "advanced/boosted_frame", "advanced/parameter_scans", "advanced/profiling", "api_reference/api_reference", "api_reference/boost_converter", "api_reference/checkpoint_restart", "api_reference/diagnostics", "api_reference/lpa_utilities/beam", "api_reference/lpa_utilities/external_fields", "api_reference/lpa_utilities/laser", "api_reference/lpa_utilities/laser_profiles/donut_laguerre", "api_reference/lpa_utilities/laser_profiles/few_cycle", "api_reference/lpa_utilities/laser_profiles/flattened", "api_reference/lpa_utilities/laser_profiles/from_lasy_file", "api_reference/lpa_utilities/laser_profiles/gaussian", "api_reference/lpa_utilities/laser_profiles/laguerre", "api_reference/lpa_utilities/lpa_utilities", "api_reference/particles", "api_reference/simulation", "api_reference/smoothing", "example_input/boosted_frame_script", "example_input/ionization_script", "example_input/lwfa_script", "how_to_run", "index", "install/install_comet", "install/install_juwels", "install/install_lawrencium", "install/install_local", "install/install_perlmutter", "install/install_summit", "install/installation", "overview/overview", "overview/parallelisation", "overview/pic_algorithm"], "filenames": ["advanced/3d_visualization.rst", "advanced/advanced.rst", "advanced/boosted_frame.rst", "advanced/parameter_scans.rst", "advanced/profiling.rst", "api_reference/api_reference.rst", "api_reference/boost_converter.rst", "api_reference/checkpoint_restart.rst", "api_reference/diagnostics.rst", "api_reference/lpa_utilities/beam.rst", "api_reference/lpa_utilities/external_fields.rst", "api_reference/lpa_utilities/laser.rst", "api_reference/lpa_utilities/laser_profiles/donut_laguerre.rst", "api_reference/lpa_utilities/laser_profiles/few_cycle.rst", "api_reference/lpa_utilities/laser_profiles/flattened.rst", "api_reference/lpa_utilities/laser_profiles/from_lasy_file.rst", "api_reference/lpa_utilities/laser_profiles/gaussian.rst", "api_reference/lpa_utilities/laser_profiles/laguerre.rst", "api_reference/lpa_utilities/lpa_utilities.rst", "api_reference/particles.rst", "api_reference/simulation.rst", "api_reference/smoothing.rst", "example_input/boosted_frame_script.rst", "example_input/ionization_script.rst", "example_input/lwfa_script.rst", "how_to_run.rst", "index.rst", "install/install_comet.rst", "install/install_juwels.rst", "install/install_lawrencium.rst", "install/install_local.rst", "install/install_perlmutter.rst", "install/install_summit.rst", "install/installation.rst", "overview/overview.rst", "overview/parallelisation.rst", "overview/pic_algorithm.rst"], "titles": ["3D visualization using PyVista", "Advanced use", "Running boosted-frame simulations", "Performing parameter scans in parallel", "Profiling the code", "API reference", "Conversion to boosted-frame", "Checkpoints and restarts", "The openPMD diagnostics", "Beam initialization", "External fields", "Laser initialization", "Donut-like Laguerre-Gauss profile", "Few-cycle profile", "Flattened Gaussian profile", "Profile from a file produced by <code class=\"docutils literal notranslate\"><span class=\"pre\">lasy</span></code>", "Gaussian profile", "Laguerre-Gauss profile", "Laser-plasma utilities", "The Particles class", "The Simulation class", "Field smoothing", "Boosted-frame simulation of laser-wakefield acceleration", "Laser-wakefield acceleration with ionization", "Standard simulation of laser-wakefield acceleration", "How to run the code", "FBPIC documentation", "Installation on Comet (SDSC)", "Installation on JUWELS (JSC)", "Installation on Lawrencium (LBNL)", "Installation on a local computer", "Installation on Perlmutter (NERSC)", "Installation on Summit (OLCF)", "Installation", "Overview of the code", "Parallelization of FBPIC", "FBPIC algorithm & features"], "terms": {"The": [0, 2, 4, 5, 6, 7, 9, 10, 11, 12, 13, 14, 15, 16, 17, 22, 23, 24, 25, 26, 28, 30, 34, 35], "python": [0, 3, 4, 11, 22, 23, 24, 25, 27, 28, 29, 30, 31, 32], "packag": [0, 5, 25, 28, 30, 31, 35], "can": [0, 1, 2, 3, 4, 7, 8, 9, 10, 11, 15, 19, 20, 22, 23, 24, 25, 26, 28, 29, 30, 35, 36], "easili": [0, 18], "produc": [0, 2, 7, 8, 11, 36], "output": [0, 2, 4, 8, 20, 25, 28, 36], "data": [0, 2, 4, 7, 8, 20, 25], "instal": [0, 4, 25, 26], "openpmd": [0, 5, 7, 9, 19, 25, 29], "viewer": [0, 25, 29], "pip": [0, 25, 27, 28, 29, 30, 31, 32], "For": [0, 2, 4, 7, 9, 10, 11, 12, 14, 17, 20, 26, 27, 28, 29, 33, 35, 36], "simpl": [0, 2, 9], "static": [0, 2, 6], "you": [0, 1, 2, 4, 5, 9, 11, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 35, 36], "follow": [0, 2, 4, 7, 9, 11, 25, 26, 27, 28, 29, 30, 31, 32, 34, 35], "code": [0, 1, 2, 9, 11, 12, 13, 14, 16, 17, 20, 22, 24, 26, 30, 35, 36], "an": [0, 2, 3, 6, 8, 9, 10, 11, 12, 14, 17, 19, 20, 21, 22, 23, 25, 27, 28, 29, 30, 34, 35, 36], "exampl": [0, 2, 3, 4, 10, 11, 15, 28], "from": [0, 1, 4, 6, 7, 8, 9, 11, 12, 14, 16, 17, 19, 20, 22, 23, 24, 26, 28, 30, 35, 36], "openpmd_view": 0, "import": [0, 2, 4, 11, 22, 23, 24, 25, 28, 34, 36], "openpmdtimeseri": 0, "open": [0, 4, 20, 22, 23, 24, 26, 28, 29], "simul": [0, 1, 3, 5, 9, 10, 11, 12, 15, 17, 18, 19, 23, 26, 35, 36], "t": [0, 2, 8, 10, 11, 12, 13, 14, 15, 16, 17, 20, 22, 27, 31, 36], "sim_output": 0, "diag": [0, 2, 8, 22, 23, 24], "hdf5": [0, 9, 25], "creat": [0, 4, 8, 15, 19, 20, 22, 23, 24, 25, 27, 29, 31, 32], "plotter": 0, "set_background": 0, "white": 0, "retriev": [0, 8], "rho": [0, 8, 20, 22, 23], "field": [0, 2, 5, 7, 9, 11, 12, 13, 16, 17, 18, 19, 20, 22, 23, 24, 25, 26, 35, 36], "theta": [0, 9, 12, 14, 17, 20, 22, 23, 24, 36], "none": [0, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 19, 20, 22, 24], "argument": [0, 2, 10, 20], "construct": 0, "cartesian": [0, 36], "grid": [0, 8, 9, 10, 11, 20, 35], "cylindr": [0, 15, 20, 26], "meta": 0, "get_field": 0, "iter": [0, 4, 7, 8, 9, 20, 22, 23, 24, 35], "1": [0, 2, 4, 6, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 20, 21, 22, 23, 24, 25, 28, 29, 31, 32, 36], "which": [0, 2, 4, 5, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 25, 30, 35, 36], "deposit": [0, 20, 35, 36], "uniformgrid": 0, "dimens": [0, 15], "shape": [0, 10, 20], "origin": [0, 2, 7, 15, 26, 36], "xmin": 0, "1e6": 0, "ymin": 0, "zmin": [0, 20, 22, 23, 24], "space": [0, 2, 8, 9, 11, 18, 20, 26, 35], "dx": 0, "dy": 0, "dz": 0, "point_data": 0, "valu": [0, 2, 3, 7, 8, 10, 11, 19, 20, 27, 29, 31, 32, 36], "flatten": [0, 11], "order": [0, 2, 3, 4, 6, 10, 11, 12, 14, 15, 17, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34, 36], "f": [0, 10, 12, 17], "add": [0, 4, 9, 18, 20, 22, 23, 24, 28, 29], "cutoff": 0, "via": [0, 28, 29, 30, 35], "clim": 0, "sinc": [0, 2, 3, 7, 15, 23, 27], "otherwis": [0, 8, 9, 15, 20], "show": [0, 2, 20, 25], "onli": [0, 2, 3, 4, 8, 9, 11, 13, 15, 20, 22, 24, 25, 28, 32, 35, 36], "small": [0, 4, 11, 20, 35], "densiti": [0, 2, 6, 9, 20, 22, 23, 24, 35, 36], "spike": 0, "add_volum": 0, "0": [0, 2, 6, 8, 9, 11, 12, 13, 14, 15, 16, 17, 19, 20, 22, 23, 24, 28, 29, 30, 31, 32, 36], "4e6": 0, "opac": 0, "sigmoid": 0, "cmap": 0, "viridi": 0, "mapper": 0, "gpu": [0, 3, 10, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 35], "show_scalar_bar": 0, "fals": [0, 2, 3, 9, 20, 21, 22, 23, 24, 31], "A": [0, 6, 8, 9, 19, 20, 22, 23, 24, 30, 31, 35], "good": [0, 2, 7, 20, 22, 23, 24], "start": [0, 7, 15, 19, 26, 27, 28, 29], "camera": 0, "posit": [0, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 20, 22, 23, 24], "three": 0, "ar": [0, 2, 4, 5, 7, 8, 9, 10, 11, 12, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 30, 31, 35, 36], "focu": [0, 9, 11, 13, 14, 16], "up": [0, 2, 5, 7, 22, 23, 25], "vector": [0, 11, 13, 14, 16], "viewport": 0, "camera_posit": 0, "74": 0, "32": [0, 20, 22, 23, 24, 25, 35], "51": 0, "88": 0, "lwfa": 0, "thi": [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 33, 35, 36], "section": [1, 2, 5, 11, 18, 22, 25, 26, 27, 30, 33, 34, 35], "contain": [1, 2, 3, 4, 6, 7, 8, 9, 10, 11, 13, 19, 20, 23, 28], "sever": [1, 3, 6, 7, 19, 26, 36], "tip": 1, "help": [1, 20, 22, 23, 24], "get": [1, 26, 35], "more": [1, 2, 4, 7, 9, 11, 12, 14, 16, 17, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 35, 36], "perform": [1, 2, 20, 22, 23, 24, 28, 31, 35, 36], "faster": [1, 20, 25, 26, 29, 35, 36], "result": [1, 8, 15, 20, 21, 35], "topic": [1, 34], "profil": [1, 22, 23, 24], "paramet": [1, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 19, 20, 21, 22, 23, 24, 35], "scan": [1, 20, 35], "parallel": [1, 20, 26, 34], "run": [1, 3, 4, 7, 10, 20, 22, 23, 24, 26, 35, 36], "boost": [1, 5, 9, 10, 11, 19, 20, 25, 26], "frame": [1, 5, 9, 10, 11, 12, 13, 14, 16, 17, 19, 20, 25, 26], "3d": [1, 25, 36], "visual": 1, "pyvista": [1, 25], "page": [2, 4, 11, 26, 29, 33], "give": [2, 20, 34], "quick": 2, "overview": [2, 26], "speed": [2, 8, 20, 23, 24], "certain": 2, "type": [2, 4, 6, 11, 20, 22, 23, 24, 25, 27, 28, 29, 30, 31, 32], "magnitud": [2, 36], "after": [2, 10, 11, 15, 20, 28, 35], "explain": [2, 11, 15, 28, 33], "case": [2, 3, 4, 7, 8, 9, 11, 13, 19, 20, 35, 36], "laser": [2, 3, 5, 6, 7, 12, 13, 14, 15, 16, 17, 19, 25, 26, 35, 36], "wakefield": [2, 17, 18, 25, 26, 36], "acceler": [2, 18, 20, 25, 26, 35, 36], "discuss": 2, "how": [2, 3, 11, 20, 26, 27, 28, 30, 33, 34, 35], "handl": [2, 35], "most": [2, 26, 35], "aspect": 2, "fbpic": [2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 33, 34], "us": [2, 3, 5, 6, 7, 8, 9, 10, 11, 14, 15, 19, 20, 22, 23, 24, 25, 26, 28, 29, 30, 32, 33, 34, 35, 36], "understand": [2, 26], "instead": [2, 3, 8, 9, 10, 13, 15, 19, 25, 28, 30, 35, 36], "refer": [2, 19, 25, 26], "laboratori": 2, "short": [2, 13, 20, 34], "consist": [2, 4, 9, 10, 11, 18, 28, 35, 36], "differ": [2, 3, 8, 13, 19, 25, 33, 35, 36], "lorentz": [2, 6, 8, 9, 10, 11, 20], "move": [2, 6, 7, 8, 11, 20, 22, 23, 24, 26], "same": [2, 3, 4, 6, 7, 12, 17, 19, 20, 21, 25, 27, 29, 31, 32, 35, 36], "direct": [2, 9, 11, 12, 13, 14, 15, 16, 17, 20, 21, 22, 23, 24, 25, 28, 35, 36], "i": [2, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 34, 35, 36], "character": 2, "its": [2, 8, 9, 11, 16, 18, 19, 20, 26, 35], "factor": [2, 6, 8, 9, 10, 11, 20], "gamma_b": 2, "when": [2, 4, 7, 9, 10, 11, 12, 13, 15, 16, 17, 20, 22, 24, 25, 27, 28, 32, 35, 36], "chang": [2, 8, 22, 29], "time": [2, 4, 6, 7, 8, 9, 10, 11, 12, 13, 15, 16, 17, 19, 22, 23, 24, 27, 28, 29, 31, 35], "computation": [2, 22, 23, 24, 35], "favor": 2, "In": [2, 3, 4, 7, 9, 10, 11, 12, 13, 17, 19, 20, 25, 26, 27, 28, 29, 30, 31, 32, 34, 35, 36], "stretch": 2, "ha": [2, 6, 8, 9, 10, 12, 17, 20, 27, 28, 29, 32, 35, 36], "lower": [2, 15, 35], "frequenc": [2, 11, 13, 16, 21, 35], "allow": [2, 4, 9, 10, 11, 18, 20, 22, 36], "loop": [2, 7, 10], "larger": [2, 23, 36], "step": [2, 4, 10, 20, 22, 23, 24, 27, 28, 30, 36], "cell": [2, 8, 9, 20, 22, 23, 24, 26, 29, 35, 36], "size": [2, 7, 9, 14, 25, 35], "z": [2, 6, 9, 10, 11, 12, 13, 14, 15, 16, 17, 20, 21, 22, 23, 24, 35, 36], "than": [2, 7, 20, 21, 23, 25, 26, 35], "while": [2, 3, 28, 36], "still": [2, 8, 9, 15, 35], "resolv": [2, 12, 17, 20, 36], "precis": [2, 7, 8, 11, 12, 14, 16, 17, 20, 23, 36], "delta": [2, 11, 16, 36], "z_": [2, 14], "approx": [2, 20], "2": [2, 4, 6, 9, 10, 11, 12, 13, 14, 15, 16, 17, 19, 20, 22, 23, 24, 25, 27, 28, 29, 35, 36], "t_": 2, "plasma": [2, 5, 6, 17, 20, 22, 23, 24, 26, 35, 36], "shorter": 2, "relativist": [2, 9, 18, 22, 26, 36], "toward": [2, 12, 13, 14, 16, 17], "impli": [2, 36], "need": [2, 4, 7, 8, 10, 22, 23, 24, 25, 28, 29, 30, 32], "propag": [2, 6, 9, 11, 12, 13, 14, 15, 16, 17, 35, 36], "through": [2, 11, 26, 30], "similarli": [2, 35], "These": [2, 8, 35, 36], "repres": [2, 19, 20, 36], "below": [2, 5, 8, 9, 10, 12, 17, 18, 19, 20, 22, 23, 24, 25, 27, 33, 35, 36], "On": [2, 3, 25, 30], "whole": [2, 20], "take": [2, 6, 9, 20, 22, 23, 24, 28, 35, 36], "account": [2, 6, 9, 11, 12, 16, 17, 20, 32, 36], "longer": [2, 19, 23, 24], "timestep": [2, 8, 10, 18, 20, 22, 23, 24, 36], "requir": [2, 7, 11, 12, 17, 19, 20, 22, 23, 24, 25, 28, 30, 35, 36], "reduc": [2, 25, 35], "n_": 2, "frac": [2, 11, 12, 13, 14, 16, 17], "beta_b": 2, "howev": [2, 3, 10, 11, 35, 36], "abov": [2, 6, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 20, 23, 25, 27, 28, 29, 30, 32, 35, 36], "formula": [2, 6, 11, 12, 13, 14, 16, 17], "approxim": [2, 35], "calcul": [2, 6, 9, 20, 22, 23, 24, 26], "correct": [2, 20, 28, 35], "practic": [2, 35, 36], "see": [2, 4, 5, 8, 10, 12, 13, 14, 17, 18, 20, 22, 23, 24, 25, 26, 27, 29, 30, 35, 36], "note": [2, 10, 11, 15, 19, 20, 25, 28, 32, 35], "also": [2, 11, 19, 20, 22, 23, 24, 25, 26, 28, 30, 32, 35, 36], "theori": 2, "optim": 2, "close": [2, 14, 20, 26, 36], "gamma_": 2, "wake": 2, "e": [2, 3, 4, 6, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 18, 19, 20, 22, 23, 24, 25, 28, 30, 32, 35, 36], "associ": [2, 23], "phase": [2, 9, 11, 12, 13, 14, 16, 17], "veloc": [2, 6, 11, 22], "group": [2, 22], "puls": [2, 12, 13, 14, 16, 17, 18], "setup": [2, 4, 20, 25, 28], "due": [2, 11, 35, 36], "limit": [2, 13, 19, 20, 25, 26, 35, 36], "spatial": [2, 35, 36], "tempor": [2, 11, 16], "detail": [2, 4, 11, 20, 36], "gener": [2, 9, 20, 26, 33, 35, 36], "paper": [2, 26, 36], "read": [2, 14, 15, 25, 26, 33, 34], "descript": [2, 26], "speedup": 2, "higher": [2, 35, 36], "becaus": [2, 7, 8, 10, 13, 15, 35, 36], "each": [2, 3, 4, 7, 8, 9, 10, 11, 15, 18, 19, 20, 21, 25, 28, 29, 32, 35, 36], "macroparticl": [2, 6, 9, 19, 20, 22, 23, 36], "typic": [2, 6, 19, 20, 22, 23, 24, 29, 31, 35, 36], "particl": [2, 5, 6, 7, 9, 10, 18, 20, 22, 23, 24, 25, 26, 35, 36], "least": [2, 20, 26], "keep": 2, "per": [2, 3, 4, 6, 7, 8, 9, 11, 20, 22, 23, 24, 25, 27, 28, 29, 31, 32, 35, 36], "self": [2, 9, 10, 11, 18, 31, 36], "inject": [2, 7, 18, 20, 36], "less": [2, 20, 35, 36], "beam": [2, 12, 17, 18, 20, 35, 36], "therefor": [2, 3, 4, 18, 25, 35], "statist": 2, "evalu": [2, 19, 36], "g": [2, 3, 4, 6, 7, 8, 9, 11, 17, 18, 19, 20, 25, 28, 30, 32, 35, 36], "emitt": [2, 9, 36], "charg": [2, 8, 9, 18, 19, 20, 23, 26, 35, 36], "extrem": 2, "compar": [2, 26, 36], "total": [2, 6, 8, 12, 17], "mai": [2, 3, 8, 17, 19, 36], "occur": [2, 15, 35], "all": [2, 3, 6, 7, 8, 9, 10, 11, 19, 20, 22, 23, 24, 25, 27, 36], "involv": 2, "occasion": 2, "make": [2, 3, 8, 19, 20, 22, 23, 24, 26, 32, 36], "sure": [2, 3, 8, 20, 32, 36], "properli": [2, 12, 17, 20, 34], "converg": 2, "ion": [2, 19, 20, 22, 23], "essenti": 2, "motionless": 2, "current": [2, 7, 8, 19, 20, 35, 36], "boldsymbol": [2, 11, 12, 13, 14, 16, 17], "j": [2, 8, 14, 27, 29, 31, 32], "thei": [2, 25, 35, 36], "neglig": [2, 35], "electron": [2, 6, 8, 9, 18, 19, 20, 22, 23, 24, 36], "reason": [2, 7], "algorithm": [2, 4, 26, 34, 35], "updat": [2, 9, 11, 35], "featur": [2, 3, 10, 15, 25, 26, 34], "often": [2, 7], "omit": 2, "save": [2, 7, 9, 23], "comput": [2, 3, 4, 19, 20, 23, 25, 31, 32, 33, 35, 36], "And": [2, 4, 25], "fact": [2, 13, 32, 36], "initialize_ion": [2, 20], "set": [2, 3, 4, 5, 9, 10, 11, 15, 19, 20, 23, 25, 28, 30, 35, 36], "default": [2, 8, 9, 11, 12, 13, 14, 15, 16, 17, 20, 25, 30, 35], "valid": [2, 11, 19], "do": [2, 4, 11, 19, 25, 30], "non": [2, 17, 36], "includ": [2, 4, 8, 11, 12, 16, 17, 26, 36], "them": [2, 6, 11, 20, 34, 35, 36], "either": [2, 8, 9, 10, 11, 12, 13, 14, 16, 17, 20, 25, 35], "flag": [2, 20], "true": [2, 4, 9, 11, 20, 22, 23, 24, 35], "ad": [2, 8, 9, 10, 11, 20, 35], "separ": [2, 3, 19, 35], "add_new_speci": [2, 19, 20, 22, 23, 24, 36], "wavelength": [2, 11, 12, 13, 14, 15, 16, 17, 22], "etc": [2, 7, 9, 11, 20], "known": 2, "correspond": [2, 4, 6, 8, 9, 10, 11, 16, 18, 19, 20, 23, 24], "fortun": 2, "function": [2, 5, 7, 9, 10, 15, 18, 19, 20, 22, 23, 24, 25, 36], "class": [2, 5, 6, 8, 10, 12, 13, 14, 15, 16, 17, 18, 21], "convers": [2, 5, 10, 22], "automat": [2, 9, 10, 11, 20], "so": [2, 7, 10, 11, 12, 13, 15, 17, 19, 20, 25, 26, 30, 35], "user": [2, 4, 8, 10, 22, 25, 27, 29, 35, 36], "pass": [2, 19, 20, 21, 35], "along": [2, 9, 10, 20, 22, 23, 24, 36], "instanc": [2, 10, 11, 19, 20, 25, 32, 36], "main": [2, 5, 20, 22, 23, 24, 26, 30], "box": [2, 7, 11, 15, 20, 22, 23, 24, 35], "pleas": [2, 10, 25, 26, 32, 35], "look": [2, 5, 11], "document": [2, 8, 12, 17, 18, 22, 23, 24, 25], "api": [2, 25, 26], "support": [2, 8, 9, 11, 25, 26], "If": [2, 4, 5, 7, 8, 10, 11, 12, 13, 14, 16, 17, 19, 20, 21, 25, 26, 28, 30], "lpa_util": [2, 6, 9, 10, 11, 12, 13, 14, 15, 16, 17, 22, 23, 24], "boosted_fram": [2, 6, 22], "boostconvert": [2, 6, 9, 22], "implement": [2, 11, 19, 22, 23, 24, 25, 26, 28, 35], "common": [2, 35, 36], "quantiti": [2, 6, 8, 11, 20], "addition": 2, "provid": [2, 3, 8, 11, 12, 13, 14, 16, 17, 18, 27, 29], "method": [2, 9, 11, 15, 19, 20, 22, 35], "script": [2, 3, 4, 7, 11, 20, 22, 23, 24, 27, 28, 29, 31, 32], "although": [2, 8, 9, 35, 36], "desir": 2, "have": [2, 4, 7, 8, 9, 10, 11, 15, 19, 20, 22, 23, 24, 26, 35, 36], "usual": [2, 4, 11], "easier": 2, "interpret": 2, "fly": [2, 8], "thu": [2, 9, 10, 11, 13, 16, 19, 25, 36], "directli": [2, 4, 8, 11, 19, 20, 28], "openpmd_diag": [2, 7, 8, 22, 23, 24], "backtransformedfielddiagnost": [2, 8, 22], "backtransformedparticlediagnost": [2, 8, 22], "regular": [2, 7, 35], "fielddiagnost": [2, 8, 22, 23, 24], "particlediagnost": [2, 8, 22, 23, 24], "diagnost": [2, 5, 7, 22, 23, 24, 36], "By": [2, 8, 9, 10, 20, 36], "store": [2, 7, 19, 23], "folder": [2, 4, 20, 28], "lab_diag": 2, "raw": 2, "simultan": [2, 4, 35], "between": [2, 3, 7, 8, 9, 20, 22, 25, 28, 35], "file": [2, 7, 8, 9, 11, 19, 23, 24, 25, 27, 29, 31, 32], "fill": [2, 7], "progress": [2, 11, 20], "right": [2, 8, 11, 12, 13, 14, 16, 17, 20, 23, 24], "hand": [2, 7], "side": [2, 4, 11], "left": [2, 3, 8, 11, 12, 13, 14, 16, 17, 20, 23, 24, 35], "chosen": [2, 15, 19, 36], "insuffici": 2, "some": [2, 3, 8, 11, 25], "incomplet": 2, "being": [2, 6, 10, 15, 29], "zero": [2, 15], "potenti": [2, 10, 11, 13, 14, 16, 35], "affect": [2, 20], "degrad": 2, "suppress": [2, 22], "galilean": [2, 20, 22, 26], "here": [2, 3, 4, 11, 15, 26, 28, 29, 30, 36], "inform": [2, 4, 7, 8, 19, 20, 22, 23, 24, 25, 26, 27, 28, 29, 35], "simpli": [2, 4], "v_comov": [2, 20, 22], "v_": 2, "comov": [2, 20], "c": [2, 6, 11, 12, 13, 14, 15, 16, 17, 22, 23, 24, 25, 27, 29, 30, 31, 32, 36], "sqrt": [2, 6, 11, 12, 13, 17, 22], "again": [2, 7, 29], "effect": [2, 6, 9, 20, 35, 36], "where": [2, 3, 4, 8, 9, 11, 12, 13, 14, 16, 17, 20, 22, 23, 24, 25, 27, 29, 31, 32, 36], "r_": 2, "term": [2, 11, 12, 16, 17, 35], "condit": 2, "met": 2, "our": 2, "knowledg": 2, "exist": [2, 4, 7, 11], "solut": 2, "doe": [2, 4, 9, 10, 17, 23, 26, 35, 36], "check": [2, 28, 35], "whether": [2, 9, 11, 20, 21, 22, 23, 24, 27], "given": [2, 4, 7, 9, 11, 12, 13, 16, 17, 20], "respons": [2, 17, 35], "ensur": [2, 9, 20, 35], "we": [2, 4, 8, 9, 10, 26, 35], "interact": [2, 6, 22, 23, 24, 28, 36], "defin": [2, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 19, 22, 25, 36], "window": [2, 6, 7, 8, 11, 20, 22, 23, 24, 26], "length": [2, 6, 9, 13, 22, 23, 24], "l_": 2, "cross": [2, 20, 35], "beta_": 2, "would": [2, 15, 35], "consequ": 2, "those": 2, "new": [2, 7, 9, 11, 19, 20, 23, 26, 31, 32], "gamma": [2, 6, 8], "beta": 2, "expos": 2, "interaction_tim": [2, 6, 22], "slide": [2, 6, 22, 23, 24], "across": [2, 6, 22, 23, 24, 25, 35], "initi": [2, 6, 7, 8, 10, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 36], "addit": [2, 11, 12, 16, 17, 20, 25, 26, 30], "access": [2, 4, 5, 22, 23, 24, 26, 29, 35], "sim": [2, 4, 7, 8, 9, 10, 11, 15, 22, 23, 24, 36], "dt": [2, 20, 22, 23, 24], "figur": 2, "expect": [2, 13, 28], "reduct": 2, "let": 2, "assum": [2, 6, 11, 12, 13, 14, 16, 17, 20, 23], "100": [2, 22, 23, 24], "mu": 2, "m": [2, 4, 8, 9, 11, 12, 14, 17, 20, 22, 23, 24, 26, 30, 31, 36], "12": [2, 25, 29], "mm": [2, 15], "10": [2, 8, 9, 20, 22, 23, 24, 28, 29], "24": [2, 28, 29], "3": [2, 9, 11, 15, 20, 22, 24, 28, 29, 32, 36], "match": [2, 20, 35], "42": 2, "highlight": 2, "two": [2, 4, 8, 11, 20, 28, 29, 34], "choos": [2, 30, 36], "first": [2, 4, 8, 11, 20, 22, 25, 26, 30, 32], "seen": 2, "scale": [2, 25, 35, 36], "law": 2, "ll": 2, "second": [2, 6, 8, 9, 11, 12, 13, 14, 15, 16, 17, 20, 22, 23, 24], "optimum": 2, "befor": [2, 7, 8, 15, 20, 23, 24, 25, 29, 32], "slow": [2, 8], "down": [2, 8, 22], "As": [2, 15, 20, 25, 28, 35, 36], "minim": [2, 9, 20, 35], "revers": 2, "too": [2, 11, 35], "high": [2, 20, 31, 35], "advis": [2, 28], "fulfil": 2, "maximum": [2, 11, 12, 13, 14, 16, 17, 19, 20], "effici": [2, 3, 35, 36], "next": [2, 4, 35], "basic": [2, 20, 26, 34], "been": [2, 8, 9, 15, 20, 27, 29], "cover": 2, "alreadi": [2, 23], "previou": [2, 23, 24], "tricki": 2, "restrict": 2, "ourselv": 2, "homogen": 2, "fundament": 2, "lambda_": 2, "l": [2, 6, 12, 14, 17], "p": [2, 11, 12, 17, 27, 28, 29, 32], "period": [2, 7, 8, 10, 19, 20, 22, 23, 24], "oscil": [2, 11, 12, 13, 14, 16, 17], "tau_": [2, 13], "final": [2, 8, 11, 28], "itself": 2, "normal": [2, 6, 9, 11, 13, 14, 16, 20, 28], "low": [2, 21], "equal": 2, "increas": [2, 12, 14, 17, 20, 23, 24, 25, 36], "propto": [2, 14], "contract": 2, "wave": [2, 11, 12, 16, 17, 20, 22, 23, 24, 35, 36], "becom": [2, 4, 13, 25, 35], "appar": 2, "supra": 2, "lumin": 2, "sub": [2, 35], "critic": 2, "discrep": 2, "both": [2, 4, 11, 26, 27, 35], "caus": [2, 30, 35], "diverg": [2, 20], "approach": [2, 13], "longitudin": [2, 9, 20, 35], "shown": [2, 35], "decreas": [2, 35, 36], "well": [2, 13, 19, 26, 35], "gtrsim": 2, "should": [2, 4, 7, 8, 9, 10, 11, 12, 13, 14, 16, 17, 19, 20, 21, 22, 25, 27, 28, 29, 30, 32, 35, 36], "alwai": [2, 7, 8, 9, 11], "much": [2, 26, 35], "smaller": [2, 35], "satisfi": [2, 11, 20], "cluster": [3, 4, 7, 27, 29, 31, 32, 33], "singl": [3, 19, 20, 22, 23, 24, 25, 28, 35], "node": [3, 25, 27, 28, 29, 31, 32, 35], "sometim": [3, 9, 25, 28, 30, 35, 36], "pic": [3, 4, 7, 10, 20, 23, 24, 26, 35], "part": [3, 4, 11, 16, 20], "intens": [3, 11, 12, 13, 14, 15, 16, 17], "launch": [3, 4, 20, 32, 35], "possibl": [3, 8, 20, 25], "other": [3, 7, 8, 9, 11, 20, 26, 31, 33, 35, 36], "idl": 3, "command": [3, 4, 25, 28, 30], "mpirun": [3, 4, 20, 25, 29], "wherebi": 3, "mpi": [3, 7, 20, 22, 23, 24, 25, 27, 28, 30, 32, 35], "rank": [3, 4, 7, 8, 20, 32], "activ": [3, 19, 20, 23, 25, 28, 29, 31, 32], "use_all_mpi_rank": [3, 20], "object": [3, 5, 6, 7, 8, 9, 10, 11, 19, 20, 22, 23, 24, 25, 26, 35], "instruct": [3, 4, 25, 29, 30, 33], "one": [3, 4, 7, 8, 9, 11, 13, 17, 20, 22, 25, 28, 29, 32, 35, 36], "structur": [3, 9, 11, 22, 23, 24], "input": [3, 7, 11, 20, 22, 23, 24, 27, 29, 31, 32], "specifi": [3, 7, 8, 10, 20], "vari": [3, 12, 17, 36], "parametric_script": 3, "py": [3, 4, 22, 23, 24, 25, 27, 28, 29, 31, 32], "find": [4, 30], "domin": [4, 36], "your": [4, 20, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32, 36], "particular": [4, 13, 20, 33], "dump": 4, "quickli": 4, "cprofil": 4, "": [4, 8, 10, 13, 15, 25, 26, 27, 35, 36], "fbpic_script": [4, 25, 27, 29, 31, 32], "log": [4, 13, 29, 32, 36], "editor": 4, "analysi": [4, 36], "graphic": 4, "interfac": [4, 30, 35], "binari": [4, 31], "o": [4, 25, 29], "prof": 4, "snakeviz": 4, "tool": 4, "nvprof": 4, "nsight": 4, "system": [4, 25, 29, 31, 36], "standard": [4, 13, 20, 25, 28, 35, 36], "nsy": 4, "stat": 4, "print": [4, 20, 22, 23, 24], "termin": [4, 22, 23, 24], "devic": [4, 25, 28], "host": [4, 26], "nvvp": 4, "click": [4, 22, 23, 24], "select": [4, 8, 9, 22, 24, 25, 30, 35], "sy": 4, "navig": 4, "ran": 4, "end": [4, 7, 9, 11, 23, 24], "qdrep": 4, "machin": [4, 25, 30], "wa": [4, 15, 18, 26, 28], "mean": [4, 9, 20, 28, 36], "remot": 4, "transfer": [4, 35], "local": [4, 20, 29, 33, 35], "cuda": [4, 20, 25, 30, 31, 32], "toolkit": 4, "veri": [4, 7, 26, 36], "larg": [4, 15, 20, 22, 23, 24, 26, 35, 36], "recommend": [4, 8, 9, 19, 20, 26, 35], "number": [4, 6, 7, 8, 9, 12, 14, 15, 17, 19, 20, 21, 22, 23, 24, 25, 32, 35, 36], "1000": [4, 36], "One": [4, 6, 11], "wai": [4, 9, 11, 13, 20], "write": [4, 8, 22, 23, 24], "process": [4, 7, 19, 25, 28, 35], "modifi": [4, 7, 10, 11, 15, 20, 22, 23, 24, 25], "line": [4, 29, 31], "begin": [4, 7, 15, 22, 23, 24, 25, 26], "mpi4pi": [4, 25, 27, 28, 29, 30, 31, 35], "comm_world": 4, "comm": [4, 8, 19, 22, 23, 24], "replac": [4, 15, 25, 27, 29, 30, 31, 32], "n_step": [4, 22, 23, 24], "just": 4, "compil": [4, 10], "pr": 4, "enabl": [4, 25, 28], "disabl": [4, 25], "dump_stat": 4, "cpu_": 4, "d": [4, 26], "txt": 4, "w": [4, 9, 14, 32, 36], "output_fil": 4, "stdout": 4, "print_stat": 4, "sort": 4, "__stdout__": 4, "Then": [4, 27, 28, 29, 30, 31, 32], "4": [4, 8, 9, 13, 20, 22, 23, 24, 25, 27, 28, 29, 31, 35], "np": [4, 10, 22, 23, 24, 29], "gpu_": 4, "q": [4, 9, 13, 20, 22, 23, 24], "name": [4, 8, 9, 11, 16, 25, 27, 29, 31, 32], "depend": [4, 12, 17, 20, 25, 28, 30, 35], "distribut": [4, 6, 9, 14, 20, 25, 30], "openmpi": [4, 27, 30], "ompi_comm_world_rank": 4, "mpich": [4, 28, 29], "pmi_rank": 4, "unsur": 4, "printenv": 4, "grep": 4, "load": [4, 7, 9, 23, 24, 27, 29, 31, 32], "timelin": 4, "within": [4, 8, 10, 13, 20, 25, 27, 29, 31, 32, 35], "multipl": [4, 20, 22, 23, 24, 25, 35], "brows": 4, "describ": [5, 11, 27, 35], "checkpoint": [5, 23, 24], "restart": [5, 23, 24], "util": [5, 20, 23], "smooth": [5, 20], "specif": [5, 8, 18, 33], "index": 5, "search": 5, "bar": [5, 20], "websit": 5, "gamma0": [6, 9, 22], "sourc": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 20, 21, 26, 29, 30, 31, 32], "float": [6, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 20, 22], "boost_particle_arrai": 6, "x": [6, 8, 9, 10, 11, 12, 13, 14, 16, 17, 20, 22, 28], "y": [6, 9, 10, 20, 22, 28], "ux": [6, 8, 9], "ui": [6, 9], "uz": [6, 8, 9, 22, 24], "inv_gamma": 6, "transform": [6, 9, 20, 22, 36], "fix": [6, 20], "t_boost": 6, "without": [6, 7, 19, 25, 35], "ani": [6, 7, 15, 20, 22, 23, 24, 32, 36], "electromagnet": [6, 20, 22, 23, 24, 35, 36], "bunch": [6, 9, 22, 26], "1darrai": [6, 22], "meter": [6, 8, 9, 11, 12, 13, 14, 16, 17, 20, 22, 23, 24], "lab": [6, 8, 9, 10, 11, 12, 13, 14, 16, 17, 19, 20, 22, 26, 29], "element": [6, 19, 22], "dimensionless": [6, 9, 11, 12, 13, 14, 16, 17, 20], "momenta": [6, 9, 20], "invers": [6, 35], "return": [6, 9, 10, 19, 20, 22, 23, 24], "arrai": [6, 7, 9, 10, 19, 20, 22, 25], "copropag_dens": 6, "lab_frame_var": 6, "beta_object": 6, "convert": [6, 10, 11, 20, 22], "list": [6, 7, 8, 10, 11, 19, 20, 26], "copropag": [6, 36], "n": [6, 9, 14, 19, 20, 22, 23, 24, 25, 27, 31, 32], "beta0": 6, "option": [6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 19, 20, 30], "whose": [6, 15], "copropag_length": 6, "warn": 6, "transvers": [6, 9, 12, 14, 17, 20, 22], "motion": [6, 9], "l_interact": [6, 22, 23, 24], "l_window": 6, "v_window": [6, 22, 23, 24], "onc": [6, 25, 27, 29], "v_plasma": 6, "t_interact": [6, 22, 23, 24], "longitudinal_momentum": 6, "u_z": 6, "static_dens": 6, "static_length": 6, "v": [6, 20, 22, 23, 24], "wavenumb": 6, "k": [6, 20], "long": 7, "later": 7, "risk": 7, "crash": [7, 30], "finit": [7, 20, 22, 23, 24, 25, 26, 36], "walltim": 7, "hpc": [7, 27, 33, 35], "thank": [7, 36], "set_periodic_checkpoint": [7, 23, 24], "checkpoint_dir": 7, "format": 7, "directori": [7, 8, 9, 27, 29, 30, 31, 32], "subdirectori": [7, 27, 29, 31], "b": [7, 8, 11, 22, 36], "processor": [7, 19], "nb": [7, 22, 24, 25], "regist": 7, "written": [7, 8, 19, 20], "wherea": 7, "integ": [7, 9, 19, 20, 21, 36], "string": [7, 8, 9, 10, 11, 15, 19, 20], "path": [7, 8, 9, 15, 27, 28], "restart_from_checkpoint": [7, 23, 24], "overwritten": 7, "boundari": [7, 20, 22, 23, 24, 35], "presenc": 7, "antenna": [7, 11, 15, 22], "success": [7, 8], "rather": 7, "scratch": [7, 29, 31], "call": [7, 10, 11], "infer": 7, "latest": [7, 23, 24, 27], "avail": [7, 8, 11, 25, 29, 30], "dure": [8, 11, 25], "form": [8, 9, 10, 20, 21], "remov": 8, "attribut": [8, 10], "fldobject": [8, 22], "fieldtyp": [8, 10, 22], "write_dir": 8, "iteration_min": 8, "iteration_max": 8, "inf": [8, 20], "dt_period": [8, 22], "int": [8, 9, 12, 13, 14, 16, 17, 19, 20, 21, 22, 23, 24], "whenev": 8, "divis": 8, "physic": [8, 9, 11, 15, 19, 20, 25, 26, 35, 36], "point": [8, 15, 36], "boundarycommun": [8, 19], "gather": [8, 10, 36], "proc": 8, "guard": [8, 20, 35], "own": 8, "indic": [8, 9, 12, 13, 14, 16, 17, 21], "posix": 8, "work": [8, 20, 28, 34, 35], "inclus": 8, "exclus": 8, "speci": [8, 9, 10, 19, 20, 22, 23, 24], "particle_data": 8, "momentum": 8, "weight": [8, 9, 36], "subsampling_fract": 8, "dictionari": [8, 9, 19, 20, 21], "elec": [8, 23, 24], "assign": 8, "commun": [8, 20, 22, 23, 24, 25, 28, 35], "respect": [8, 11, 12, 13, 14, 16, 17, 20, 22, 26], "turn": [8, 11], "off": [8, 20, 22, 23, 24, 29, 35], "track": [8, 19, 22, 23, 24], "id": [8, 19, 23, 24], "dict": [8, 9, 20], "rule": [8, 9], "micron": [8, 9, 11, 12, 13, 14, 16, 17], "mc": [8, 9], "5": [8, 9, 11, 15, 22, 23, 24, 32], "subsampl": 8, "probabl": 8, "particlechargedensitydiagnost": [8, 23], "dataset": 8, "similar": [8, 10, 28, 35], "recontruct": 8, "zmin_lab": 8, "zmax_lab": 8, "v_lab": 8, "dt_snapshots_lab": 8, "ntot_snapshots_lab": 8, "gamma_boost": [8, 10, 11, 20, 22], "t_min_snapshots_lab": 8, "t_max_snapshots_lab": 8, "seri": 8, "snapshot": [8, 22], "virtual": [8, 11, 25, 35], "edg": [8, 20], "interv": [8, 22, 35], "accumul": 8, "memori": [8, 35, 36], "disk": [8, 22], "backward": [8, 9, 11, 15, 20], "stagger": [8, 36], "awar": [8, 25, 32, 36], "error": [8, 30], "moreov": 8, "brought": 8, "spectral": [8, 11, 20, 26], "real": [8, 36], "former": [8, 9], "boostedfielddiagnost": 8, "renam": 8, "compat": [8, 9, 20, 30], "extract": [8, 9], "about": [8, 19, 20, 35], "boostedparticlediagnost": 8, "variou": 9, "gaussian": [9, 12, 13, 17, 20, 22, 23, 24], "flat": [9, 14], "top": [9, 20], "add_particle_bunch": [9, 22], "p_zmin": [9, 20, 22, 23, 24], "p_zmax": [9, 20, 22, 24], "p_rmin": [9, 20], "p_rmax": [9, 20, 22, 24], "p_nr": [9, 20, 22, 23, 24, 36], "p_nz": [9, 20, 22, 23, 24], "p_nt": [9, 20, 22, 23, 24], "dens_func": [9, 20, 22, 23, 24], "forward": [9, 11, 28], "z_injection_plan": 9, "initialize_self_field": 9, "boost_positions_in_dens_func": [9, 20, 22], "introduc": [9, 11, 15], "uniform": [9, 20, 36], "accord": 9, "coulomb": [9, 20], "kg": [9, 20], "mass": [9, 19, 20], "maxim": [9, 20, 22, 24], "r": [9, 11, 12, 13, 14, 16, 17, 20, 21, 22, 23, 24, 26, 36], "callabl": [9, 10, 20], "1d": [9, 10, 20, 22], "den": [9, 20], "rel": [9, 20, 22, 23, 24, 33, 35], "express": [9, 10, 13, 14, 19, 20, 36], "taken": [9, 11, 12, 16, 17, 20], "ballist": 9, "bool": [9, 11, 20, 21], "add_particle_bunch_gaussian": 9, "sig_r": 9, "sig_z": 9, "n_emit": 9, "sig_gamma": 9, "n_physical_particl": 9, "n_macroparticl": 9, "tf": 9, "zf": [9, 11, 12, 13, 14, 16, 17, 22, 23], "save_beam": 9, "symmetr": 9, "focus": [9, 18], "out": [9, 11, 13, 22, 23, 24], "rm": 9, "absolut": 9, "energi": [9, 12, 15, 17], "spread": 9, "reach": [9, 11, 16, 19], "npz": 9, "fold": 9, "rotat": 9, "symmetri": [9, 26, 36], "everi": 9, "pi": [9, 10, 11, 12, 13, 14, 16, 17, 22, 23], "plane": [9, 11, 12, 13, 14, 16, 17], "exactli": 9, "offset": [9, 15], "add_particle_bunch_from_arrai": 9, "numpi": [9, 10, 22, 23, 24], "add_particle_bunch_openpmd": 9, "ts_path": 9, "z_off": 9, "timeseri": 9, "moment": 9, "There": [9, 10, 11], "h5": [9, 15], "data0005000": 9, "shift": [9, 11], "phasespac": 9, "center": [9, 11, 16, 27], "add_particle_bunch_fil": 9, "filenam": [9, 15], "text": [9, 27, 29, 31, 32], "seven": 9, "column": 9, "header": 9, "unitless": 9, "arbitrari": 9, "old": 9, "add_elec_bunch": 9, "flexibl": 9, "appli": [10, 18, 21, 35], "evolv": [10, 18], "external_field": 10, "externalfield": 10, "field_func": 10, "amplitud": [10, 11, 12, 13, 16, 17, 22, 23, 24], "length_scal": 10, "numba": [10, 25, 27, 28, 29, 30, 31, 32], "ufunc": 10, "n_ptcl": 10, "design": [10, 18], "overwrit": 10, "were": [10, 36], "To": [10, 11, 23, 25, 28, 30], "avoid": [10, 31, 36], "insid": [10, 11, 20, 22], "definit": 10, "math": [10, 11], "modul": [10, 25, 26, 27, 29, 31, 32], "mathemat": 10, "ex": 10, "ei": 10, "ez": 10, "bx": 10, "bz": 10, "magnet": 10, "undul": 10, "polar": [10, 11, 12, 13, 14, 15, 16, 17, 35, 36], "tesla": 10, "cm": 10, "def": [10, 22, 23, 24], "co": [10, 11, 12, 16, 17, 36], "principl": 10, "necessarili": [10, 25, 35], "could": [10, 15], "proport": [10, 35], "intern": [10, 22, 23, 24], "reli": 10, "variabl": [10, 20, 25, 28], "constraint": [10, 29], "add_laser_puls": [11, 15, 22, 23, 24], "add_las": [11, 22], "present": [11, 15], "entir": [11, 35], "immedi": 11, "manner": [11, 20], "equat": [11, 19, 20, 35, 36], "nabla": 11, "cdot": 11, "emit": [11, 15], "advantag": [11, 25, 26, 28, 35], "opposit": 11, "unwant": 11, "interest": 11, "rapidli": 11, "exit": 11, "laser_profil": [11, 15, 22, 23, 24], "z0_antenna": [11, 15, 22], "v_antenna": 11, "interpol": [11, 36], "properti": 11, "laguerr": [11, 14], "gauss": 11, "waist": [11, 12, 13, 16, 17, 22, 23, 24], "durat": [11, 12, 13, 14, 16, 17, 22, 23, 24], "30": [11, 22, 23, 24, 27, 29, 31], "femtosecond": 11, "laguerregausslas": [11, 12, 17], "a0": [11, 12, 13, 14, 16, 17, 22, 23, 24], "6": [11, 14, 22, 23, 24, 27, 29, 32], "tau": [11, 12, 13, 14, 16, 17, 22, 23, 24], "15": [11, 22, 23, 24], "z0": [11, 12, 13, 14, 16, 17, 22, 23, 24], "even": [11, 17, 20, 26], "donut": 11, "like": [11, 23, 36], "few": [11, 35, 36], "cycl": [11, 20], "lasi": 11, "togeth": [11, 35, 36], "might": 11, "want": [11, 25, 28, 30], "circularli": 11, "linearli": [11, 12, 14, 16, 17, 36], "decompos": [11, 35], "orthogon": 11, "done": [11, 20, 22], "gaussianlas": [11, 13, 16, 22, 23, 24], "w0": [11, 14, 22, 23, 24], "linear_profile1": 11, "theta_pol": [11, 12, 13, 14, 16, 17], "cep_phas": [11, 12, 13, 14, 16, 17], "linear_profile2": 11, "circular_profil": 11, "experi": 11, "program": 11, "equival": [11, 13], "ctau": 11, "lambda0": [11, 12, 13, 14, 16, 17, 22], "8e": [11, 12, 13, 14, 16, 17, 22], "07": [11, 12, 13, 14, 16, 17], "phi2_chirp": [11, 16], "fw_propag": 11, "update_spectr": 11, "electr": [11, 12, 13, 16, 17, 19], "focal": [11, 12, 13, 14, 16, 17, 22, 23], "a_0": [11, 12, 13, 16, 17], "e_0": [11, 12, 13, 16, 17], "exp": [11, 12, 14, 16, 17], "w_0": [11, 12, 13, 14, 16, 17], "z_0": [11, 12, 13, 16, 17], "ct": [11, 12, 13, 16, 17], "k_0": [11, 12, 13, 16, 17], "phi_": [11, 12, 13, 16, 17], "cep": [11, 12, 13, 14, 16, 17], "lambda_0": [11, 12, 13, 14, 16, 17], "wavevector": [11, 12, 13, 16, 17], "m_e": [11, 12, 13, 16, 17, 22, 23, 24], "q_e": [11, 12, 13, 16, 17], "aris": [11, 12, 16, 17], "far": [11, 12, 14, 16, 17, 36], "goui": [11, 12, 16, 17], "wavefront": [11, 12, 16, 17], "curvatur": [11, 12, 16, 17], "simplic": [11, 12, 16, 17], "cours": [11, 12, 16, 17, 36], "awai": [11, 12, 16, 17], "peak": [11, 13, 14, 15, 16], "centroid": [11, 12, 13, 14, 15, 16, 17, 22, 23, 24], "radian": [11, 12, 13, 14, 16, 17], "angl": [11, 12, 13, 14, 16, 17], "axi": [11, 12, 13, 14, 15, 16, 17, 20, 35, 36], "carrier": [11, 12, 13, 14, 16, 17], "envelopp": [11, 12, 13, 14, 16, 17], "amount": [11, 16, 35], "chirp": [11, 16], "packet": [11, 16], "omega_0": [11, 13, 16], "omega": [11, 16], "phi": [11, 16], "red": [11, 16, 36], "spectrum": [11, 16], "front": [11, 16], "blue": [11, 16, 36], "back": [11, 16, 22, 36], "wether": 11, "donutlikelaguerregausslas": [12, 17], "propagation_direct": [12, 13, 14, 16, 17], "unlik": [12, 17], "azimuth": [12, 17, 20], "cork": 12, "screw": 12, "pattern": 12, "independ": [12, 17, 20, 35, 36], "mathrm": [12, 14, 17], "qquad": [12, 14, 17], "_p": 12, "m_p": [12, 17, 22, 23], "polynomi": [12, 14, 17], "info": [12, 17], "siegman": [12, 17], "1986": [12, 17], "chapter": [12, 17], "16": [12, 17, 22, 23, 24, 35], "optic": [12, 13, 14, 17], "mode": [12, 17, 20, 22, 23, 24, 36], "nm": [12, 17, 20, 22, 23, 24], "ring": [12, 14, 17], "radial": [12, 17, 20, 22, 24, 36], "neg": [12, 13, 14, 15, 16, 17, 35], "8": [12, 13, 14, 16, 17, 25, 28, 29], "ti": [12, 13, 14, 16, 17], "sapph": [12, 13, 14, 16, 17], "fewcyclelas": 13, "tau_fwhm": 13, "adapt": 13, "neglect": 13, "overcom": 13, "caron": 13, "potvileg": 13, "journal": 13, "modern": [13, 14, 35], "46": 13, "1881": 13, "1999": 13, "re": [13, 20], "z_r": 13, "ik_0": 13, "2q": 13, "rayleigh": 13, "z_f": 13, "iz_r": 13, "control": 13, "fwhm": 13, "gg": 13, "mani": [13, 20, 35], "envelop": 13, "full": [13, 36], "width": 13, "half": 13, "flattenedgaussianlas": 14, "santarsiero": 14, "et": [14, 26], "al": [14, 26], "1997": 14, "0_n": 14, "sum_": 14, "_n": 14, "binom": 14, "rightarrow": 14, "infti": 14, "jinc": 14, "j_1": 14, "foc": 14, "w_": 14, "spot": 14, "determin": [14, 15, 20, 35], "somewhat": 14, "8th": 14, "supergaussian": 14, "fromlasyfilelas": 15, "t_start": 15, "forc": [15, 17, 31, 36], "irrespect": 15, "metadata": 15, "tmin": 15, "actual": 15, "convent": 15, "conveni": 15, "delai": 15, "especi": [15, 26], "ignor": 15, "unspecifi": 15, "gaussianprofil": 15, "spot_siz": 15, "pulse_dur": 15, "t_peak": 15, "rt": 15, "geometri": [15, 36], "lo": 15, "bound": [15, 25], "hi": 15, "upper": [15, 20], "num_point": 15, "300": 15, "500": [15, 24], "1e": 15, "write_to_fil": 15, "lasy_las": 15, "now": 15, "lasy_laser_00000": 15, "theta0": 17, "delta_": 17, "theta_0": 17, "linear": [17, 20, 24, 35, 36], "driven": 17, "ponderomot": 17, "maxima": 17, "helper": 18, "extern": 18, "ptcl": [19, 20], "It": [19, 20, 22, 25, 26, 27, 28, 29, 35], "append": [19, 27], "ioniz": [19, 20, 25, 26], "state": 19, "level": [19, 20, 23], "alloc": [19, 22, 23, 24, 27, 28, 29], "uniqu": 19, "make_ioniz": [19, 23, 25], "target_speci": [19, 23], "level_start": [19, 23], "level_max": 19, "model": [19, 26, 30], "adk": [19, 26], "instantan": 19, "averag": 19, "over": [19, 25], "rate": 19, "found": [19, 28], "chen": 19, "jcp": [19, 20], "236": 19, "2013": 19, "atom": [19, 23], "symbol": 19, "consid": [19, 26], "he": [19, 23], "helium": [19, 23], "nitrogen": [19, 23], "kei": [19, 20], "distinct": [19, 26], "neutral": [19, 20, 23], "exce": 19, "set_moving_window": [20, 22, 23, 24], "nz": [20, 22, 23, 24], "zmax": [20, 22, 23, 24], "nr": [20, 22, 23, 24], "rmax": [20, 22, 23, 24], "n_e": [20, 22, 23, 24], "n_order": [20, 22, 23, 24, 25, 35], "filter_curr": 20, "use_galilean": 20, "use_cuda": [20, 22, 23, 24], "n_guard": 20, "n_damp": 20, "64": 20, "exchange_period": 20, "current_correct": 20, "curl": [20, 35], "free": [20, 35, 36], "reflect": [20, 22, 23, 24], "particle_shap": 20, "verbose_level": [20, 35], "smoother": [20, 21], "use_ruyten_shap": 20, "use_modified_volum": 20, "cut": 20, "agument": 20, "hydrogen": 20, "docstr": 20, "mention": [20, 27, 29, 35], "label": [20, 36], "gridpoint": [20, 22, 23, 24, 36], "last": [20, 22], "stencil": [20, 22, 23, 24, 35], "deriv": [20, 22, 23, 24, 36], "maxwel": [20, 22, 23, 24, 35, 36], "solver": [20, 22, 23, 24, 25, 26, 36], "infinit": [20, 22, 23, 24, 35], "exact": [20, 22, 23, 24], "dispers": [20, 22, 23, 24, 35, 36], "relat": [20, 22, 23, 24, 30], "advic": [20, 22, 23, 24, 29], "cpu": [20, 22, 23, 24, 25, 26, 28, 29, 30, 32, 35], "multi": [20, 22, 23, 24, 25, 26, 35], "lead": [20, 22, 23, 24, 26, 35, 36], "overhead": [20, 22, 23, 24, 35], "accur": [20, 22, 23, 24, 26, 35], "trade": [20, 22, 23, 24, 35], "articl": [20, 35, 36], "filter": 20, "psatd": 20, "constant": [20, 22, 23, 24], "scheme": 20, "hypothesi": 20, "solv": [20, 36], "domain": [20, 25, 35], "damp": 20, "exchang": [20, 35], "never": 20, "abl": [20, 29, 30], "travel": 20, "substanti": 20, "absorb": 20, "perfectli": 20, "layer": [20, 35], "significantli": 20, "costli": 20, "continu": [20, 28], "contribut": 20, "decomposit": [20, 25, 35], "share": [20, 31, 35], "str": 20, "cubic": 20, "third": 20, "binomialsmooth": [20, 21], "binomi": [20, 21], "compens": [20, 21], "ruyten": 20, "105": 20, "1993": 20, "http": [20, 22, 23, 24, 27, 28, 30], "doi": 20, "org": [20, 22, 23, 24, 28], "1006": 20, "jcph": 20, "1070": 20, "slightli": [20, 36], "volum": 20, "correctli": [20, 35], "uz_m": 20, "ux_m": 20, "uy_m": 20, "uz_th": 20, "ux_th": 20, "uy_th": 20, "continuous_inject": 20, "is_trac": 20, "evenli": 20, "explicitli": [20, 25], "except": [20, 27, 36], "suffici": 20, "word": 20, "thermal": 20, "passiv": 20, "tracer": 20, "new_speci": 20, "299792458": 20, "unus": 20, "kept": 20, "correct_curr": 20, "correct_d": 20, "use_true_rho": 20, "move_posit": 20, "move_momenta": 20, "show_progress": 20, "push": [20, 36], "freez": 20, "random_se": [20, 23], "set_random_se": [20, 23], "seed": [20, 23], "random": [20, 23], "repeatedli": 20, "despit": 20, "mont": 20, "carlo": 20, "n_pass": 21, "mitig": [21, 26], "impact": 21, "intermedi": 21, "boolean": 21, "download": [22, 23, 24, 25, 27, 28, 30], "link": [22, 23, 24, 28, 33], "usag": [22, 23, 24, 28], "suit": [22, 23, 24, 25, 26, 35], "boosted_frame_script": [22, 25], "enter": [22, 23, 24], "fbpic_object": [22, 23, 24], "__doc__": [22, 23, 24], "scipi": [22, 23, 24, 27, 28, 29, 30, 31], "relev": [22, 23, 24, 32], "arxiv": [22, 23, 24, 26, 36], "ab": [22, 23, 24], "1611": [22, 23, 24], "05712": [22, 23, 24], "600": 22, "75": 22, "150": 22, "advanc": [22, 26, 35, 36], "explan": 22, "min": 22, "50": [22, 23, 24], "zfoc": 22, "w_match": 22, "ramp_up": 22, "5e": 22, "plateau": 22, "ramp_down": 22, "e24": [22, 23], "labfram": 22, "divid": 22, "guid": [22, 27], "rel_delta_n_over_w2": 22, "81e": 22, "n_plasma": 22, "ones_lik": [22, 23, 24], "ramp": [22, 23, 24], "inv_ramp_up": 22, "inv_ramp_down": 22, "parabol": 22, "bunch_zmin": 22, "bunch_zmax": 22, "bunch_rmax": 22, "bunch_gamma": 22, "400": 22, "bunch_n": 22, "e23": 22, "75e27": 22, "nci": 22, "discret": [22, 36], "n_boosted_diag": 22, "n_lab_diag": 22, "dt_lab_diag_period": 22, "dt_boosted_diag_period": 22, "cach": [22, 28, 31], "backtransform": 22, "write_period": 22, "tag": 22, "track_bunch": 22, "carri": [22, 23, 24], "execut": [22, 24, 25, 27, 30, 35], "boosted_frame_sim": 22, "__name__": [22, 23, 24], "__main__": [22, 23, 24], "expens": [22, 23, 24, 36], "plasma_elec": 22, "plasma_ion": 22, "v_window_boost": 22, "configur": [22, 23, 24, 29], "fld": [22, 23, 24], "mix": 23, "pre": [23, 26], "ionization_script": 23, "800": [23, 24], "20": [23, 24, 32], "n_he": 23, "n_n": 23, "z_foc": 23, "diag_period": [23, 24], "save_checkpoint": [23, 24], "checkpoint_period": [23, 24], "use_restart": [23, 24], "track_electron": [23, 24], "ramp_length": [23, 24], "sine": 23, "sin": [23, 36], "supress": [23, 24], "distanc": [23, 24], "atoms_h": 23, "atoms_n": 23, "14": 23, "n5": 23, "5x": 23, "dedic": 23, "elec_from_n": 23, "els": [23, 24], "almost": 23, "everywher": 23, "individu": [23, 35], "lwfa_script": [24, 25], "18": 24, "e18": 24, "e6": 24, "ramp_start": 24, "40": 24, "environ": [25, 28, 29, 31], "parallelis": 25, "thread": [25, 26, 28, 35], "core": [25, 26, 28, 35], "export": [25, 27, 28, 31, 32], "mkl_num_thread": 25, "numba_num_thread": [25, 32], "altogeth": 25, "fbpic_disable_thread": 25, "happen": 25, "altern": [25, 35], "backend": 25, "omp_num_thread": [25, 32], "jupyt": 25, "notebook": [25, 29], "socket": [25, 28, 35], "ineffici": 25, "necessari": 25, "bind": 25, "spawn": 25, "slurm": 25, "workload": 25, "manag": [25, 31], "srun": [25, 27, 28, 29, 31], "cpu_bind": 25, "gpudirect": [25, 28], "technologi": 25, "copi": [25, 27, 29, 31, 32, 35], "latenc": 25, "bandwidth": 25, "care": 25, "fbpic_enable_gpudirect": [25, 28, 31, 32], "compli": 25, "conda": [25, 27, 28, 29, 30, 31, 32], "forg": [25, 27, 29, 30, 31], "openpmd_notebook": 25, "pop": [25, 26], "capabl": 25, "learn": [25, 35], "tutori": 25, "github": [25, 26, 30], "repositori": 25, "render": 25, "fourier": [26, 36], "bessel": 26, "represent": [26, 36], "fast": [26, 35], "situat": [26, 36], "brief": 26, "intrins": 26, "numer": [26, 35, 36], "cherenkov": [26, 35], "radiat": [26, 35], "ncr": [26, 35], "strongli": 26, "what": 26, "welcom": 26, "wish": 26, "develop": [26, 28], "remi": 26, "lehe": 26, "berkelei": [26, 29], "manuel": 26, "kirchen": 26, "cfel": 26, "hamburg": 26, "univers": 26, "benefit": 26, "soeren": 26, "jala": 26, "kevin": 26, "peter": 26, "iren": 26, "dornmair": 26, "laurid": 26, "jepp": 26, "igor": 26, "andriyash": 26, "laboratoir": 26, "optiqu": 26, "applique": 26, "omri": 26, "seemann": 26, "weizmann": 26, "institut": 26, "daniel": 26, "seipt": 26, "michigan": 26, "samuel": 26, "yoff": 26, "strathclyd": 26, "david": 26, "grote": 26, "llnl": 26, "lbnl": [26, 33], "anton": 26, "golovanov": 26, "scientif": 26, "public": 26, "cpc": 26, "2016": 26, "techniqu": 26, "2017": 26, "2020": 26, "project": [26, 32], "great": 26, "cite": 26, "san": 27, "diego": 27, "supercomput": [27, 28], "nvidia": [27, 28, 30, 31, 32, 35], "k80": 27, "p100": 27, "base": [27, 31, 32], "resourc": [27, 28], "miniconda": 27, "wget": [27, 28], "repo": [27, 28], "com": [27, 28, 30], "miniconda3": 27, "linux": [27, 28], "x86_64": [27, 28], "sh": [27, 28], "bash": [27, 28, 29, 31, 32], "ask": 27, "bashrc": [27, 28, 29], "answer": 27, "ye": 27, "cupi": [27, 28, 29, 30, 31, 32], "h5py": [27, 28, 29, 30, 31], "mkl": [27, 28, 29, 30, 31], "cudatoolkit": [27, 28, 29, 30, 31, 32], "9": [27, 32], "purg": [27, 32], "gnutool": 27, "gnu": [27, 31], "openmpi_ib": 27, "cuda92": 27, "env": 27, "mpicc": [27, 31], "opt": 27, "ib": 27, "bin": [27, 28, 29, 31, 32], "briefli": 27, "submit": 27, "request": [27, 29, 31, 32], "salloc": [27, 28, 29, 31], "gre": [27, 28, 29], "00": [27, 28, 29, 31, 32], "pty": [27, 28, 29], "connect": [27, 28], "cd": [27, 28, 29, 31, 32], "submission_fil": [27, 29, 31], "bracket": [27, 29, 31, 32], "proper": [27, 29, 31, 32], "sbatch": [27, 29, 31], "my_job": [27, 29, 31, 32], "requestednod": [27, 32], "requestedtim": [27, 29, 31, 32], "gputyp": 27, "ntask": [27, 28, 29, 31], "corespergpu": 27, "pmi2": 27, "nmpi": 27, "7": [27, 28, 31, 32], "juelich": 28, "centr": 28, "gcc": [28, 32], "mvapich2": 28, "gdr": 28, "archiv": 28, "anaconda3": [28, 32], "2019": 28, "03": 28, "cuda100": [28, 29], "NOT": 28, "built": 28, "against": 28, "librari": 28, "dir": [28, 31], "version": [28, 30, 36], "git": [28, 30], "bitbucket": 28, "shell": 28, "get_library_vers": 28, "pythonpath": 28, "home": 28, "juser": 28, "usernam": [28, 29], "lib": 28, "python3": [28, 30, 31], "site": 28, "clone": [28, 30, 32], "job": 28, "ressourc": 28, "2x24": 28, "60": 28, "minut": [28, 32], "multithread": 28, "best": [28, 35], "ideal": [28, 36], "v100": [28, 29, 32], "partit": [28, 29], "run_fil": 28, "task": [28, 29, 31], "consol": 28, "jureca": 28, "establish": 28, "ssh": [28, 29], "fz": 28, "de": 28, "lawrenc": 29, "nation": 29, "four": 29, "gtx": 29, "1080ti": 29, "password": 29, "otp": 29, "token": 29, "lrc": 29, "login": 29, "lbl": 29, "gov": 29, "fbpic_env": 29, "global": [29, 31], "yourusernam": [29, 31], "es1": 29, "es1_1080ti": 29, "qo": 29, "es_norm": 29, "u": 29, "gpuconstraint": 29, "requestedrank": [29, 31], "gpupernod": 29, "cpupertask": 29, "es1_v100": 29, "queue": 29, "squeue": 29, "anaconda": 30, "picmi": 30, "releas": 30, "shortcut": 30, "11": [30, 31], "cuda110": 30, "driver": 30, "smi": 30, "tabl": 30, "intel": 30, "pyfftw": [30, 32], "fft": 30, "mac": 30, "osx": 30, "observ": 30, "try": 30, "macport": 30, "uninstal": 30, "sudo": 30, "port": 30, "gcc48": 30, "fortran": 30, "appl": 30, "silicon": 30, "brew": 30, "onednn": 30, "Its": 31, "equip": 31, "a100": 31, "prepar": 31, "prgenv": 31, "cpe": 31, "deactiv": [31, 32], "interfer": 31, "config": 31, "auto_activate_bas": 31, "cc": 31, "target": 31, "accel": 31, "nvidia80": 31, "account_numb": [31, 32], "mpich_gpu_support_en": 31, "oakridg": 32, "leadership": 32, "facil": 32, "fftw": 32, "cython": 32, "49": 32, "memberwork": 32, "mkdir": 32, "project_id": 32, "cp": 32, "bsub": 32, "nnode": 32, "85": 32, "cupy_cache_dir": 32, "kernel_cach": 32, "fbpic_disable_cach": 32, "jsrun": 32, "submission_script": 32, "accountnumb": 32, "requestedmpirank": 32, "smpiarg": 32, "attempt": 32, "bjob": 32, "monitor": 32, "plateform": 33, "juwel": 33, "jsc": 33, "lawrencium": 33, "comet": 33, "sdsc": 33, "perlmutt": 33, "nersc": 33, "summit": 33, "olcf": 33, "demand": 35, "arithmet": 35, "oper": 35, "consumpt": 35, "unit": 35, "strategi": 35, "chunk": 35, "treat": 35, "protocol": 35, "imag": [35, 36], "illustr": 35, "map": 35, "onto": [35, 36], "architectur": 35, "ram": 35, "slower": 35, "area": 35, "network": 35, "layout": 35, "thousand": 35, "contrast": [35, 36], "hardwar": 35, "achiev": 35, "come": 35, "hundr": 35, "millisecond": 35, "fit": 35, "enough": [35, 36], "split": 35, "region": 35, "neighbor": 35, "overlap": 35, "resid": 35, "messag": 35, "poor": 35, "highli": 35, "farther": 35, "tunabl": 35, "accuraci": 35, "integr": 35, "oppos": 35, "evolut": [35, 36], "fdtd": 35, "classifi": 35, "extent": 35, "notat": 35, "extend": 35, "artifici": 35, "rang": 35, "modif": 35, "bring": 35, "govern": 35, "spuriou": [35, 36], "deterior": 35, "qualiti": 35, "identifi": 35, "guarante": 35, "influenc": 35, "slight": 35, "disadvantag": 35, "strictli": 35, "preserv": 35, "lump": 36, "At": 36, "schemat": 36, "view": 36, "calder": 36, "circ": 36, "2d": 36, "proportion": 36, "coordin": 36, "e_r": 36, "e_": 36, "further": 36, "departur": 36, "stake": 36, "vastli": 36, "nonetheless": 36, "cost": 36, "suggest": 36, "sum": 36, "appear": 36, "denot": 36, "post": 36, "artifact": 36, "growth": 36, "courant": 36, "freeli": 36, "resolut": 36, "hankel": 36, "n_z": 36, "n_r": 36, "notabl": 36}, "objects": {"fbpic.fields.smoothing": [[21, 0, 1, "", "BinomialSmoother"]], "fbpic.lpa_utils.boosted_frame": [[6, 0, 1, "", "BoostConverter"]], "fbpic.lpa_utils.boosted_frame.BoostConverter": [[6, 1, 1, "", "boost_particle_arrays"], [6, 1, 1, "", "copropag_density"], [6, 1, 1, "", "copropag_length"], [6, 1, 1, "", "gamma"], [6, 1, 1, "", "interaction_time"], [6, 1, 1, "", "longitudinal_momentum"], [6, 1, 1, "", "static_density"], [6, 1, 1, "", "static_length"], [6, 1, 1, "", "velocity"], [6, 1, 1, "", "wavenumber"]], "fbpic.lpa_utils.bunch": [[9, 2, 1, "", "add_particle_bunch"], [9, 2, 1, "", "add_particle_bunch_file"], [9, 2, 1, "", "add_particle_bunch_from_arrays"], [9, 2, 1, "", "add_particle_bunch_gaussian"], [9, 2, 1, "", "add_particle_bunch_openPMD"]], "fbpic.lpa_utils.external_fields": [[10, 0, 1, "", "ExternalField"]], "fbpic.lpa_utils.laser": [[12, 0, 1, "", "DonutLikeLaguerreGaussLaser"], [13, 0, 1, "", "FewCycleLaser"], [14, 0, 1, "", "FlattenedGaussianLaser"], [15, 0, 1, "", "FromLasyFileLaser"], [16, 0, 1, "", "GaussianLaser"], [17, 0, 1, "", "LaguerreGaussLaser"], [11, 2, 1, "", "add_laser"], [11, 2, 1, "", "add_laser_pulse"]], "fbpic.main": [[20, 0, 1, "", "Simulation"]], "fbpic.main.Simulation": [[20, 1, 1, "", "add_new_species"], [20, 1, 1, "", "set_moving_window"], [20, 1, 1, "", "step"]], "fbpic.openpmd_diag": [[8, 0, 1, "", "BackTransformedFieldDiagnostic"], [8, 0, 1, "", "BackTransformedParticleDiagnostic"], [8, 0, 1, "", "FieldDiagnostic"], [8, 0, 1, "", "ParticleChargeDensityDiagnostic"], [8, 0, 1, "", "ParticleDiagnostic"], [7, 2, 1, "", "restart_from_checkpoint"], [7, 2, 1, "", "set_periodic_checkpoint"]], "fbpic.particles": [[19, 0, 1, "", "Particles"]], "fbpic.particles.fbpic.particles.Particles.Particles": [[19, 1, 1, "", "make_ionizable"], [19, 1, 1, "", "track"]], "fbpic.utils.random_seed": [[20, 2, 1, "", "set_random_seed"]]}, "objtypes": {"0": "py:class", "1": "py:method", "2": "py:function"}, "objnames": {"0": ["py", "class", "Python class"], "1": ["py", "method", "Python method"], "2": ["py", "function", "Python function"]}, "titleterms": {"3d": 0, "visual": [0, 4, 25, 29], "us": [0, 1, 4], "pyvista": 0, "advanc": 1, "run": [2, 25, 27, 28, 29, 30, 31, 32], "boost": [2, 6, 8, 22], "frame": [2, 6, 8, 22], "simul": [2, 4, 7, 8, 20, 22, 24, 25, 27, 28, 29, 30, 31, 32], "principl": 2, "techniqu": 2, "lwfa": 2, "convert": 2, "input": 2, "paramet": [2, 3], "from": [2, 15], "lab": 2, "result": [2, 4, 25, 29], "avoid": 2, "numer": 2, "cherenkov": 2, "instabl": 2, "nci": 2, "estim": 2, "number": 2, "pic": [2, 36], "iter": 2, "transform": [2, 8], "resolut": 2, "physic": 2, "object": 2, "perform": 3, "scan": 3, "parallel": [3, 35], "profil": [4, 11, 12, 13, 14, 15, 16, 17], "code": [4, 25, 34], "execut": 4, "cpu": 4, "get": 4, "simpl": 4, "text": 4, "file": [4, 15], "gpu": 4, "mpi": 4, "api": 5, "refer": 5, "convers": 6, "checkpoint": 7, "restart": 7, "set": [7, 29, 31], "The": [8, 19, 20, 36], "openpmd": 8, "diagnost": 8, "regular": 8, "field": [8, 10, 21], "particl": [8, 19], "densiti": 8, "back": 8, "beam": 9, "initi": [9, 11], "extern": 10, "laser": [11, 18, 22, 23, 24], "gener": 11, "function": 11, "arbitrari": 11, "combin": 11, "sum": 11, "creat": 11, "your": 11, "own": 11, "custom": 11, "compact": 11, "gaussian": [11, 14, 16], "puls": 11, "donut": 12, "like": 12, "laguerr": [12, 17], "gauss": [12, 17], "few": 13, "cycl": [13, 36], "flatten": 14, "produc": 15, "lasi": 15, "plasma": 18, "util": 18, "class": [19, 20], "smooth": 21, "wakefield": [22, 23, 24], "acceler": [22, 23, 24], "ioniz": 23, "standard": 24, "how": 25, "script": 25, "exampl": 25, "fbpic": [26, 27, 28, 29, 30, 31, 32, 35, 36], "document": 26, "content": 26, "contribut": 26, "research": 26, "attribut": 26, "instal": [27, 28, 29, 30, 31, 32, 33], "comet": 27, "sdsc": 27, "anaconda": [27, 28, 29, 31, 32], "its": [27, 29, 31, 32], "depend": [27, 29, 31, 32], "prepar": [27, 29, 32], "new": [27, 29], "interact": [27, 29, 31, 32], "job": [27, 29, 31, 32], "batch": [27, 29, 31, 32], "juwel": 28, "jsc": 28, "load": 28, "cluster": 28, "modul": 28, "lawrencium": 29, "lbnl": 29, "connect": 29, "up": [29, 31], "through": 29, "jupyt": 29, "local": 30, "comput": 30, "potenti": 30, "issu": 30, "perlmutt": 31, "nersc": 31, "summit": 32, "olcf": 32, "environ": 32, "overview": 34, "two": 35, "level": 35, "intra": 35, "devic": 35, "inter": 35, "finit": 35, "order": 35, "spectral": [35, 36], "solver": 35, "algorithm": 36, "featur": 36, "introduct": 36, "distinct": 36, "cylindr": 36, "grid": 36, "azimuth": 36, "decomposit": 36, "analyt": 36, "integr": 36, "space": 36, "center": 36, "time": 36}, "envversion": {"sphinx.domains.c": 3, "sphinx.domains.changeset": 1, "sphinx.domains.citation": 1, "sphinx.domains.cpp": 9, "sphinx.domains.index": 1, "sphinx.domains.javascript": 3, "sphinx.domains.math": 2, "sphinx.domains.python": 4, "sphinx.domains.rst": 2, "sphinx.domains.std": 2, "sphinx.ext.viewcode": 1, "sphinx": 60}, "alltitles": {"3D visualization using PyVista": [[0, "d-visualization-using-pyvista"]], "Advanced use": [[1, "advanced-use"]], "Running boosted-frame simulations": [[2, "running-boosted-frame-simulations"]], "Principle of the boosted-frame technique (for LWFA)": [[2, "principle-of-the-boosted-frame-technique-for-lwfa"]], "Converting input parameters from the lab frame to the boosted frame": [[2, "converting-input-parameters-from-the-lab-frame-to-the-boosted-frame"]], "Converting simulation results from the boosted frame to the lab frame": [[2, "converting-simulation-results-from-the-boosted-frame-to-the-lab-frame"]], "Avoiding the Numerical Cherenkov Instability (NCI)": [[2, "avoiding-the-numerical-cherenkov-instability-nci"]], "Estimating the number of PIC iterations for boosted frame simulations": [[2, "estimating-the-number-of-pic-iterations-for-boosted-frame-simulations"]], "Transformation and resolution of physical objects in the boosted frame": [[2, "transformation-and-resolution-of-physical-objects-in-the-boosted-frame"]], "Performing parameter scans in parallel": [[3, "performing-parameter-scans-in-parallel"]], "Profiling the code": [[4, "profiling-the-code"]], "Profiling the code executed on CPU": [[4, "profiling-the-code-executed-on-cpu"]], "Getting the results in a simple text file": [[4, "getting-the-results-in-a-simple-text-file"], [4, "id1"]], "Using a visual profiler": [[4, "using-a-visual-profiler"], [4, "id2"]], "Profiling the code executed on GPU": [[4, "profiling-the-code-executed-on-gpu"]], "Profiling MPI simulations": [[4, "profiling-mpi-simulations"]], "Profiling the CPU code": [[4, "profiling-the-cpu-code"]], "Profiling the GPU code": [[4, "profiling-the-gpu-code"]], "API reference": [[5, "api-reference"]], "Conversion to boosted-frame": [[6, "conversion-to-boosted-frame"]], "Checkpoints and restarts": [[7, "checkpoints-and-restarts"]], "Setting checkpoints": [[7, "setting-checkpoints"]], "Restarting a simulation": [[7, "restarting-a-simulation"]], "The openPMD diagnostics": [[8, "the-openpmd-diagnostics"]], "Regular diagnostics": [[8, "regular-diagnostics"]], "Field diagnostic": [[8, "field-diagnostic"], [8, "id1"]], "Particle diagnostic": [[8, "particle-diagnostic"], [8, "id2"]], "Particle density diagnostic": [[8, "particle-density-diagnostic"]], "Back-transformed diagnostics (boosted-frame simulations)": [[8, "back-transformed-diagnostics-boosted-frame-simulations"]], "Beam initialization": [[9, "beam-initialization"]], "External fields": [[10, "external-fields"]], "Laser initialization": [[11, "laser-initialization"]], "Generic function for arbitrary laser profile": [[11, "generic-function-for-arbitrary-laser-profile"]], "Laser profiles": [[11, "laser-profiles"]], "Combining (summing) laser profiles": [[11, "combining-summing-laser-profiles"]], "Creating your own custom laser profile": [[11, "creating-your-own-custom-laser-profile"]], "Compact function for a Gaussian pulse": [[11, "compact-function-for-a-gaussian-pulse"]], "Laser-plasma utilities": [[18, "laser-plasma-utilities"]], "The Particles class": [[19, "the-particles-class"]], "The Simulation class": [[20, "the-simulation-class"]], "Field smoothing": [[21, "field-smoothing"]], "Boosted-frame simulation of laser-wakefield acceleration": [[22, "boosted-frame-simulation-of-laser-wakefield-acceleration"]], "Laser-wakefield acceleration with ionization": [[23, "laser-wakefield-acceleration-with-ionization"]], "Standard simulation of laser-wakefield acceleration": [[24, "standard-simulation-of-laser-wakefield-acceleration"]], "How to run the code": [[25, "how-to-run-the-code"]], "Script examples": [[25, "script-examples"]], "Running the simulation": [[25, "running-the-simulation"]], "Visualizing the simulation results": [[25, "visualizing-the-simulation-results"]], "FBPIC documentation": [[26, "fbpic-documentation"]], "Contents of the documentation": [[26, "contents-of-the-documentation"]], "Contributing to FBPIC": [[26, "contributing-to-fbpic"]], "Research & Attribution": [[26, "research-attribution"]], "Installation on Comet (SDSC)": [[27, "installation-on-comet-sdsc"]], "Installation of FBPIC": [[27, "installation-of-fbpic"], [28, "installation-of-fbpic"], [29, "installation-of-fbpic"], [31, "installation-of-fbpic"], [32, "installation-of-fbpic"]], "Installation of Anaconda": [[27, "installation-of-anaconda"], [28, "installation-of-anaconda"]], "Installation of FBPIC and its dependencies": [[27, "installation-of-fbpic-and-its-dependencies"], [29, "installation-of-fbpic-and-its-dependencies"], [31, "installation-of-fbpic-and-its-dependencies"], [32, "installation-of-fbpic-and-its-dependencies"]], "Running simulations": [[27, "running-simulations"], [28, "running-simulations"], [29, "running-simulations"], [30, "running-simulations"], [31, "running-simulations"], [32, "running-simulations"]], "Preparing a new simulation": [[27, "preparing-a-new-simulation"], [29, "preparing-a-new-simulation"]], "Interactive jobs": [[27, "interactive-jobs"], [29, "interactive-jobs"], [31, "interactive-jobs"], [32, "interactive-jobs"]], "Batch job": [[27, "batch-job"], [29, "batch-job"], [31, "batch-job"], [32, "batch-job"]], "Installation on JUWELS (JSC)": [[28, "installation-on-juwels-jsc"]], "Loading the cluster modules": [[28, "loading-the-cluster-modules"]], "Installation on Lawrencium (LBNL)": [[29, "installation-on-lawrencium-lbnl"]], "Connecting to Lawrencium": [[29, "connecting-to-lawrencium"]], "Setting up Anaconda": [[29, "setting-up-anaconda"], [31, "setting-up-anaconda"]], "Visualizing the results through Jupyter": [[29, "visualizing-the-results-through-jupyter"]], "Installation on a local computer": [[30, "installation-on-a-local-computer"]], "Installing FBPIC": [[30, "installing-fbpic"]], "Potential issues": [[30, "potential-issues"]], "Installation on Perlmutter (NERSC)": [[31, "installation-on-perlmutter-nersc"]], "Installation on Summit (OLCF)": [[32, "installation-on-summit-olcf"]], "Preparing the Anaconda environment": [[32, "preparing-the-anaconda-environment"]], "Installation": [[33, "installation"]], "Overview of the code": [[34, "overview-of-the-code"]], "Parallelization of FBPIC": [[35, "parallelization-of-fbpic"]], "Two-level parallelization": [[35, "two-level-parallelization"]], "Intra-device parallelization": [[35, "intra-device-parallelization"]], "Inter-device parallelization": [[35, "inter-device-parallelization"]], "Finite-order spectral solver": [[35, "finite-order-spectral-solver"]], "FBPIC algorithm & features": [[36, "fbpic-algorithm-features"]], "Introduction to the PIC cycle": [[36, "introduction-to-the-pic-cycle"]], "The distinctive features of FBPIC": [[36, "the-distinctive-features-of-fbpic"]], "Cylindrical grid with azimuthal decomposition": [[36, "cylindrical-grid-with-azimuthal-decomposition"]], "Analytical integration in spectral space": [[36, "analytical-integration-in-spectral-space"]], "Centering in time and space": [[36, "centering-in-time-and-space"]], "Donut-like Laguerre-Gauss profile": [[12, "donut-like-laguerre-gauss-profile"]], "Few-cycle profile": [[13, "few-cycle-profile"]], "Flattened Gaussian profile": [[14, "flattened-gaussian-profile"]], "Profile from a file produced by lasy": [[15, "profile-from-a-file-produced-by-lasy"]], "Gaussian profile": [[16, "gaussian-profile"]], "Laguerre-Gauss profile": [[17, "laguerre-gauss-profile"]]}, "indexentries": {"add_laser() (in module fbpic.lpa_utils.laser)": [[11, "fbpic.lpa_utils.laser.add_laser"]], "add_laser_pulse() (in module fbpic.lpa_utils.laser)": [[11, "fbpic.lpa_utils.laser.add_laser_pulse"]], "donutlikelaguerregausslaser (class in fbpic.lpa_utils.laser)": [[12, "fbpic.lpa_utils.laser.DonutLikeLaguerreGaussLaser"]], "fewcyclelaser (class in fbpic.lpa_utils.laser)": [[13, "fbpic.lpa_utils.laser.FewCycleLaser"]], "flattenedgaussianlaser (class in fbpic.lpa_utils.laser)": [[14, "fbpic.lpa_utils.laser.FlattenedGaussianLaser"]], "fromlasyfilelaser (class in fbpic.lpa_utils.laser)": [[15, "fbpic.lpa_utils.laser.FromLasyFileLaser"]], "gaussianlaser (class in fbpic.lpa_utils.laser)": [[16, "fbpic.lpa_utils.laser.GaussianLaser"]], "laguerregausslaser (class in fbpic.lpa_utils.laser)": [[17, "fbpic.lpa_utils.laser.LaguerreGaussLaser"]]}})
\ No newline at end of file