AMS-BP 0.3.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

AMS_BP/resources/template_configs/twocolor_widefield_zstack_live.toml

@@ -0,0 +1,408 @@
+version = "0.2"
+length_unit = "um"        # always um.
+time_unit = "ms"          # always ms
+diffusion_unit = "um^2/s" # always um^2/s
+
+[Cell_Parameters]
+cell_type = "RodCell" # any of RectangularCell, SphericalCell, OvoidCell, RodCell, BuddingCell
+[Cell_Parameters.params] # see docs for parameters for each cell type
+center = [5, 5, 0]
+direction = [1, 0, 0]
+radius = 1.0
+height = 4.0
+# bounds = [[3, 7], [3, 9], [-1, 1]]
+
+[Molecule_Parameters]
+num_molecules = [
+	5000,
+	5000,
+] # size of array tells the types of molecules (must be same as num_of_fluorophores below). All of the Molecule_Parameters are of the same first dimension as this.
+track_type = ["fbm", "fbm"] # "constant", "fbm"
+diffusion_coefficient = [
+	[
+		0.2,
+		0.4,
+	],
+	[
+		0.2,
+		0.4,
+	],
+] # um^2/s, size of each index (eg. len(...[0]) is the # of diffusion coefficients the system can explore.
+
+hurst_exponent = [[0.5], [0.5]]
+allow_transition_probability = [true, true] # bool
+transition_matrix_time_step = [
+	20,
+	20,
+] # ms, the time at which the probabilities in the below are presented.
+diffusion_transition_matrix = [
+	[
+		[
+			0.992,
+			0.008,
+		],
+		[
+			0.0273,
+			0.9727,
+		],
+	],
+	[
+		[
+			0.992,
+			0.008,
+		],
+		[
+			0.0273,
+			0.9727,
+		],
+	],
+]
+hurst_transition_matrix = [[[0.1]], [[0.1]]]
+state_probability_diffusion = [[0.5, 0.5], [0.5, 0.5]]
+state_probability_hurst = [[1], [1]]
+
+
+[Global_Parameters]
+sample_plane_dim = [10, 10] # um
+cycle_count = 50            # cycles of exposure_time + interval_time
+exposure_time = 20          # ms
+interval_time = 0           # ms
+oversample_motion_time = 20 # ms
+
+[Condensate_Parameters]
+initial_centers = [
+	[
+		[
+			5.5,
+			5,
+			0.05,
+		],
+		[
+			5,
+			5,
+			-0.15,
+		],
+		[
+			4,
+			5,
+			-0.15,
+		],
+		[
+			6,
+			5.5,
+			-0.15,
+		],
+		[
+			6,
+			5.5,
+			-0.15,
+		],
+	],
+	[
+		[
+			4,
+			5,
+			0.05,
+		],
+		[
+			3,
+			5,
+			-0.15,
+		],
+	],
+] # um. First dimension is the types of molecules as in Molecule Parameters.num_molecules. second dimension is the # of condentates. center = [x,y,z]
+initial_scale = [[0.26, 0.26, 0.13, 0.13, 0.26], [0.26, 0.26]] # um
+diffusion_coefficient = [[0, 0, 0, 0, 0], [0, 0]] # um^2/s
+hurst_exponent = [[0.2, 0.2, 0.2, 0.2, 0.2], [0.2, 0.2]]
+density_dif = [10, 10] # density of the condensate vs the background.
+
+[Output_Parameters]
+output_path = "Output"
+output_name = "Cell_Movie_001"
+subsegment_type = "mean"       # not implemented yet, use any string
+subsegment_number = 5          # not implemented yet, use any integer
+
+
+[fluorophores]
+num_of_fluorophores = 2
+fluorophore_names = ["PAmCherry", "EGFP"]
+
+# PAmCherry name
+[fluorophores.PAmCherry]
+name = "PAmCherry"
+initial_state = "dark" # flurophore will start with this state in the simulation (all of them), must be valid name from ones provided below.
+
+# States definition
+[fluorophores.PAmCherry.states.bright]
+name = "bright"
+state_type = "fluorescent"         # any of fluorescent, dark, bleached
+quantum_yield = 0.46               # from 0-1
+extinction_coefficient = 18000     # M^-1 cm^-1
+fluorescent_lifetime = 0.000000001 # seconds
+# Spectral data for bright state
+[fluorophores.PAmCherry.states.bright.excitation_spectrum]
+wavelengths = [310.0, 311.0, 411.0, 511.0, 611.0, 612.0]
+intensities = [0.00, 0.047, 0.0043, 0.6, 0.06, 0.00]
+[fluorophores.PAmCherry.states.bright.emission_spectrum]
+wavelengths = [530.0, 529.0, 600.0, 650.0, 700.0, 797.0, 799.0]
+intensities = [0.00, 0.02, 0.98, 0.28, 0.05, 0.003, 0.00]
+
+[fluorophores.PAmCherry.states.dark]
+name = "dark"
+state_type = "dark"
+
+[fluorophores.PAmCherry.states.triplet]
+name = "triplet"
+state_type = "dark"
+
+[fluorophores.PAmCherry.states.bleached]
+name = "bleached"
+state_type = "bleached"
+
+# State transitions
+
+[fluorophores.PAmCherry.transitions.dark_to_bright]
+from_state = "dark"
+to_state = "bright"
+photon_dependent = true
+[fluorophores.PAmCherry.transitions.dark_to_bright.spectrum]
+wavelengths = [308.0, 309.0, 359.0, 403.0, 440.0, 484.0, 485.0]
+intensities = [0.00, 0.04, 0.11, 1.0, 0.07, 0.0004, 0.00]
+extinction_coefficient = 6500                                   # M^-1 cm^-1
+quantum_yield = 0.000005                                        # switching events per photons absorbed
+
+
+[fluorophores.PAmCherry.transitions.bright_to_bleached]
+from_state = "bright"
+to_state = "bleached"
+photon_dependent = true
+[fluorophores.PAmCherry.transitions.bright_to_bleached.spectrum]
+wavelengths = [310.0, 311.0, 411.0, 511.0, 611.0, 612.0]
+intensities = [0.00, 0.047, 0.0043, 0.6, 0.06, 0.00]
+extinction_coefficient = 18000                           # M^-1 cm^-1
+quantum_yield = 0.000005                                 # switching events per photons absorbed 
+
+[fluorophores.PAmCherry.transitions.bright_to_triplet]
+from_state = "bright"
+to_state = "triplet"
+photon_dependent = false
+base_rate = 1            # 1/s
+
+[fluorophores.PAmCherry.transitions.triplet_to_dark]
+from_state = "triplet"
+to_state = "dark"
+photon_dependent = false
+base_rate = 1            # 1/s
+
+
+# EGFP name
+[fluorophores.EGFP]
+name = "EGFP"
+initial_state = "bright" # flurophore will start with this state in the simulation (all of them), must be valid name from ones provided below.
+
+# States definition
+[fluorophores.EGFP.states.bright]
+name = "bright"
+state_type = "fluorescent"          # any of fluorescent, dark, bleached
+quantum_yield = 0.6                 # from 0-1
+extinction_coefficient = 55900      # M^-1 cm^-1
+fluorescent_lifetime = 0.0000000026 # seconds
+# Spectral data for bright state
+[fluorophores.EGFP.states.bright.excitation_spectrum]
+wavelengths = [300.0, 337.0, 488.0, 501.0, 522.0, 540.0]
+intensities = [0.1, 0.03, 1.00, 0.69, 0.03, 0.00]
+[fluorophores.EGFP.states.bright.emission_spectrum]
+wavelengths = [463.0, 494.0, 503.0, 510.0, 528.0, 549.0, 700.0]
+intensities = [0.00, 0.33, 0.82, 1.00, 0.51, 0.30, 0.00]
+
+
+[fluorophores.EGFP.states.triplet]
+name = "triplet"
+state_type = "dark"
+
+[fluorophores.EGFP.states.bleached]
+name = "bleached"
+state_type = "bleached"
+
+# State transitions
+[fluorophores.EGFP.transitions.bright_to_bleached]
+from_state = "bright"
+to_state = "bleached"
+photon_dependent = true
+[fluorophores.EGFP.transitions.bright_to_bleached.spectrum]
+wavelengths = [300.0, 337.0, 488.0, 501.0, 522.0, 540.0]
+intensities = [0.1, 0.03, 1.00, 0.69, 0.03, 0.00]
+extinction_coefficient = 55900                           # M^-1 cm^-1
+quantum_yield = 0.0000025                                # switching events per photons absorbed 
+
+[fluorophores.EGFP.transitions.bright_to_triplet]
+from_state = "bright"
+to_state = "triplet"
+photon_dependent = true
+[fluorophores.EGFP.transitions.bright_to_triplet.spectrum]
+wavelengths = [300.0, 337.0, 488.0, 501.0, 522.0, 540.0]
+intensities = [0.1, 0.03, 1.00, 0.69, 0.03, 0.00]
+extinction_coefficient = 55900                           # M^-1 cm^-1
+quantum_yield = 0.0000025                                # switching events per photons absorbed 
+
+[fluorophores.EGFP.transitions.triplet_to_bleached]
+from_state = "triplet"
+to_state = "bleached"
+photon_dependent = false
+base_rate = 1            # 1/s
+
+
+# PSF Configuration
+
+[psf]
+# PSF type: "gaussian"
+type = "gaussian"
+
+# If type is "custom", specify the path to the PSF file # not supported currently
+custom_path = ""
+
+[psf.parameters]
+numerical_aperture = 1.4 # typical range: 0.1 - 1.5
+refractive_index = 1.0   # default is air (1.0)
+#pinhole_diameter = 1.0  # Do not include for no pinhole else float in um units
+
+# Multiple Laser Configuration File
+
+[lasers]
+active = ["red", "blue"] # List of active lasers provided in setup
+
+[lasers.red]
+type = "widefield" # "gaussian" or "hilo" or "widefield"
+preset = "red_633" # description
+
+[lasers.red.parameters]
+power = 50000            # Power in watts 
+wavelength = 600         # Wavelength in nanometers
+beam_width = 5.0         # 1/e² beam width at waist in microns
+numerical_aperture = 1.4 # NA of focusing lens
+refractive_index = 1.518
+inclination_angle = 67.0 # degrees, only for HiLo
+
+[lasers.blue]
+type = "widefield"
+preset = "blue_405"
+
+[lasers.blue.parameters]
+power = 5
+wavelength = 405
+beam_width = 5.0
+numerical_aperture = 1.4
+refractive_index = 1.518
+
+
+[channels]
+num_of_channels = 2
+channel_names = ["red", "green"]
+split_efficiency = [
+	1.0,
+	1.0,
+] # 1.0 is 100% efficiency. Physically represents the efficiency of the channel splitter for each channel. max: 1.0 = equal to the original emission light.
+# Filter Set Configuration
+[channels.filters]
+[channels.filters.red] # .red , .green etc, must be of channel_name.
+filter_set_name = "Red Filter Set"
+filter_set_description = "Sample Red filter set configuration"
+
+[channels.filters.red.excitation]
+name = "Red-Ex"
+type = "allow_all"
+points = 100
+
+[channels.filters.red.emission]
+name = "Red-Em"
+type = "bandpass"
+center_wavelength = 600  # nm
+bandwidth = 35           # nm
+transmission_peak = 0.95
+points = 1000
+
+[channels.filters.green]
+filter_set_name = "Green Filter Set"
+filter_set_description = "Sample Green filter set configuration"
+[channels.filters.green.excitation]
+name = "Green-Ex"
+type = "allow_all"
+points = 1000
+[channels.filters.green.emission]
+name = "Green-Em"
+type = "bandpass"
+center_wavelength = 500  # nm
+bandwidth = 35           # nm
+transmission_peak = 0.95
+points = 1000
+
+
+# Camera configurations
+[camera]
+type = "CMOS"
+pixel_count = [190, 190]  # [width, height], 1200x1200 (x pixel_size)
+pixel_detector_size = 6.5 # um
+magnification = 100
+dark_current = 0.0005     # electrons/pixel/second
+readout_noise = 1.6       # electrons RMS
+bit_depth = 16
+sensitivity = 1.0         # electrons/ADU
+base_adu = 100            #ADU
+binning_size = 1          # 1x1 , if 2 then 2x2
+
+# Quantum efficiency curve (wavelength in nm : efficiency 0-1)
+# extrapotation for wavelengths not included uses edge values
+quantum_efficiency = [
+	[
+		399,
+		0.00,
+	],
+	[
+		400,
+		0.80,
+	],
+	[
+		500,
+		0.90,
+	],
+	[
+		600,
+		0.95,
+	],
+	[
+		700,
+		0.90,
+	],
+	[
+		800,
+		0.70,
+	],
+	[
+		900,
+		0.40,
+	],
+	[
+		901,
+		0.00,
+	],
+]
+
+
+[experiment]
+name = "PAmCherry_EGFP_Live_Widefield"
+description = "Sample experiment configuration"
+# experiment_type = "time-series"                 # "time-series" or "z-stack"
+# z_position = 0.0
+# laser_names_active = ["red", "blue"]
+# laser_powers_active = [0.5, 0.05]               #W
+# laser_positions_active = [[5, 5, 0], [5, 5, 0]] # um
+# xyoffset = [0, 0]                               # um
+
+experiment_type = "z-stack"                                             # "time-series" or "z-stack"
+z_position = [-0.5, -0.4, -0.3, -0.2, -0.1, 0, 0.1, 0.2, 0.3, 0.4, 0.5]
+laser_names_active = ["red", "blue"]
+laser_powers_active = [0.5, 0.05]                                       #W
+laser_positions_active = [[5, 5, 0], [5, 5, 0]]                         # um
+xyoffset = [0, 0]                                                       # um
+exposure_time = 100                                                     # ms, needs to be >= than oversample motion time in GlobalParameters
+interval_time = 0                                                       # ms, must be == 0 or if >0 then must be >= oversample motion time in GlobalParameters

AMS_BP/run_sim_util.py

@@ -0,0 +1,76 @@
+import os
+import time
+from contextlib import contextmanager
+from pathlib import Path
+
+import rich
+from rich.progress import Progress, SpinnerColumn, TextColumn
+
+from .configio.convertconfig import load_config, setup_microscope
+from .configio.saving import save_config_frames
+
+
+def run_simulation_from_file(config_file: Path, show_progress: bool = True) -> None:
+    """
+    Core simulation logic used by both CLI and GUI.
+    """
+
+    @contextmanager
+    def progress_context():
+        if show_progress:
+            progress = Progress(
+                SpinnerColumn(),
+                TextColumn("[progress.description]{task.description}"),
+                transient=True,
+            )
+            with progress:
+                yield progress
+        else:
+            # Dummy context for GUI
+            class DummyProgress:
+                def add_task(self, description, total=None):
+                    return None
+
+                def update(self, task, completed):
+                    pass
+
+            yield DummyProgress()
+
+    with progress_context() as progress:
+        start_task_1 = time.time()
+        task_1 = progress.add_task(
+            description="Processing request to run the simulation ...", total=10
+        )
+
+        if not os.path.isfile(config_file):
+            raise FileNotFoundError("Configuration file not found.")
+
+        loadedconfig = load_config(config_file)
+
+        if "version" in loadedconfig:
+            version = loadedconfig["version"]
+            rich.print(f"Using config version: [bold]{version}[/bold]")
+
+        setup_config = setup_microscope(loadedconfig)
+        microscope = setup_config["microscope"]
+        configEXP = setup_config["experiment_config"]
+        functionEXP = setup_config["experiment_func"]
+
+        progress.update(task_1, completed=10)
+        rich.print(
+            "Prep work done in {:.2f} seconds.".format(time.time() - start_task_1)
+        )
+
+        time_task_2 = time.time()
+        task_2 = progress.add_task(description="Running the simulation ...", total=None)
+
+        frames, metadata = functionEXP(microscope=microscope, config=configEXP)
+
+        save_config_frames(
+            metadata, frames, setup_config["base_config"].OutputParameter
+        )
+
+        progress.update(task_2, completed=None)
+        rich.print(
+            "Simulation completed in {:.2f} seconds.".format(time.time() - time_task_2)
+        )

AMS_BP/sim_microscopy.py

@@ -132,8 +132,8 @@ class VirtualMicroscope:
             self._set_laser_positions(laser_positions=laser_position)
 
         duration_total, exposure_time, interval_time = timeValidator(
-            self.config.GlobalParameters.exposure_time,
-            self.config.GlobalParameters.interval_time,
+            self.config.GlobalParameter.exposure_time,
+            self.config.GlobalParameter.interval_time,
             self.sample_plane.dt,
             self.sample_plane.t_end,
             self._time,

{ams_bp-0.3.0.dist-info → ams_bp-0.4.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: AMS_BP
-Version: 0.3.0
+Version: 0.4.0
 Summary: Advanced Microscopy Simulations developed for the Weber Lab by Baljyot Singh Parmar
 Project-URL: Documentation, https://joemans3.github.io/AMS_BP/
 Project-URL: Source code, https://github.com/joemans3/AMS_BP
@@ -11,12 +11,16 @@ Keywords: SMS
 Requires-Python: >=3.12
 Requires-Dist: boundedfbm>=0.4.0
 Requires-Dist: jsonschema>=4.23.0
+Requires-Dist: napari[all]>=0.5.6
 Requires-Dist: numpy>=1.21.2
 Requires-Dist: pydantic>=2.9.2
+Requires-Dist: pyqt6>=6.9.0
 Requires-Dist: pyvista>=0.44.2
 Requires-Dist: scikit-image>=0.18.3
 Requires-Dist: scipy>=1.7.1
+Requires-Dist: tifffile>=2024.12.12
 Requires-Dist: tomli>=2.0.2
+Requires-Dist: tomlkit>=0.13.2
 Requires-Dist: typer>=0.12.5
 Description-Content-Type: text/markdown
 
@@ -29,11 +33,28 @@ Description-Content-Type: text/markdown
 
 AMS-BP is a powerful simulation tool for advanced fluorescence microscopy experiments. This guide covers both command-line usage and library integration.
 
-> **_NOTE:_** Please note that this application DOES NOT currently model the process of stimulated emission, and as such is not suitable for simulating stimulated emission microscopy ([STED](https://en.wikipedia.org/wiki/STED_microscopy))-type experiments. Work in this area is ongoing.
+## Overview of Simulation Workflow
+<img align = "left" src="./docs/assets/figures/Fig1_Schema.svg" width="500"/>
+
+*A ground truth is created, **a**, with $`f_{n}`$ fluorophore types of $`N_{f_{n}}`$ molecules each. If applicable, the motion of these molecules is modelled using a 3D bounded FBM with fluctuating generalized diffusion coefficients and Hurst parameters. Variations are modelled as a Markov Chain and require rate constants as parameters. Different fluorophores can have different motion models. The resolution of the motion models is $`\Delta t`$ and cannot be smaller than 1 ms (for computational efficiency). Given the microscope parameters specific to the experimental procedure to simulate, at every time $`t_{j}`$, the excitation intensity for each channel (**b**) is calculated at each fluorophore's location, **c**. For $`t_{j} \rightarrow t_{j+\Delta t}`$, the photophysical state trajectory of the fluorophore is simulated using the light intensity at the molecule's location as input for any light-dependent transition rates, **d**. For the duration that the shutter is open and light is emitted from the sample, emission filters for each channel are applied before the convolution with PSF models, **e**. The incident photons on the detector are then converted to photoelectrons and finally to digital units using the detector models provided, **f**.*
+
+## API Reference and Docs
+Find detailed API references for the library at: [joemans3/github.io/AMS_BP](https://joemans3.github.io/AMS_BP/)
+> A more detailed example is provided in the jupyter notebook in the examples. For starters refer to the [VisualizingIndividualModules](examples/VisualizingIndividualModules/modules_explained.ipynb). Then head over to the [laser modulation module](examples/VisualizingIndividualModules/laser_modulation.ipynb) which will show how to change the laser power over time in the simulations. Then view an example of a complex experiment setup for [FRAP](examples/QuantitativeExperiments/FRAP/FRAP_methods.ipynb) which is possible by the use of compositions of modules in this simulation library.
+
+## Examples (Click on the image buttons to be taken to the Jupyter notebooks):
+
+> !!ATTENTION!! - Please note that you NEED to install the developmental dependencies to run the examples in full. This is mainly for installing the Jupyter notebook extensions, matplotlib and other visualization packages.
 
+[<img src="./docs/assets/buttons/ButtonFigure_FRAP.svg" width="300" height="120"/>](./examples/QuantitativeExperiments/FRAP/FRAP_methods.ipynb) [<img src="./docs/assets/buttons/ButtonFigure_fPALM_NPC.svg" width="300"/>](./examples/QuantitativeExperiments/FRAP/FRAP_methods.ipynb)
+
+[<img src="./docs/assets/buttons/ButtonFigure_zstack_twocolor_widefield.svg" width="300"/>](./examples/QuantitativeExperiments/TwoColor/Widefield/widefield_twocolor.ipynb) [<img src="./docs/assets/buttons/ButtonFigure_zstack_twocolor_confocal.svg" width="300"/>](./examples/QuantitativeExperiments/TwoColor/Confocal/confocal_twocolor.ipynb)
+
+[<img align="middle" src="./docs/assets/buttons/ButtonFigure_sptPALM_mmaple.svg" width="300"/>](./examples/QuantitativeExperiments/PALM/sptPALM/motionmodels_sptmmaple.ipynb)
 ## Table of Contents
 - [Installation](#installation)
 - [Command Line Interface](#command-line-interface)
+- [GUI](#gui)
 - [Configuration File](#configuration-file)
 - [Running Experiments](#running-experiments)
 - [Advanced Usage](#advanced-usage)
@@ -74,6 +95,9 @@ run_AMS_BP config [OPTIONS]
 
 # Run a simulation using a configuration file
 run_AMS_BP runsim CONFIG_FILE
+
+#start the GUI
+run_AMS_BP gui
 ```
 
 ### Config Command Options
@@ -81,13 +105,40 @@ run_AMS_BP runsim CONFIG_FILE
 - `-o, --output_path PATH`: Specify the output directory for the configuration file
 - `-r, --recursive_o`: Create output directory if it doesn't exist
 
-## Overview of Simulation Workflow
-![Overview Schematic](./docs/assets/figures/Fig1_Schema.svg)
-*A ground truth is created, **a**, with $`f_{n}`$ fluorophore types of $`N_{f_{n}}`$ molecules each. If applicable, the motion of these molecules is modelled using a 3D bounded FBM with fluctuating generalized diffusion coefficients and Hurst parameters. Variations are modelled as a Markov Chain and require rate constants as parameters. Different fluorophores can have different motion models. The resolution of the motion models is $`\Delta t`$ and cannot be smaller than 1 ms (for computational efficiency). Given the microscope parameters specific to the experimental procedure to simulate, at every time $`t_{j}`$, the excitation intensity for each channel (**b**) is calculated at each fluorophore's location, **c**. For $`t_{j} \rightarrow t_{j+\Delta t}`$, the photophysical state trajectory of the fluorophore is simulated using the light intensity at the molecule's location as input for any light-dependent transition rates, **d**. For the duration that the shutter is open and light is emitted from the sample, emission filters for each channel are applied before the convolution with PSF models, **e**. The incident photons on the detector are then converted to photoelectrons and finally to digital units using the detector models provided, **f**.*
+## GUI
+In addition to the CLI and programmatic API, AMS-BP comes with a graphical interface to guide users through the configuration, simulation, and analysis pipeline.
 
+### Main GUI Features
+The GUI provides the following tools from a single interface:
 
+**Create Configuration File** — Launches the visual configuration builder
+**Run Simulation from Config** — Select a .toml file and run the simulation with logging and progress tracking
+**Visualize Microscopy Data (Napari)** — Open TIFF, PNG, ND2, or Zarr image files and view with the Napari viewer
+**Package Logs for Sharing** — Package run directories (e.g., run_2024_04_20_001) into a .zip file for archival or collaboration
 
+### Launch the GUI
+To start the GUI, run:
+
+```bash
+
+run_AMS_BP gui
+```
+#### Configuration Builder
+Clicking "Create Configuration File" opens a template selector where you can choose a preconfigured simulation (with preview images), and then visually edit all configuration options through dedicated tabs.
 
+Each section of the configuration is editable via structured UI forms, with contextual help and validation. Tabs include:
+
+- Global/Cell/Molecule/Condensate/Fluorophore parameters
+- Laser and optical configuration
+- Camera and channel settings
+- Experiment setup (e.g., z-stack vs time-series)
+Once ready, click "Preview Configuration TOML" to inspect the final file, and "Save" to export.
+
+#### Running Simulations from GUI
+Clicking "Run Simulation from Config" lets you select any .toml configuration file. A real-time log viewer shows progress, and outputs are saved in a structured AMS_runs/run_*/ directory.
+
+#### Sharing Logs
+Run into an issue? Use the packge logs button to select the logs corresponding to the simulation you just ran, save them and send them over to us! It will help you diagnose the issue!
 
 ## Configuration File
 
@@ -166,35 +217,6 @@ run_AMS_BP config
 run_AMS_BP runsim sim_config.toml
 ```
 4. View the results in the newly created folder, whose name is defined in the config file.
-## Advanced Usage
-
-### Using AMS-BP as a Library
-
-For programmatic control, you can import and use AMS-BP as a Python library:
-
-```python
-from AMS_BP.configio.convertconfig import ConfigLoader
-
-# Configuration loader intialization
-config_loader = ConfigLoader(config_path="path/to/config.toml")
-
-# Setup microscope
-setup_config = config_loader.setup_microscope()
-microscope = setup_config["microscope"]
-config_exp = setup_config["experiment_config"]
-function_exp = setup_config["experiment_func"]
-
-# Run simulation
-frames, metadata = function_exp(microscope=microscope, config=config_exp)
-
-# Save results
-from AMS_BP.configio.saving import save_config_frames
-save_config_frames(metadata, frames, setup_config["base_config"].OutputParameters)
-```
-
-## API Reference and Docs
-Find detailed API references for the library at: [joemans3/github.io/AMS_BP](https://joemans3.github.io/AMS_BP/)
-> A more detailed example is provided in the jupyter notebook in the examples. For starters refer to the [VisualizingIndividualModules](examples/VisualizingIndividualModules/modules_explained.ipynb). Then head over to the [laser modulation module](examples/VisualizingIndividualModules/laser_modulation.ipynb) which will show how to change the laser power over time in the simulations. Then view an example of a complex experiment setup for [FRAP](examples/QuantitativeExperiments/FRAP_methods.ipynb) which is possible by the use of compositions of modules in this simulation library.
 
 ## High Priority Features
 ~~1. Irregular cell shapes with motion models~~ (supported with release of v0.2.0)
@@ -202,3 +224,6 @@ Find detailed API references for the library at: [joemans3/github.io/AMS_BP](htt
 3. STORM workflow examples
 4. CTRW motion models
 5. Simpler configurations
+> **_NOTE:_** Please note that this application DOES NOT currently model the process of stimulated emission, and as such is not suitable for simulating stimulated emission microscopy ([STED](https://en.wikipedia.org/wiki/STED_microscopy))-type experiments. Work in this area is ongoing.
+
+