Package: picassosr
A collection of tools for painting super-resolution images. The Picasso software is complemented by ourNature Protocols publication.
A comprehensive documentation can be found here:Read the Docs.Picasso 0.6.1In previous version, the rotation window (3D Render) showed an incorrect length of the scalebar. This has been fixed.Picasso 0.6.0RESI dialog added to Picasso Render, allowing for substantial boost in spatial resolution (Reinhardt, et al., Nature, 2023.DOI: 10.1038/s41586-023-05925-9).Previous versionsTo see all changes introduced in previous versions, clickhere.InstallationCheck out thePicasso release pageto download and run the latest compiled one-click installer for Windows. Here you will also find the Nature Protocols legacy version.For the platform-independent usage of Picasso (e.g., with Linux and Mac Os X), please follow the advanced installation instructions below.Other installation modes (Python 3.10)As an alternative to the stand-alone program for end-users, Picasso can be installed as a Python package. This is the preferred option to use Picasso’s internal routines in custom Python programs. Those can be imported by running, for example,from picasso import io(see the “Example usage” tab below) to use input/output functions from Picasso. For windows, it is still possible to use Picasso as an end-user by creating the respective shortcuts. This allows Picasso to be used on the same system by both programmers and end-users.Via PyPIOpen the console/terminal and create a new conda environment:conda create--namepicasso python=3.10Activate the environment:conda activate picasso.Install Picasso package using:pip install picassosr.You can now run any Picasso function directly from the console/terminal by running:picasso render,picasso localize, etc, or import Picasso functions in your own Python scripts.For DevelopersIf you wish to use your local version of Picasso with your own modifications:Open the console/terminal and create a new conda environment:conda create--namepicasso python=3.10Activate the environment:conda activate picasso.Change to the directory of choice usingcd.Clone this GitHub repository by runninggit clonehttps://github.com/jungmannlab/picasso. Alternatively,downloadthe zip file and unzip it.Open the Picasso directory:cd picasso.You can modify Picasso code in this directory.To create alocalPicasso package to use it in other Python scripts, runpip install-e.. When you change the code in thepicassodirectory, the changes will be reflected in the package.You can now run any Picasso function directly from the console/terminal by running:picasso render,picasso localize, etc, or import Picasso functions in your own Python scripts.Optional packagesRegardless of whether Picasso was installed via PyPI or by cloning the GitHub repository, some packages may be additionally installed to allow extra functionality:pip install pyinstallerif you plan to additionally compile your own installer withPyinstaller.(Windows only)pip installPyImarisWriter==0.7.0to enable .ims files in Localize and Render. Note thatPyImarisWriterhas been tested only on Windows.To enableGPU fitting, follow instructions onGpufitto install the Gpufit python library in your conda environment. In practice, this means downloading the zipfile and installing the Python wheel. Picasso Localize will automatically import the library if present and enables a checkbox for GPU fitting when selecting the LQ-Method.UpdatingIf Picasso was installed from PyPI, run the following command:pip install--upgradepicassosrCreating shortcuts on Windows (optional)Run the PowerShell script “createShortcuts.ps1” in the gui directory. This should be doable by right-clicking on the script and choosing “Run with PowerShell”. Alternatively, run the commandpowershell ./createShortcuts.ps1in the command line. Use the generated shortcuts in the top level directory to start GUI components. Users can drag these shortcuts to their Desktop, Start Menu or Task Bar.Example UsageBesides using the GUI, you can use picasso like any other Python module. Consider the following example::from picasso import io, postprocess

path = 'testdata_locs.hdf5'
locs, info = io.load_locs(path)
# Link localizations and calcualte dark times
linked_locs = postprocess.link(picked_locs, info, r_max=0.05, max_dark_time=1)
linked_locs_dark = postprocess.compute_dark_times(linked_locs)

print('Average bright time {:.2f} frames'.format(np.mean(linked_locs_dark.n)))
print('Average dark time {:.2f} frames'.format(np.mean(linked_locs_dark.dark)))This codeblock loads data from testdata_locs and uses the postprocess functions programmatically.Jupyter NotebooksCheck picasso/samples/ for Jupyter Notebooks that show how to interact with the Picasso codebase.ContributingIf you have a feature request or a bug report, please post it as an issue on the GitHub issue tracker. If you want to contribute, put a PR for it. You can find more guidelines for contributinghere. We will gladly guide you through the codebase and credit you accordingly. Additionally, you can check out theProjects-page on GitHub.  You can also contact us viapicasso@jungmannlab.org.Contributions & CopyrightContributors: Joerg Schnitzbauer, Maximilian Strauss, Rafal Kowalewski, Adrian Przybylski, Andrey Aristov, Hiroshi Sasaki, Alexander Auer, Johanna RahmCopyright (c) 2015-2019 Jungmann Lab, Max Planck Institute of BiochemistryCopyright (c) 2020-2021 Maximilian StraussCopyright (c) 2022-2023 Rafal KowalewskiCiting PicassoIf you use picasso in your research, please cite our Nature Protocols publication describing the software.J. Schnitzbauer*, M.T. Strauss*, T. Schlichthaerle, F. Schueder, R. JungmannSuper-Resolution Microscopy with DNA-PAINTNature Protocols (2017). 12: 1198-1228 DOI:https://doi.org/10.1038/nprot.2017.024CreditsDesign icon based on “Hexagon by Creative Stalls from the Noun
Project”Simulate icon based on “Microchip by Futishia from the Noun Project”Localize icon based on “Mountains by MONTANA RUCOBO from the Noun
Project”Filter icon based on “Funnel by José Campos from the Noun Project”Render icon based on “Paint Palette by Vectors Market from the Noun
Project”Average icon based on “Layers by Creative Stall from the Noun
Project”Server icon based on “Database by Nimal Raj from NounProject.com”