orbit.utils.orbit_mpi_utils.bunch_orbit_to_pyorbit_nHarm

orbit.utils.orbit_mpi_utils.bunch_orbit_to_pyorbit_nHarm(ringLength, nHarm, kineticEnergy, name_of_orbit_mpi_bunch_file, pyOrbitBunch=None)

Translates ORBIT_MPI bunch to pyORBIT bunch, incorporating RF harmonic number, and returns it. PyORBIT bunch needs the ring length (m) and energy, mass, and charge of the synchronous particle, but ORBIT_MPI does not have it. So, this information is specified in pyOrbitBunch or it will be proton by default. Lines in bunch files: ORBIT_MPI: x[mm] xp[mrad] y[mm] yp[mrad] phi[rad] dE[GeV]. pyORBIT: x[m] xp[rad] y[m] yp[rad] z[m] dE[GeV]