{"name":"faser","display_name":"faser","visibility":"public","icon":"","categories":[],"schema_version":"0.2.1","on_activate":null,"on_deactivate":null,"contributions":{"commands":[{"id":"faser.napari.helper_widget","title":"OpenHelper Widget","python_name":"faser.napari.widgets.helper_widget:HelperWidget","short_title":null,"category":null,"icon":null,"enablement":null},{"id":"faser.napari.main_widget","title":"Open Main Widget","python_name":"faser.napari.widgets.main_widget:MainWidget","short_title":null,"category":null,"icon":null,"enablement":null}],"readers":null,"writers":null,"widgets":[{"command":"faser.napari.helper_widget","display_name":"Faser (Helper)","autogenerate":false},{"command":"faser.napari.main_widget","display_name":"Faser (Generator)","autogenerate":false}],"sample_data":null,"themes":null,"menus":{},"submenus":null,"keybindings":null,"configuration":[]},"package_metadata":{"metadata_version":"2.4","name":"faser","version":"0.3.6","dynamic":null,"platform":null,"supported_platform":null,"summary":"Faser is a tool for vectorial psf simulation","description":"# faser\n\nfaser is a Python-based software package designed to simulate the excitation\npoint spread function (PSF) of optical microscopes. Faser calculates PSFs for high NA\nfocusing by using a vectorial model of the electromagnetic field, enabling exploration of the impact\nof geometrical and optical parameters on imaging performance in advanced applications. The\nsoftware supports various beam profiles, including those used in STED microscopy, and allows for\nthe simulation of common experimental conditions such as a cranial window and a coverslip tilt.\n\nWe provide to prefered ways to use faser:\n\n## Faser as a Napari Plugin\n\nThe recommended way to install faser is as a Napari plugin, which provides a user-friendly GUI for interactively exploring the PSF simulation. This can be done via:\n\n```bash\npip install faser napari[pyqt5]\n```\n\n#### Usage\n\nYou can run the GUI application via (or just as a Napari plugin)\n\n```bash\nqtfaser\n```\n\nFor more information on how to use the GUI, please refer to the [preprint](https://faser.readthedocs.io/en/latest/).\n\n## Faser as a standalone application\n\nAlternatively, you can install the package as a standalone application only, that you can run in enironments without Napari or GUI support:\n\n```bash\npip install faser[cli]\n```\nThis will install the package as a standalone application that can be run from the command line via:\n\n```bash\nfaser\n```\nWe generally recommend the GUI application for most users, as it provides a more user-friendly interface.\nHowever faser can also be used as a library, and the CLI application is useful for scripting and batch processing.\n\n#### Usage\n\nTo simulate the PSF, with a specific numerical aperture (NA) and a beam profile, you can run the following command:\n\n```bash\nfaser --na 1.4 --window=NO\n```\n\nFor more information and options you can run:\n\n```bash\nfaser --help\n```\n\nTo display the GUI interface and the available options:\n\n```\n __ \n / _| __ _ ___ ___ _ __ \n| |_ / _` / __|/ _ \\ '__|\n| _| (_| \\__ \\ __/ | \n|_| \\__,_|___/\\___|_| \n\nGenerating PSF with config\nfaser➜ faser git:(master) ✗ uv run faser --help\n \n Usage: faser [OPTIONS] \n \n╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮\n│ --config FILENAME Path to a JSON file │\n│ --detector_gaussian_noise FLOAT Detector Gaussian noise │\n│ --gaussian_beam_noise FLOAT Gaussian_beam noise │\n│ --add_noise NOISE │\n│ --loaded_phase_mask OPTIONAL Loaded Phasemak │\n│ --p FLOAT Ratio between Donut (p) and Bottle (1-p) intensity │\n│ --mask_offset_y FLOAT Y offset of the phase mask in regard to pupil center │\n│ --mask_offset_x FLOAT X offset of the phase mask in regard to pupil center │\n│ --ring_radius FLOAT Radius of the ring phase mask (on unit pupil) │\n│ --rc FLOAT Ring charge (should be odd to produce bottle) │\n│ --vc FLOAT Vortex charge (should be integer to produce donut) │\n│ --epsilon FLOAT Ellipticity of the polarization (in °) │\n│ --psi FLOAT Direction of the polarization (in °) │\n│ --ampl_offset_y FLOAT Y offset of the amplitude profile in regard to pupil center │\n│ --ampl_offset_x FLOAT X offset of the amplitude profile in regard to pupil center │\n│ --waist FLOAT Diameter of the input beam on the objective pupil (in µm) │\n│ --wavelength FLOAT Wavelength of light (in µm) │\n│ --polarization POLARIZATION │\n│ --mode MODE │\n│ --aberration_offset_y FLOAT Y offset of the aberration function in regard to pupil center │\n│ --aberration_offset_x FLOAT X offset of the aberration function in regard to pupil center │\n│ --a24 ABERRATIONFLOAT Secondary spherical │\n│ --a12 ABERRATIONFLOAT Primary spherical │\n│ --a9 ABERRATIONFLOAT Oblique Trefoil │\n│ --a8 ABERRATIONFLOAT Horizontal Coma │\n│ --a7 ABERRATIONFLOAT Vertical Coma │\n│ --a6 ABERRATIONFLOAT Vertical Trefoil │\n│ --a5 ABERRATIONFLOAT Vertical Astigmatism │\n│ --a4 ABERRATIONFLOAT Defocus │\n│ --a3 ABERRATIONFLOAT Oblique Astigmatism │\n│ --a2 ABERRATIONFLOAT Horizontal Tilt │\n│ --a1 ABERRATIONFLOAT Vertical Tilt │\n│ --a0 ABERRATIONFLOAT Piston │\n│ --wind_offset_y FLOAT Y offset of the cranial window in regard to pupil center │\n│ --wind_offset_x FLOAT X offset of the cranial window in regard to pupil center │\n│ --wind_depth FLOAT Depth of the cranial window (in mm) │\n│ --wind_radius FLOAT Diameter of the cranial window (in mm) │\n│ --window WINDOW │\n│ --tilt FLOAT Tilt angle of the coverslip (in °) │\n│ --depth FLOAT Imaging depth in the sample (in µm) │\n│ --collar FLOAT Correction collar setting to compensate coverslip thickness │\n│ --thickness FLOAT Thickness of the coverslip (in µm) │\n│ --n3 FLOAT Refractive index of the sample │\n│ --n2 FLOAT Refractive index of the coverslip │\n│ --n1 FLOAT Refractive index of the immersion medium │\n│ --wd FLOAT Working Distance of the objective lens (in µm) │\n│ --na FLOAT Numerical Aperture of Objective Lens │\n│ --normalize NORMALIZE │\n│ --nphi INTEGER Integration sted of the aximutal angle on the pupil │\n│ --ntheta INTEGER Integration sted of the focalization angle │\n│ --nz INTEGER Discretization of Z axis - better be odd number for perfect 0 │\n│ --nxy INTEGER Discretization of image plane - better be odd number for perfect 0 │\n│ --l_obs_z FLOAT Observation scale in Z (in µm) │\n│ --l_obs_xy FLOAT Observation scale in XY (in µm) │\n│ --help Show this message and exit. │\n╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯\n```\n\n\n","description_content_type":"text/markdown","keywords":"faser,napari,psf,simulation,vectorial","home_page":null,"download_url":null,"author":null,"author_email":"Johannes Roos , Stephane Bancelin ","maintainer":null,"maintainer_email":"Johannes Roos ","license":"The MIT License (MIT)\n\nCopyright (c) 2024 Kyle Harrington\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.","classifier":["Framework :: napari","Programming Language :: Python","Programming Language :: Python :: 3","Programming Language :: Python :: 3 :: Only","Programming Language :: Python :: 3.9","Programming Language :: Python :: 3.10","Programming Language :: Python :: 3.11","Programming Language :: Python :: 3.12"],"requires_dist":["matplotlib>=3.9.2","numpy<2","psygnal>=0.11.1","pydantic>2","python-slugify>=8.0.4","qtpy>=2.4.2","superqt>=0.6.7","tifffile>=2024.8.30","rich-click>=1.8.3; extra == 'cli'","pyqt5>=5.15.11; extra == 'full'","rich-click>=1.8.3; extra == 'full'","numba>=0.60.0; extra == 'numba'"],"requires_python":"<3.13,>=3.9","requires_external":null,"project_url":["Bug Tracker, https://jhnnsrs.github.io/faser/issues","Documentation, https://jhnnsrs.github.io/faser","Source Code, https://github.com/jhnnsrs/faser"],"provides_extra":["cli","full","numba"],"provides_dist":null,"obsoletes_dist":null},"npe1_shim":false}