Skip to content

Conversation

@d-v-b
Copy link

@d-v-b d-v-b commented Oct 9, 2025

Continues #22 by adding docs using mkdocs-material
Also updates docstrings to numpy style.
Adds a github action to deploy the docs to github pages.

Copy link
Member

@dimitri-yatsenko dimitri-yatsenko left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The explanation of the conversion_gain is not quite correct. I’ve added comments.

# 2. Estimate parameters
params = compute_sensitivity(movie)
print(f"Estimated parameters:")
print(f" Conversion gain: {params['sensitivity']:.3f} ADU/photon")
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

units / photon

params = compute_sensitivity(movie)
print(f"Estimated parameters:")
print(f" Conversion gain: {params['sensitivity']:.3f} ADU/photon")
print(f" Zero level: {params['zero_level']:.1f} ADU")
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

units


```python
# If you know electrons per ADU:
electrons_per_adu = 2.5 # From camera spec sheet
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
electrons_per_adu = 2.5 # From camera spec sheet
photons_per_unit = 2.5 # From camera spec sheet

```python
# If you know electrons per ADU:
electrons_per_adu = 2.5 # From camera spec sheet
quantum_efficiency = 0.9 # Photons to electrons conversion
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

quantum efficiency is not photons to electron conversion. This is a highly technical issue and we should just refer to the appropriate literature, like our Nature Protocols paper for example.

electrons_per_adu = 2.5 # From camera spec sheet
quantum_efficiency = 0.9 # Photons to electrons conversion

conversion_gain = electrons_per_adu / quantum_efficiency
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

conversion_gain does not relate to electrons. It describes the increase in the measured signal (in digital units) per detected photon. This does not depend on quantum efficiency.

@d-v-b d-v-b mentioned this pull request Oct 9, 2025
@dimitri-yatsenko dimitri-yatsenko merged commit 5cf966a into datajoint:main Oct 9, 2025
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants