diff --git a/_modules/fbpic/fields/smoothing.html b/_modules/fbpic/fields/smoothing.html index 7a420ef..6cfcbff 100644 --- a/_modules/fbpic/fields/smoothing.html +++ b/_modules/fbpic/fields/smoothing.html @@ -3,14 +3,14 @@ - fbpic.fields.smoothing — FBPIC 0.25.0 documentation + fbpic.fields.smoothing — FBPIC 0.26.0 documentation - + @@ -30,7 +30,7 @@ FBPIC
- 0.25.0 + 0.26.0
diff --git a/_modules/fbpic/lpa_utils/boosted_frame.html b/_modules/fbpic/lpa_utils/boosted_frame.html index 38f2d2d..08d2fd7 100644 --- a/_modules/fbpic/lpa_utils/boosted_frame.html +++ b/_modules/fbpic/lpa_utils/boosted_frame.html @@ -3,14 +3,14 @@ - fbpic.lpa_utils.boosted_frame — FBPIC 0.25.0 documentation + fbpic.lpa_utils.boosted_frame — FBPIC 0.26.0 documentation - + @@ -30,7 +30,7 @@ FBPIC
- 0.25.0 + 0.26.0
diff --git a/_modules/fbpic/lpa_utils/bunch.html b/_modules/fbpic/lpa_utils/bunch.html index 6eb965f..ff2075e 100644 --- a/_modules/fbpic/lpa_utils/bunch.html +++ b/_modules/fbpic/lpa_utils/bunch.html @@ -3,14 +3,14 @@ - fbpic.lpa_utils.bunch — FBPIC 0.25.0 documentation + fbpic.lpa_utils.bunch — FBPIC 0.26.0 documentation - + @@ -30,7 +30,7 @@ FBPIC
- 0.25.0 + 0.26.0
diff --git a/_modules/fbpic/lpa_utils/external_fields.html b/_modules/fbpic/lpa_utils/external_fields.html index a395a6f..aa93ded 100644 --- a/_modules/fbpic/lpa_utils/external_fields.html +++ b/_modules/fbpic/lpa_utils/external_fields.html @@ -3,14 +3,14 @@ - fbpic.lpa_utils.external_fields — FBPIC 0.25.0 documentation + fbpic.lpa_utils.external_fields — FBPIC 0.26.0 documentation - + @@ -30,7 +30,7 @@ FBPIC
- 0.25.0 + 0.26.0
diff --git a/_modules/fbpic/lpa_utils/laser/laser.html b/_modules/fbpic/lpa_utils/laser/laser.html index 0349696..6a0f8ec 100644 --- a/_modules/fbpic/lpa_utils/laser/laser.html +++ b/_modules/fbpic/lpa_utils/laser/laser.html @@ -3,14 +3,14 @@ - fbpic.lpa_utils.laser.laser — FBPIC 0.25.0 documentation + fbpic.lpa_utils.laser.laser — FBPIC 0.26.0 documentation - + @@ -30,7 +30,7 @@ FBPIC
- 0.25.0 + 0.26.0
diff --git a/_modules/fbpic/lpa_utils/laser/laser_profiles.html b/_modules/fbpic/lpa_utils/laser/laser_profiles.html index d489adf..6feebcd 100644 --- a/_modules/fbpic/lpa_utils/laser/laser_profiles.html +++ b/_modules/fbpic/lpa_utils/laser/laser_profiles.html @@ -3,14 +3,14 @@ - fbpic.lpa_utils.laser.laser_profiles — FBPIC 0.25.0 documentation + fbpic.lpa_utils.laser.laser_profiles — FBPIC 0.26.0 documentation - + @@ -30,7 +30,7 @@ FBPIC
- 0.25.0 + 0.26.0
@@ -998,15 +998,16 @@

Source code for fbpic.lpa_utils.laser.laser_profiles

# Check lasy version valid_version = False - if ('softwareVersion' in f.attrs): + if ('software' in f.attrs) and ('softwareVersion' in f.attrs): + software = f.attrs['software'].decode() version_string = f.attrs['softwareVersion'].decode() version_list = tuple(int(number) for number in version_string.split('.')) - if version_list >= (0,3,0): + if (software == "lasy") and (version_list >= (0,3,0)): valid_version = True if not valid_version: raise RuntimeError( "The `lasy` version that was used to create the file %s " - "is obsolete and not supported by FBPIC. Please upgrade your lasy " + "is obsolete and not supported by FBPIC.\nPlease upgrade your lasy " "version to at least 0.3.0 (e.g. with `pip install --upgrade lasy`) " "and re-create the file %s." %(filename, filename) ) diff --git a/_modules/fbpic/main.html b/_modules/fbpic/main.html index eeba164..7e0218e 100644 --- a/_modules/fbpic/main.html +++ b/_modules/fbpic/main.html @@ -3,14 +3,14 @@ - fbpic.main — FBPIC 0.25.0 documentation + fbpic.main — FBPIC 0.26.0 documentation - + @@ -30,7 +30,7 @@ FBPIC
- 0.25.0 + 0.26.0
@@ -424,7 +424,8 @@

Source code for fbpic.main

 [docs]
     def step(self, N=1, correct_currents=True,
              correct_divE=False, use_true_rho=False,
-             move_positions=True, move_momenta=True, show_progress=True):
+             move_positions=True, move_momenta=True,
+             show_progress=True):
         """
         Perform N PIC cycles.
 
@@ -560,6 +561,11 @@ 
Source code for fbpic.main
                 # were smoothed/corrected, and copy the data from the GPU.)
                 diag.write( self.iteration )
 
+            # If spin tracking is enabled, store the previous momenta
+            for species in ptcl:
+                if species.spin_tracker is not None:
+                    species.spin_tracker.store_previous_momenta(species)
+
             # Push the particles' positions and velocities to t = (n+1/2) dt
             if move_momenta:
                 for species in ptcl:
@@ -567,6 +573,13 @@ 
Source code for fbpic.main
             if move_positions:
                 for species in ptcl:
                     species.push_x( 0.5*dt )
+
+            # Push the particles' spin to t = (n+1/2) dt
+            # averaging over velocities at t = (n-1/2) dt and t = (n+1/2) dt
+            for species in ptcl:
+                if species.spin_tracker is not None:
+                    species.spin_tracker.push_s(species)
+
             # Get positions/velocities for antenna particles at t = (n+1/2) dt
             for antenna in self.laser_antennas:
                 antenna.update_v( self.time + 0.5*dt, dt )
diff --git a/_modules/fbpic/openpmd_diag/boosted_field_diag.html b/_modules/fbpic/openpmd_diag/boosted_field_diag.html
index fb5fe34..a5daed8 100644
--- a/_modules/fbpic/openpmd_diag/boosted_field_diag.html
+++ b/_modules/fbpic/openpmd_diag/boosted_field_diag.html
@@ -3,14 +3,14 @@
 
   
   
-  fbpic.openpmd_diag.boosted_field_diag — FBPIC 0.25.0 documentation
+  fbpic.openpmd_diag.boosted_field_diag — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -30,7 +30,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/_modules/fbpic/openpmd_diag/boosted_particle_diag.html b/_modules/fbpic/openpmd_diag/boosted_particle_diag.html
index 8f10e1e..24aa05f 100644
--- a/_modules/fbpic/openpmd_diag/boosted_particle_diag.html
+++ b/_modules/fbpic/openpmd_diag/boosted_particle_diag.html
@@ -3,14 +3,14 @@
 
   
   
-  fbpic.openpmd_diag.boosted_particle_diag — FBPIC 0.25.0 documentation
+  fbpic.openpmd_diag.boosted_particle_diag — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -30,7 +30,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/_modules/fbpic/openpmd_diag/checkpoint_restart.html b/_modules/fbpic/openpmd_diag/checkpoint_restart.html
index 92ee09c..ce2202f 100644
--- a/_modules/fbpic/openpmd_diag/checkpoint_restart.html
+++ b/_modules/fbpic/openpmd_diag/checkpoint_restart.html
@@ -3,14 +3,14 @@
 
   
   
-  fbpic.openpmd_diag.checkpoint_restart — FBPIC 0.25.0 documentation
+  fbpic.openpmd_diag.checkpoint_restart — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -30,7 +30,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
@@ -82,7 +82,8 @@ 
Source code for fbpic.openpmd_diag.checkpoint_restart
It defines functions that can save checkpoints,
 as well as reload a simulation from a set of checkpoints.
 """
-import os, re
+import os
+import re
 import numpy as np
 from scipy.constants import e
 from .field_diag import FieldDiagnostic
@@ -94,6 +95,7 @@ 
Source code for fbpic.openpmd_diag.checkpoint_restart
if cuda_installed:
     import cupy
 
+
 

 [docs]
 def set_periodic_checkpoint( sim, period, checkpoint_dir='./checkpoints' ):
@@ -152,6 +154,7 @@ 
Source code for fbpic.openpmd_diag.checkpoint_restart
ParticleDiagnostic( period, particle_dict, write_dir=write_dir ) )

 
 
+
 

 [docs]
 def restart_from_checkpoint( sim, iteration=None,
@@ -269,6 +272,7 @@ 
Source code for fbpic.openpmd_diag.checkpoint_restart
sim.comm.shift_global_domain_positions( zmin_new - zmin_old )

 
 
+
 def check_restart( sim, iteration, checkpoint_dir ):
     """Verify that the restart is valid."""
 
@@ -360,6 +364,7 @@ 
Source code for fbpic.openpmd_diag.checkpoint_restart
length_new = grid.zmax - grid.zmin
     assert np.allclose( length_old, length_new )
 
+
 def load_species( species, name, ts, iteration, comm, openpmd_viewer_version ):
     """
     Read the species data from the checkpoint `ts`
@@ -423,6 +428,14 @@ 
Source code for fbpic.openpmd_diag.checkpoint_restart
species.ionizer.w_times_level = \
                     species.w * species.ionizer.ionization_level
 
+    # If species has spin tracking enabled, load the data
+    if species.spin_tracker is not None:
+        if 'spin/x' in ts.avail_record_components[name]:
+            species.spin_tracker.sx, species.spin_tracker.sy, \
+                species.spin_tracker.sz = ts.get_particle(
+                    ['spin/x', 'spin/y', 'spin/z'], iteration=iteration,
+                    species=name)
+
     # Reset the injection positions (for continuous injection)
     if species.continuous_injection:
         species.injector.reset_injection_positions()
@@ -430,6 +443,9 @@ 
Source code for fbpic.openpmd_diag.checkpoint_restart
# As a safe-guard, check that the loaded data is in float64
     for attr in ['x', 'y', 'z', 'ux', 'uy', 'uz', 'w', 'inv_gamma' ]:
         assert getattr( species, attr ).dtype == np.float64
+    if species.spin_tracker is not None:
+        for attr in ['sx', 'sy', 'sz']:
+            assert getattr(species.spin_tracker, attr).dtype == np.float64
 
     # Field arrays
     species.Ez = np.zeros( Ntot )
diff --git a/_modules/fbpic/openpmd_diag/field_diag.html b/_modules/fbpic/openpmd_diag/field_diag.html
index 7b42562..3839941 100644
--- a/_modules/fbpic/openpmd_diag/field_diag.html
+++ b/_modules/fbpic/openpmd_diag/field_diag.html
@@ -3,14 +3,14 @@
 
   
   
-  fbpic.openpmd_diag.field_diag — FBPIC 0.25.0 documentation
+  fbpic.openpmd_diag.field_diag — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -30,7 +30,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/_modules/fbpic/openpmd_diag/particle_density_diag.html b/_modules/fbpic/openpmd_diag/particle_density_diag.html
index 54ca2e5..3a754fc 100644
--- a/_modules/fbpic/openpmd_diag/particle_density_diag.html
+++ b/_modules/fbpic/openpmd_diag/particle_density_diag.html
@@ -3,14 +3,14 @@
 
   
   
-  fbpic.openpmd_diag.particle_density_diag — FBPIC 0.25.0 documentation
+  fbpic.openpmd_diag.particle_density_diag — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -30,7 +30,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/_modules/fbpic/openpmd_diag/particle_diag.html b/_modules/fbpic/openpmd_diag/particle_diag.html
index 9b20a60..a1e1cf4 100644
--- a/_modules/fbpic/openpmd_diag/particle_diag.html
+++ b/_modules/fbpic/openpmd_diag/particle_diag.html
@@ -3,14 +3,14 @@
 
   
   
-  fbpic.openpmd_diag.particle_diag — FBPIC 0.25.0 documentation
+  fbpic.openpmd_diag.particle_diag — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -30,7 +30,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
@@ -129,7 +129,9 @@ 
Source code for fbpic.openpmd_diag.particle_diag

             "E" and "B" writes the E and B fields at the particles' positions,
             respectively, but is turned off by default.
             "gamma" writes the particles' Lorentz factor.
-            By default, if a particle is tracked, its id is always written.
+            By default, if a particle is tracked, its id is always written;
+            Also, if a particle has spin tracking enabled, the spin components
+            are written to file.
 
         select : dict, optional
             Either None or a dictionary of rules
@@ -202,7 +204,9 @@ 
Source code for fbpic.openpmd_diag.particle_diag

                 self.array_quantities_dict[species_name] += ["charge"]
             else:
                 self.constant_quantities_dict[species_name] += ["charge"]
-
+            # If spin tracking is enabled, save the spin automatically
+            if species.spin_tracker is not None:
+                self.array_quantities_dict[species_name] += ['sx', 'sy', 'sz']
 
     def setup_openpmd_species_group( self, grp, species, constant_quantities ) :
         """
@@ -399,6 +403,11 @@ 
Source code for fbpic.openpmd_diag.particle_diag

                 self.write_dataset( species_grp, species, quantity_path,
                         quantity, n_rank, Ntot, select_array )
 
+            elif quantity in ["sx", "sy", "sz"]:
+                quantity_path = "spin/%s" % (quantity[-1])
+                self.write_dataset(species_grp, species, quantity_path,
+                                   quantity, n_rank, Ntot, select_array)
+
             elif quantity in ["Ex" , "Ey" , "Ez"]:
                 quantity_path = "E/%s" %(quantity[-1])
                 self.write_dataset( species_grp, species, quantity_path,
@@ -420,7 +429,7 @@ 
Source code for fbpic.openpmd_diag.particle_diag

                     self.setup_openpmd_species_record(
                         species_grp[quantity_path], quantity_path )
 
-            else :
+            else:
                 raise ValueError("Invalid string in %s of species"
                     				 %(quantity))
 
@@ -432,6 +441,9 @@ 
Source code for fbpic.openpmd_diag.particle_diag

             if "ux" in particle_data:
                 self.setup_openpmd_species_record(
                     species_grp["momentum"], "momentum" )
+            if "sx" in particle_data:
+                self.setup_openpmd_species_record(
+                    species_grp["spin"], "spin")
             if "Ex" in particle_data:
                 self.setup_openpmd_species_record(
                     species_grp["E"], "E" )
@@ -439,7 +451,6 @@ 
Source code for fbpic.openpmd_diag.particle_diag

                 self.setup_openpmd_species_record(
                     species_grp["B"], "B" )
 
-
     def apply_selection( self, species ) :
         """
         Apply the rules of self.select to determine which
@@ -485,7 +496,6 @@ 
Source code for fbpic.openpmd_diag.particle_diag

 
         return( select_array )
 
-
     def write_dataset( self, species_grp, species, path, quantity,
                        n_rank, Ntot, select_array ) :
         """
@@ -497,7 +507,7 @@ 
Source code for fbpic.openpmd_diag.particle_diag

             The group where to write the species considered
 
         species : a warp Species object
-        	The species object to get the particle data from
+            The species object to get the particle data from
 
         path : string
             The relative path where to write the dataset,
@@ -511,7 +521,7 @@ 
Source code for fbpic.openpmd_diag.particle_diag

             A list containing the number of particles to send on each proc
 
         Ntot : int
-        	Contains the global number of particles
+            Contains the global number of particles
 
         select_array : 1darray of bool
             An array of the same shape as that particle array
@@ -536,7 +546,7 @@ 
Source code for fbpic.openpmd_diag.particle_diag

         # Fill the dataset with the quantity
         quantity_array = self.get_dataset( species, quantity, select_array,
                                            n_rank, Ntot )
-        if self.rank==0:
+        if self.rank == 0:
             dset[:] = quantity_array
 
     def get_dataset( self, species, quantity, select_array, n_rank, Ntot ) :
@@ -544,7 +554,7 @@ 
Source code for fbpic.openpmd_diag.particle_diag

         Extract the array that satisfies select_array
 
         species : a Particles object
-        	The species object to get the particle data from
+            The species object to get the particle data from
 
         quantity : string
             The quantity to be extracted (e.g. 'x', 'uz', 'w')
@@ -555,7 +565,7 @@ 
Source code for fbpic.openpmd_diag.particle_diag

             the rules of self.select
 
         n_rank: list of ints
-        	A list containing the number of particles to send on each proc
+            A list containing the number of particles to send on each proc
 
         Ntot : int
             Length of the final array (selected + gathered from all proc)
@@ -569,6 +579,8 @@ 
Source code for fbpic.openpmd_diag.particle_diag

             quantity_one_proc = species.w
         elif quantity == "gamma":
             quantity_one_proc = 1.0/getattr( species, "inv_gamma" )
+        elif quantity in ['sx', 'sy', 'sz']:
+            quantity_one_proc = getattr(species.spin_tracker, quantity)
         else:
             quantity_one_proc = getattr( species, quantity )
 
diff --git a/_modules/fbpic/utils/random_seed.html b/_modules/fbpic/utils/random_seed.html
index 8a79bab..d9b1ad2 100644
--- a/_modules/fbpic/utils/random_seed.html
+++ b/_modules/fbpic/utils/random_seed.html
@@ -3,14 +3,14 @@
 
   
   
-  fbpic.utils.random_seed — FBPIC 0.25.0 documentation
+  fbpic.utils.random_seed — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -30,7 +30,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/_modules/index.html b/_modules/index.html
index 2ea83a9..9a18869 100644
--- a/_modules/index.html
+++ b/_modules/index.html
@@ -3,14 +3,14 @@
 
   
   
-  Overview: module code — FBPIC 0.25.0 documentation
+  Overview: module code — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -30,7 +30,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/_sources/api_reference/particles.rst.txt b/_sources/api_reference/particles.rst.txt
index 2edc0e4..532ec7a 100644
--- a/_sources/api_reference/particles.rst.txt
+++ b/_sources/api_reference/particles.rst.txt
@@ -22,3 +22,5 @@ the list ``Simulation.ptcl``.
 
    .. automethod:: track
    .. automethod:: make_ionizable
+   .. automethod:: activate_spin_tracking
+
diff --git a/_sources/install/install_local.rst.txt b/_sources/install/install_local.rst.txt
index 39cd30a..db706c4 100644
--- a/_sources/install/install_local.rst.txt
+++ b/_sources/install/install_local.rst.txt
@@ -39,14 +39,12 @@ Python. If Anaconda is not your default Python distribution, download and instal
        A shortcut for this is: ``python3 -m pip install git+https://github.com/fbpic/fbpic.git``.
 
 -  **Optional:** In order to be able to run the code on a GPU,
-   install the additional package ``cudatoolkit`` and ``cupy`` --
-   e.g. using CUDA version 11.0:
+   install the additional package ``cupy``.
 
    ::
 
 
-       conda install -c conda-forge cudatoolkit=11.0
-       pip install cupy-cuda110
+       conda install -c conda-forge cupy
 
    .. warning::
 
diff --git a/_static/documentation_options.js b/_static/documentation_options.js
index 5d62d54..999ee17 100644
--- a/_static/documentation_options.js
+++ b/_static/documentation_options.js
@@ -1,5 +1,5 @@
 const DOCUMENTATION_OPTIONS = {
-    VERSION: '0.25.0',
+    VERSION: '0.26.0',
     LANGUAGE: 'en',
     COLLAPSE_INDEX: false,
     BUILDER: 'html',
diff --git a/advanced/3d_visualization.html b/advanced/3d_visualization.html
index fb2ea8e..fef27ad 100644
--- a/advanced/3d_visualization.html
+++ b/advanced/3d_visualization.html
@@ -4,14 +4,14 @@
   
 
   
-  3D visualization using PyVista — FBPIC 0.25.0 documentation
+  3D visualization using PyVista — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -32,7 +32,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/advanced/advanced.html b/advanced/advanced.html
index ea1edac..4fc7536 100644
--- a/advanced/advanced.html
+++ b/advanced/advanced.html
@@ -4,14 +4,14 @@
   
 
   
-  Advanced use — FBPIC 0.25.0 documentation
+  Advanced use — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/advanced/boosted_frame.html b/advanced/boosted_frame.html
index c6865d3..c9a38dc 100644
--- a/advanced/boosted_frame.html
+++ b/advanced/boosted_frame.html
@@ -4,14 +4,14 @@
   
 
   
-  Running boosted-frame simulations — FBPIC 0.25.0 documentation
+  Running boosted-frame simulations — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
         
@@ -34,7 +34,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/advanced/parameter_scans.html b/advanced/parameter_scans.html
index c83af56..8fa6eea 100644
--- a/advanced/parameter_scans.html
+++ b/advanced/parameter_scans.html
@@ -4,14 +4,14 @@
   
 
   
-  Performing parameter scans in parallel — FBPIC 0.25.0 documentation
+  Performing parameter scans in parallel — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/advanced/profiling.html b/advanced/profiling.html
index 5468c4a..8df0b99 100644
--- a/advanced/profiling.html
+++ b/advanced/profiling.html
@@ -4,14 +4,14 @@
   
 
   
-  Profiling the code — FBPIC 0.25.0 documentation
+  Profiling the code — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/api_reference/api_reference.html b/api_reference/api_reference.html
index 6432e14..71a014f 100644
--- a/api_reference/api_reference.html
+++ b/api_reference/api_reference.html
@@ -4,14 +4,14 @@
   
 
   
-  API reference — FBPIC 0.25.0 documentation
+  API reference — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/api_reference/boost_converter.html b/api_reference/boost_converter.html
index 46edbba..431d322 100644
--- a/api_reference/boost_converter.html
+++ b/api_reference/boost_converter.html
@@ -4,14 +4,14 @@
   
 
   
-  Conversion to boosted-frame — FBPIC 0.25.0 documentation
+  Conversion to boosted-frame — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/api_reference/checkpoint_restart.html b/api_reference/checkpoint_restart.html
index 1e75a59..972582f 100644
--- a/api_reference/checkpoint_restart.html
+++ b/api_reference/checkpoint_restart.html
@@ -4,14 +4,14 @@
   
 
   
-  Checkpoints and restarts — FBPIC 0.25.0 documentation
+  Checkpoints and restarts — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/api_reference/diagnostics.html b/api_reference/diagnostics.html
index 158bd64..e7579c2 100644
--- a/api_reference/diagnostics.html
+++ b/api_reference/diagnostics.html
@@ -4,14 +4,14 @@
   
 
   
-  The openPMD diagnostics — FBPIC 0.25.0 documentation
+  The openPMD diagnostics — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
@@ -172,7 +172,9 @@ 
Particle diagnostic
 
   
-  Beam initialization — FBPIC 0.25.0 documentation
+  Beam initialization — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/api_reference/lpa_utilities/external_fields.html b/api_reference/lpa_utilities/external_fields.html
index 8a344eb..2ec5817 100644
--- a/api_reference/lpa_utilities/external_fields.html
+++ b/api_reference/lpa_utilities/external_fields.html
@@ -4,14 +4,14 @@
   
 
   
-  External fields — FBPIC 0.25.0 documentation
+  External fields — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/api_reference/lpa_utilities/laser.html b/api_reference/lpa_utilities/laser.html
index 2b7f077..ba93a2a 100644
--- a/api_reference/lpa_utilities/laser.html
+++ b/api_reference/lpa_utilities/laser.html
@@ -4,14 +4,14 @@
   
 
   
-  Laser initialization — FBPIC 0.25.0 documentation
+  Laser initialization — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
         
@@ -34,7 +34,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/api_reference/lpa_utilities/laser_profiles/donut_laguerre.html b/api_reference/lpa_utilities/laser_profiles/donut_laguerre.html
index 886ebde..a7f454b 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 @@
   
 
   
-  Donut-like Laguerre-Gauss profile — FBPIC 0.25.0 documentation
+  Donut-like Laguerre-Gauss profile — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
         
@@ -34,7 +34,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/api_reference/lpa_utilities/laser_profiles/few_cycle.html b/api_reference/lpa_utilities/laser_profiles/few_cycle.html
index 250d329..e092f12 100644
--- a/api_reference/lpa_utilities/laser_profiles/few_cycle.html
+++ b/api_reference/lpa_utilities/laser_profiles/few_cycle.html
@@ -4,14 +4,14 @@
   
 
   
-  Few-cycle profile — FBPIC 0.25.0 documentation
+  Few-cycle profile — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
         
@@ -34,7 +34,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/api_reference/lpa_utilities/laser_profiles/flattened.html b/api_reference/lpa_utilities/laser_profiles/flattened.html
index 01a0fa1..eaac322 100644
--- a/api_reference/lpa_utilities/laser_profiles/flattened.html
+++ b/api_reference/lpa_utilities/laser_profiles/flattened.html
@@ -4,14 +4,14 @@
   
 
   
-  Flattened Gaussian profile — FBPIC 0.25.0 documentation
+  Flattened Gaussian profile — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
         
@@ -34,7 +34,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/api_reference/lpa_utilities/laser_profiles/from_lasy_file.html b/api_reference/lpa_utilities/laser_profiles/from_lasy_file.html
index 1442c9b..a2437dc 100644
--- a/api_reference/lpa_utilities/laser_profiles/from_lasy_file.html
+++ b/api_reference/lpa_utilities/laser_profiles/from_lasy_file.html
@@ -4,14 +4,14 @@
   
 
   
-  Profile from a file produced by lasy — FBPIC 0.25.0 documentation
+  Profile from a file produced by lasy — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/api_reference/lpa_utilities/laser_profiles/gaussian.html b/api_reference/lpa_utilities/laser_profiles/gaussian.html
index e84699d..2b40ed4 100644
--- a/api_reference/lpa_utilities/laser_profiles/gaussian.html
+++ b/api_reference/lpa_utilities/laser_profiles/gaussian.html
@@ -4,14 +4,14 @@
   
 
   
-  Gaussian profile — FBPIC 0.25.0 documentation
+  Gaussian profile — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
         
@@ -34,7 +34,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/api_reference/lpa_utilities/laser_profiles/laguerre.html b/api_reference/lpa_utilities/laser_profiles/laguerre.html
index 0180cf4..645a8cd 100644
--- a/api_reference/lpa_utilities/laser_profiles/laguerre.html
+++ b/api_reference/lpa_utilities/laser_profiles/laguerre.html
@@ -4,14 +4,14 @@
   
 
   
-  Laguerre-Gauss profile — FBPIC 0.25.0 documentation
+  Laguerre-Gauss profile — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
         
@@ -34,7 +34,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/api_reference/lpa_utilities/lpa_utilities.html b/api_reference/lpa_utilities/lpa_utilities.html
index 697c067..e3126fe 100644
--- a/api_reference/lpa_utilities/lpa_utilities.html
+++ b/api_reference/lpa_utilities/lpa_utilities.html
@@ -4,14 +4,14 @@
   
 
   
-  Laser-plasma utilities — FBPIC 0.25.0 documentation
+  Laser-plasma utilities — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
diff --git a/api_reference/particles.html b/api_reference/particles.html
index 814ee3f..d8bce34 100644
--- a/api_reference/particles.html
+++ b/api_reference/particles.html
@@ -4,16 +4,17 @@
   
 
   
-  The Particles class — FBPIC 0.25.0 documentation
+  The Particles class — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
+        
     
     
     
@@ -33,7 +34,7 @@
             FBPIC
           
               

-                0.25.0
+                0.26.0
               

 

   
@@ -53,6 +54,7 @@
 
  • fbpic.particles.Particles
    • 
 
  • fbpic.particles.Particles.Particles.track()
    • 
 
  • fbpic.particles.Particles.Particles.make_ionizable()
    • 
+
  • fbpic.particles.Particles.Particles.activate_spin_tracking()
    • 
 
 
 
  • The openPMD diagnostics
    • 
@@ -161,6 +163,57 @@ 
    The Particles class
+
    
+Particles.activate_spin_tracking(sx_m=0.0, sy_m=0.0, sz_m=1.0, anom=0.00115965218128, spin_distr='fixed')
    
+
    Activate spin tracking for this particle. This will
+enable calculating the evolution of particle spin
+vector throughout the simulation.
    
+
    
+\[\frac{d\boldsymbol{s}}{dt} = (\boldsymbol{\Omega}_T +
+ \boldsymbol{\Omega}_a) \times \boldsymbol{s}\]
    
+
    where
    
+
    
+\[\boldsymbol{\Omega}_T = \frac{q}{m}\left(
+     \frac{\boldsymbol{B}}{\gamma} -
+     \frac{\boldsymbol{B}}{1+\gamma}
+     \times \frac{\boldsymbol{E}}{c} \right)\]
    
+
    and
    
+
    
+\[\boldsymbol{\Omega}_a = a_e \frac{q}{m}\left(
+     \boldsymbol{B} -
+     \frac{\gamma}{1+\gamma}\boldsymbol{\beta}
+     (\boldsymbol{\beta}\cdot\boldsymbol{B}) -
+     \boldsymbol{\beta} \times \frac{\boldsymbol{E}}{c} \right)\]
    
+
    Here, \(a_e\) is the anomalous magnetic moment of the particle,
+\(\gamma\) is the Lorentz factor of the particle,
+\(\boldsymbol{\beta}=\boldsymbol{v}/c\) is the normalised velocity
    
+
    The implementation of the push algorithm is detailed in
+https://arxiv.org/abs/2303.16966.
    
+
    Note: spin tracking must be activated _before_ making
+a species ionizable, otherwise an error will be raised.
    
+
    
+
    Parameters:
    
+
      
+
    • sx_m (float (dimensionless), optional) – The species-averaged average projection onto the x-axis
      • 
+
    • sy_m (float (dimensionless), optional) – The species-averaged average projection onto the y-axis
      • 
+
    • sz_m (float (dimensionless), optional) – The species-averaged average projection onto the z-axis
      • 
+
    • anom (float) – The anomalous magnetic moment of the particle.
+Default value is that of an electron.
      • 
+
    • spin_distr (str, optional) – If ‘fixed’, all particles will have a fixed spin value
+equal to s{x,y,z}_m.
+If ‘rand’, the spin vectors will be random, but with an
+ensemble average defined by one of the values of
+s{x,y,z}_m. The first non-zero mean component will be
+used, with order of preference being x,y,z, ie if sx_m!=0,
+the generated spins will have an ensemble averages of
+<sx>=sx_m, <sy>=0, <sz>=0, or if sz_m!=0, <sx>=0, <sy>=0
+and <sz>=sz_m.
      • 
+
    
+
    
+
    
+
    
+
 
 
 
diff --git a/api_reference/simulation.html b/api_reference/simulation.html
index 88ec848..130780b 100644
--- a/api_reference/simulation.html
+++ b/api_reference/simulation.html
@@ -4,14 +4,14 @@
   
 
   
-  The Simulation class — FBPIC 0.25.0 documentation
+  The Simulation class — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
    
-                0.25.0
+                0.26.0
               
    
 
    
   
diff --git a/api_reference/smoothing.html b/api_reference/smoothing.html
index 81e6c1b..57ed96f 100644
--- a/api_reference/smoothing.html
+++ b/api_reference/smoothing.html
@@ -4,14 +4,14 @@
   
 
   
-  Field smoothing — FBPIC 0.25.0 documentation
+  Field smoothing — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
    
-                0.25.0
+                0.26.0
               
    
 
    
   
diff --git a/example_input/boosted_frame_script.html b/example_input/boosted_frame_script.html
index 29beb7a..211705e 100644
--- a/example_input/boosted_frame_script.html
+++ b/example_input/boosted_frame_script.html
@@ -4,14 +4,14 @@
   
 
   
-  Boosted-frame simulation of laser-wakefield acceleration — FBPIC 0.25.0 documentation
+  Boosted-frame simulation of laser-wakefield acceleration — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
    
-                0.25.0
+                0.26.0
               
    
 
    
   
diff --git a/example_input/ionization_script.html b/example_input/ionization_script.html
index e8834c6..34c12cc 100644
--- a/example_input/ionization_script.html
+++ b/example_input/ionization_script.html
@@ -4,14 +4,14 @@
   
 
   
-  Laser-wakefield acceleration with ionization — FBPIC 0.25.0 documentation
+  Laser-wakefield acceleration with ionization — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
    
-                0.25.0
+                0.26.0
               
    
 
    
   
diff --git a/example_input/lwfa_script.html b/example_input/lwfa_script.html
index 78aec70..8b00023 100644
--- a/example_input/lwfa_script.html
+++ b/example_input/lwfa_script.html
@@ -4,14 +4,14 @@
   
 
   
-  Standard simulation of laser-wakefield acceleration — FBPIC 0.25.0 documentation
+  Standard simulation of laser-wakefield acceleration — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
    
-                0.25.0
+                0.26.0
               
    
 
    
   
diff --git a/genindex.html b/genindex.html
index bba7667..8e9c5cb 100644
--- a/genindex.html
+++ b/genindex.html
@@ -3,14 +3,14 @@
 
   
   
-  Index — FBPIC 0.25.0 documentation
+  Index — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -30,7 +30,7 @@
             FBPIC
           
               
    
-                0.25.0
+                0.26.0
               
    
 
    
   
@@ -96,16 +96,18 @@ 
    Index
    
 
    A
    
 
    
   
   
      
+      
    • add_particle_bunch() (in module fbpic.lpa_utils.bunch)
+
      • 
       
    • add_particle_bunch_file() (in module fbpic.lpa_utils.bunch)
 
      • 
       
    • add_particle_bunch_from_arrays() (in module fbpic.lpa_utils.bunch)
diff --git a/how_to_run.html b/how_to_run.html
index c4144e5..838fae2 100644
--- a/how_to_run.html
+++ b/how_to_run.html
@@ -4,14 +4,14 @@
   
 
   
-  How to run the code — FBPIC 0.25.0 documentation
+  How to run the code — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
      
-                0.25.0
+                0.26.0
               
      
 
      
   
diff --git a/index.html b/index.html
index ca6f8fa..e3d328d 100644
--- a/index.html
+++ b/index.html
@@ -4,14 +4,14 @@
   
 
   
-  FBPIC documentation — FBPIC 0.25.0 documentation
+  FBPIC documentation — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -32,7 +32,7 @@
             FBPIC
           
               
      
-                0.25.0
+                0.26.0
               
      
 
      
   
diff --git a/install/install_comet.html b/install/install_comet.html
index b7fab30..e7860e0 100644
--- a/install/install_comet.html
+++ b/install/install_comet.html
@@ -4,14 +4,14 @@
   
 
   
-  Installation on Comet (SDSC) — FBPIC 0.25.0 documentation
+  Installation on Comet (SDSC) — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
      
-                0.25.0
+                0.26.0
               
      
 
      
   
diff --git a/install/install_juwels.html b/install/install_juwels.html
index 36fb471..6f7072c 100644
--- a/install/install_juwels.html
+++ b/install/install_juwels.html
@@ -4,14 +4,14 @@
   
 
   
-  Installation on JUWELS (JSC) — FBPIC 0.25.0 documentation
+  Installation on JUWELS (JSC) — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
      
-                0.25.0
+                0.26.0
               
      
 
      
   
diff --git a/install/install_lawrencium.html b/install/install_lawrencium.html
index 7cfd337..89912e6 100644
--- a/install/install_lawrencium.html
+++ b/install/install_lawrencium.html
@@ -4,14 +4,14 @@
   
 
   
-  Installation on Lawrencium (LBNL) — FBPIC 0.25.0 documentation
+  Installation on Lawrencium (LBNL) — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
      
-                0.25.0
+                0.26.0
               
      
 
      
   
diff --git a/install/install_local.html b/install/install_local.html
index 2528a08..ed169a6 100644
--- a/install/install_local.html
+++ b/install/install_local.html
@@ -4,14 +4,14 @@
   
 
   
-  Installation on a local computer — FBPIC 0.25.0 documentation
+  Installation on a local computer — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
      
-                0.25.0
+                0.26.0
               
      
 
      
   
@@ -125,10 +125,8 @@ 
      Installing FBPICcudatoolkit and cupy –
-e.g. using CUDA version 11.0:
      
-
      conda install -c conda-forge cudatoolkit=11.0
-pip install cupy-cuda110
+install the additional package cupy.
      
+
      conda install -c conda-forge cupy
 
      
 
      
 
      
diff --git a/install/install_perlmutter.html b/install/install_perlmutter.html
index a5ea9ac..70cd181 100644
--- a/install/install_perlmutter.html
+++ b/install/install_perlmutter.html
@@ -4,14 +4,14 @@
   
 
   
-  Installation on Perlmutter (NERSC) — FBPIC 0.25.0 documentation
+  Installation on Perlmutter (NERSC) — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
      
-                0.25.0
+                0.26.0
               
      
 
      
   
diff --git a/install/install_summit.html b/install/install_summit.html
index 1247d58..b5edebc 100644
--- a/install/install_summit.html
+++ b/install/install_summit.html
@@ -4,14 +4,14 @@
   
 
   
-  Installation on Summit (OLCF) — FBPIC 0.25.0 documentation
+  Installation on Summit (OLCF) — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
      
-                0.25.0
+                0.26.0
               
      
 
      
   
diff --git a/install/installation.html b/install/installation.html
index 974b29b..118d010 100644
--- a/install/installation.html
+++ b/install/installation.html
@@ -4,14 +4,14 @@
   
 
   
-  Installation — FBPIC 0.25.0 documentation
+  Installation — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
      
-                0.25.0
+                0.26.0
               
      
 
      
   
diff --git a/objects.inv b/objects.inv
index 69986e7..9f7dc72 100644
Binary files a/objects.inv and b/objects.inv differ
diff --git a/overview/overview.html b/overview/overview.html
index 1a91288..29dde82 100644
--- a/overview/overview.html
+++ b/overview/overview.html
@@ -4,14 +4,14 @@
   
 
   
-  Overview of the code — FBPIC 0.25.0 documentation
+  Overview of the code — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
      
-                0.25.0
+                0.26.0
               
      
 
      
   
diff --git a/overview/parallelisation.html b/overview/parallelisation.html
index db1de1d..f138b05 100644
--- a/overview/parallelisation.html
+++ b/overview/parallelisation.html
@@ -4,14 +4,14 @@
   
 
   
-  Parallelization of FBPIC — FBPIC 0.25.0 documentation
+  Parallelization of FBPIC — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
      
-                0.25.0
+                0.26.0
               
      
 
      
   
diff --git a/overview/pic_algorithm.html b/overview/pic_algorithm.html
index 8f5e054..382992e 100644
--- a/overview/pic_algorithm.html
+++ b/overview/pic_algorithm.html
@@ -4,14 +4,14 @@
   
 
   
-  FBPIC algorithm & features — FBPIC 0.25.0 documentation
+  FBPIC algorithm & features — FBPIC 0.26.0 documentation
       
       
   
   
-        
+        
         
         
         
@@ -34,7 +34,7 @@
             FBPIC
           
               
      
-                0.25.0
+                0.26.0
               
      
 
      
   
diff --git a/search.html b/search.html
index c810e18..c623b83 100644
--- a/search.html
+++ b/search.html
@@ -3,7 +3,7 @@
 
   
   
-  Search — FBPIC 0.25.0 documentation
+  Search — FBPIC 0.26.0 documentation
       
       
     
@@ -11,7 +11,7 @@
     
   
   
-        
+        
         
         
     
@@ -33,7 +33,7 @@
             FBPIC
           
               
      
-                0.25.0
+                0.26.0
               
      
 
      
   
diff --git a/searchindex.js b/searchindex.js
index d85d238..4ff42a2 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/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 lasy", "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
+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 lasy", "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, 19, 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, 19, 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, 19, 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, 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, 19], "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, 19, 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, 19, 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, 19, 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, 19], "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, 19, 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, 8, 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, 32, 35, 36], "associ": [2, 23], "phase": [2, 9, 11, 12, 13, 14, 16, 17], "veloc": [2, 6, 11, 19, 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, 19, 20, 36], "gener": [2, 9, 19, 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, 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, 19], "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, 19, 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, 19, 20, 25, 30, 35], "valid": [2, 11, 19], "do": [2, 4, 11, 19, 25, 30], "non": [2, 17, 19, 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, 19, 20, 23, 24], "hand": [2, 7], "side": [2, 4, 11], "left": [2, 3, 8, 11, 12, 13, 14, 16, 17, 19, 20, 23, 24, 35], "chosen": [2, 15, 19, 36], "insuffici": 2, "some": [2, 3, 8, 11, 25], "incomplet": 2, "being": [2, 6, 10, 15, 19, 29], "zero": [2, 15, 19], "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, 19, 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, 19, 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, 19, 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, 19], "beta": [2, 19], "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, 19, 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, 19, 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, 19, 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, 19], "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, 19, 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, 19, 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, 19], "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, 19, 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, 8, 19, 25, 28], "disabl": [4, 25], "dump_stat": 4, "cpu_": 4, "d": [4, 19, 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, 19, 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, 19, 20, 22], "boost_particle_arrai": 6, "x": [6, 8, 9, 10, 11, 12, 13, 14, 16, 17, 19, 20, 22, 28], "y": [6, 9, 10, 19, 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, 19, 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, 19, 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, 19, 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, 19, 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], "spin": [8, 19], "compon": [8, 19], "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, 19, 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, 19], "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, 19], "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, 19], "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, 19, 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, 19], "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, "activate_spin_track": 19, "sx_m": 19, "sy_m": 19, "sz_m": 19, "anom": 19, "00115965218128": 19, "spin_distr": 19, "evolut": [19, 35, 36], "throughout": 19, "_t": 19, "_a": 19, "a_": 19, "anomal": 19, "normalis": 19, "push": [19, 20, 36], "http": [19, 20, 22, 23, 24, 27, 28, 30], "arxiv": [19, 22, 23, 24, 26, 36], "org": [19, 20, 22, 23, 24, 28], "ab": [19, 22, 23, 24], "2303": 19, "16966": 19, "must": 19, "_before_": 19, "rais": 19, "project": [19, 26, 32], "onto": [19, 35, 36], "str": [19, 20], "_m": 19, "rand": 19, "random": [19, 20, 23], "ensembl": 19, "prefer": 19, "ie": 19, "sx": 19, "sz": 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], "cubic": 20, "third": 20, "binomialsmooth": [20, 21], "binomi": [20, 21], "compens": [20, 21], "ruyten": 20, "105": 20, "1993": 20, "doi": 20, "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, "freez": 20, "random_se": [20, 23], "set_random_se": [20, 23], "seed": [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], "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, "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, 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, "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, "11": 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, "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, "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, "", "activate_spin_tracking"], [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"]], "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"]], "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"]]}, "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"]], "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"]], "activate_spin_tracking() (fbpic.particles.fbpic.particles.particles.particles method)": [[19, "fbpic.particles.fbpic.particles.Particles.Particles.activate_spin_tracking"]], "fbpic.particles.particles (built-in class)": [[19, "fbpic.particles.Particles"]], "make_ionizable() (fbpic.particles.fbpic.particles.particles.particles method)": [[19, "fbpic.particles.fbpic.particles.Particles.Particles.make_ionizable"]], "track() (fbpic.particles.fbpic.particles.particles.particles method)": [[19, "fbpic.particles.fbpic.particles.Particles.Particles.track"]], "simulation (class in fbpic.main)": [[20, "fbpic.main.Simulation"]], "add_new_species() (fbpic.main.simulation method)": [[20, "fbpic.main.Simulation.add_new_species"]], "set_moving_window() (fbpic.main.simulation method)": [[20, "fbpic.main.Simulation.set_moving_window"]], "set_random_seed() (in module fbpic.utils.random_seed)": [[20, "fbpic.utils.random_seed.set_random_seed"]], "step() (fbpic.main.simulation method)": [[20, "fbpic.main.Simulation.step"]], "binomialsmoother (class in fbpic.fields.smoothing)": [[21, "fbpic.fields.smoothing.BinomialSmoother"]]}})
\ No newline at end of file