Feature summary
Add a user guide explaining how to use the Western Blot loading calculator, including input fields, calculation outputs, lane layout, validation warnings, and example workflows.
Related module
Western Blot tools
Problem or workflow need
Western Blot loading calculations involve protein amount, sample concentration, final loading volume, loading buffer, reducing agent, diluent volume, and lane layout. Users need clear documentation to understand what each field means and how to review the calculated result before use.
Proposed solution
Add a documentation page under docs/ that explains the Western Blot loading calculator.
The guide should include:
- Purpose of the calculator
- Required inputs
- Output interpretation
- 4X and 5X loading buffer logic
- Reducing agent options
- Marker lane behavior
- Fixed lane count behavior
- Low-volume warning logic
- Example calculations
- Human review and non-clinical-use reminder
Formula or calculation logic
Loading buffer volume:
For 4X loading buffer:
buffer volume = final loading volume / 4
For 5X loading buffer:
buffer volume = final loading volume / 5
Protein sample volume:
sample volume = target protein amount / sample protein concentration
Diluent volume:
diluent volume = final loading volume - sample volume - loading buffer volume - reducing agent volume
If diluent volume is negative, the input combination is invalid.
Expected inputs and outputs
Inputs:
- Target protein amount
- Sample concentration
- Final loading volume
- Loading buffer concentration
- Reducing agent mode
- Diluent name
- Marker settings
- Lane count
Outputs:
- Sample volume
- Loading buffer volume
- Reducing agent volume
- Diluent volume
- Lane layout
- Warning or error messages
Example use case
A user wants to load 20 ug protein per lane from samples with different concentrations, using a 4X loading buffer and 20 uL final loading volume.
The guide should explain how the calculator determines sample volume, buffer volume, diluent volume, and whether any samples trigger warnings.
References or notes
This issue is documentation-focused. It does not require implementing new calculator logic. Screenshots can be added later after the UI is available in the open-source repository.
Scope check
Feature summary
Add a user guide explaining how to use the Western Blot loading calculator, including input fields, calculation outputs, lane layout, validation warnings, and example workflows.
Related module
Western Blot tools
Problem or workflow need
Western Blot loading calculations involve protein amount, sample concentration, final loading volume, loading buffer, reducing agent, diluent volume, and lane layout. Users need clear documentation to understand what each field means and how to review the calculated result before use.
Proposed solution
Add a documentation page under docs/ that explains the Western Blot loading calculator.
The guide should include:
Formula or calculation logic
Loading buffer volume:
For 4X loading buffer:
buffer volume = final loading volume / 4
For 5X loading buffer:
buffer volume = final loading volume / 5
Protein sample volume:
sample volume = target protein amount / sample protein concentration
Diluent volume:
diluent volume = final loading volume - sample volume - loading buffer volume - reducing agent volume
If diluent volume is negative, the input combination is invalid.
Expected inputs and outputs
Inputs:
Outputs:
Example use case
A user wants to load 20 ug protein per lane from samples with different concentrations, using a 4X loading buffer and 20 uL final loading volume.
The guide should explain how the calculator determines sample volume, buffer volume, diluent volume, and whether any samples trigger warnings.
References or notes
This issue is documentation-focused. It does not require implementing new calculator logic. Screenshots can be added later after the UI is available in the open-source repository.
Scope check