# *Sion* package
Python package for simulation and analysis of ion crystals in surface electrode traps.
## Installation
To use *Sion*, the following packages are required to be installed from source and tested:
- [pylion package](https://bitbucket.org/dtrypogeorgos/pylion/src/master/): LAMMPS wrapper for ion dynamics simulation. This package requires installation of LAMMPS software with the specific version. It will work well with the latest LAMMPS version, if in source file *pylion.py* at line 51 you change "lmp_serial" to "lmp".
- [electrode package](https://github.com/nist-ionstorage/electrode): Python package for convenient definition and analysis of surface electrode traps.
!Note: for correct execution of these packages, numpy<=1.21.0 is required.
The newest version may be installed via pip:
<code>pip install surface-ion</code>
## Getting started
*Sion* works with surface traps, defined through the *electrode* package. The simulation of ion dynamics is carried through the *pylion* environment.
All functions, presented in *Sion* are described in example notebooks. Main file *sion.py* contains docs for each function.
To publish the results, obtained with *Sion*, the following articles should be cited:
1. [Surface trap with adjustable ion couplings for scalable and parallel gates](https://journals.aps.org/pra/abstract/10.1103/PhysRevA.109.022605)
## Features
* Simulation of ion motion in arbitrary polygon and point electrode surface trap.
* Optimization and simulation of arbitrary ion shuttling in polygon traps.
* Calculation of normal modes for general case of 1D, 2D, 3D mixed species ion crystals with arbitrary set of ions' secular frequencies.
* Calculation of anharmonic Mathieu modes of ion crystals in surface traps.
* Stability analysis of asymmetric planar traps.
* Optimization of DC voltage set of a planar trap to match the desired secular frequency and radial mode rotation angle in given positions.
* Convenient trap design. Layout may be imported from GDS file or created by defining the arbitrary electrode shape boundary.
## File structure
* 'build/lib/sion.py': contains all the main functions.
* 'examples': examples showing different features of *Sion*.
* 'tests': verifications and tests of *Sion* work.
Free software: MIT license
Raw data
{
"_id": null,
"home_page": "https://github.com/underforestaaa/Sion",
"name": "surface-ion",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "surface trap, ion, quantum computing, ion simulation, normal modes, mathieu modes, ion shuttling, voltage optimization",
"author": "Artem Podlesnyy",
"author_email": "a.podlesnyy@rqc.ru",
"download_url": "https://files.pythonhosted.org/packages/69/63/3ef80ed066eb45c23d681dbcbb9b115f8282b70066ce8e699f18b4be4743/surface-ion-1.0.4.tar.gz",
"platform": null,
"description": "# *Sion* package\r\n\r\nPython package for simulation and analysis of ion crystals in surface electrode traps.\r\n\r\n## Installation\r\n\r\nTo use *Sion*, the following packages are required to be installed from source and tested:\r\n- [pylion package](https://bitbucket.org/dtrypogeorgos/pylion/src/master/): LAMMPS wrapper for ion dynamics simulation. This package requires installation of LAMMPS software with the specific version. It will work well with the latest LAMMPS version, if in source file *pylion.py* at line 51 you change \"lmp_serial\" to \"lmp\". \r\n- [electrode package](https://github.com/nist-ionstorage/electrode): Python package for convenient definition and analysis of surface electrode traps. \r\n!Note: for correct execution of these packages, numpy<=1.21.0 is required. \r\n\r\nThe newest version may be installed via pip: \r\n<code>pip install surface-ion</code>\r\n\r\n\r\n## Getting started\r\n\r\n*Sion* works with surface traps, defined through the *electrode* package. The simulation of ion dynamics is carried through the *pylion* environment.\r\nAll functions, presented in *Sion* are described in example notebooks. Main file *sion.py* contains docs for each function.\r\n\r\nTo publish the results, obtained with *Sion*, the following articles should be cited:\r\n1. [Surface trap with adjustable ion couplings for scalable and parallel gates](https://journals.aps.org/pra/abstract/10.1103/PhysRevA.109.022605)\r\n\r\n\r\n## Features\r\n* Simulation of ion motion in arbitrary polygon and point electrode surface trap.\r\n* Optimization and simulation of arbitrary ion shuttling in polygon traps.\r\n* Calculation of normal modes for general case of 1D, 2D, 3D mixed species ion crystals with arbitrary set of ions' secular frequencies.\r\n* Calculation of anharmonic Mathieu modes of ion crystals in surface traps. \r\n* Stability analysis of asymmetric planar traps.\r\n* Optimization of DC voltage set of a planar trap to match the desired secular frequency and radial mode rotation angle in given positions.\r\n* Convenient trap design. Layout may be imported from GDS file or created by defining the arbitrary electrode shape boundary. \r\n\r\n## File structure\r\n\r\n* 'build/lib/sion.py': contains all the main functions.\r\n\r\n* 'examples': examples showing different features of *Sion*.\r\n\r\n* 'tests': verifications and tests of *Sion* work.\r\n\r\nFree software: MIT license\r\n",
"bugtrack_url": null,
"license": "MIT license",
"summary": "Python package for simulation and analysis of ion crystals in surface traps.",
"version": "1.0.4",
"project_urls": {
"Homepage": "https://github.com/underforestaaa/Sion"
},
"split_keywords": [
"surface trap",
" ion",
" quantum computing",
" ion simulation",
" normal modes",
" mathieu modes",
" ion shuttling",
" voltage optimization"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3a52248cd5bdb02fed48b4bf29c1648bfb8eac6cf912fc02e79088bc8b1aad95",
"md5": "175cccd70b4280154b163a7578aaa1da",
"sha256": "e50a540fbd709b0ae057c1f7ae077fb5793b983e9679cc6db16d7d50f2af6284"
},
"downloads": -1,
"filename": "surface_ion-1.0.4-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "175cccd70b4280154b163a7578aaa1da",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 51095,
"upload_time": "2024-11-05T19:16:59",
"upload_time_iso_8601": "2024-11-05T19:16:59.515828Z",
"url": "https://files.pythonhosted.org/packages/3a/52/248cd5bdb02fed48b4bf29c1648bfb8eac6cf912fc02e79088bc8b1aad95/surface_ion-1.0.4-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "69633ef80ed066eb45c23d681dbcbb9b115f8282b70066ce8e699f18b4be4743",
"md5": "bf317f030995b995ae9bc3e27fda834d",
"sha256": "4105864407a1cf4b5d613ac854a0c585295a82a4c4da865ee381fb877e24f944"
},
"downloads": -1,
"filename": "surface-ion-1.0.4.tar.gz",
"has_sig": false,
"md5_digest": "bf317f030995b995ae9bc3e27fda834d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 193354,
"upload_time": "2024-11-05T19:17:03",
"upload_time_iso_8601": "2024-11-05T19:17:03.020684Z",
"url": "https://files.pythonhosted.org/packages/69/63/3ef80ed066eb45c23d681dbcbb9b115f8282b70066ce8e699f18b4be4743/surface-ion-1.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-05 19:17:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "underforestaaa",
"github_project": "Sion",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "surface-ion"
}