This article provides a comprehensive guide on managing versions of gene panels in Franklin.
Getting Started with Panel Creation
Before leveraging the Panel Versioning feature, ensure that you have created a gene panel. For guidance on this initial step, refer to our dedicated article. Each new panel is automatically assigned a starting version number: 1.
Updating Gene Panel Content
To modify the gene content of a panel, whether it's adding or removing genes, follow these steps:
Navigate to the requested panel page in the Knowledge Base.
Click 'Edit' and modify the gene list by:
Manually add or remove genes
Upload a new list of genes
Clear the entire existing gene list
Once your changes are complete, click 'Save'. This action will create a new version of the panel.
A pop-up window may appear, offering an optional opportunity to add a comment about the new version. This can be helpful for tracking changes over time.
Editing an existing panel gene content
Viewing Version History
All versions of a panel are accessible under the 'Version History' tab. This section displays a list of all versions. To view the gene content of any previous version, click on 'Export Gene List' beside the relevant version.
Version History tab
Case Analysis and Panel Versions
Cases analyzed with a specific panel version retain that version, irrespective of subsequent updates to the panel. Updating a panel to a newer version does not retroactively affect cases analyzed with older versions.
To determine which version of a panel was used in a case:
Open the panels popup within the case.
The panel version is listed beneath the panel name.
If a case is not using the latest panel version, a yellow highlight icon will appear, offering an option to update to the latest version.
New cases will always use the latest version of the panel.
Example of a case using an old version of the panel
The Panel Versioning feature is designed to streamline the process of tracking and managing gene panel modifications. It ensures that updates to gene panels do not impact previously analyzed cases, providing both flexibility and consistency in your genetic analysis.