Protocol
MinKNOW V MKE_1013_v1_revDH_18Dec2024
Instructions for working with MinKNOW. If using for the first time, please refer to the user manual for your device. For Research Use Only
FOR RESEARCH USE ONLY
Contents
Quick start guides
- 1. Quick start guides introduction
- 2. MinION Mk1B and MinION Mk1D quick start guide
- 3. MinION Mk1C quick start guide
- 4. GridION quick start guide
- 5. PromethION 24/48 quick start guide
- 6. PromethION 2 Solo quick start guide
Computer requirements for MinKNOW
Downloading and installing MinKNOW
Updating or re-installing MinKNOW
Connecting to device
The Graphical User Interface (GUI)
- 16. Homepage
- 17. Hardware check
- 18. Flow cell check
- 19. Experiments page
- 20. Sample sheet upload
- 21. Save and load sequencing run settings
- 22. Application settings
Host settings
- 23. Overview
- 24. Shutting down
- 25. Rebooting
- 26. System package updates
- 27. Data management
- 28. Mount Network Drive
- 29. Tutorials
- 30. Configuración y conexión a la red
- 31. Beta features
- 32. Resolución de problemas
Starting a sequencing run
- 33. Introduction to local basecalling
- 34. Starting a sequencing run with Flongle
- 35. Starting a sequencing run on MinION Mk1B/Mk1D
- 36. Starting a sequencing run on MinION Mk1C
- 37. Starting a sequencing run on GridION
- 38. Starting a sequencing run on PromethION 24 and 48
- 39. Starting a sequencing run on PromethION 2 Solo
- 40. Starting a sequencing run on PromethION P2i
Monitoring and troubleshooting your sequencing run
- 41. Refuelling your flow cell
- 42. Checks and monitoring
- 43. Troubleshooting your run from the pore activity plots
Completing a MinKNOW run
- 44. Completion of a sequencing protocol script
- 45. Run report
- 46. Closing MinKNOW and shutting down a MinION Mk1B/Mk1D
- 47. Cerrar MinKNOW y apagar el GridION
- 48. Closing MinKNOW and shutting down on PromethION
Post-run analysis
Descripción general
Instructions for working with MinKNOW. If using for the first time, please refer to the user manual for your device. For Research Use Only
1. Quick start guides introduction
Introduction
MinKNOW controls all Oxford Nanopore sequencing devices, performing several core tasks, including data acquisition, real-time analysis, basecalling, and data streaming.
In this section, we will outline how to set up your device for the first time for sequencing using our MinKNOW software.
2. MinION Mk1B and MinION Mk1D quick start guide
The MinION Mk1B and MinION Mk1D
The MinION Mk1B and MinION Mk1D are pocket-sized, portable devices for biological analysis of DNA or RNA samples. The MinION Mk1D is the successor to MInION Mk1B, with improved thermal dissipation capabilities significantly enhancing sequencing performance, enabling highly accurate real-time sequencing in an even wider range of environments than MinION Mk1B. Both devices can be used with MinION Flow Cells, as well as the Flongle Adapter and flow cells. The device is plugged into a computer and is operated by MinKNOW, which controls the device and flow cells, collects the sequencing data, and performs basecalling.
Below is a quick start guide to set up a new device for sequencing library samples. For further details on using these devices, please refer to the MinION Mk1B user manual or MinION Mk1D user manual.
Download and install the MinKNOW software.
Download the MinKNOW Software for the MinION Mk1B/D and the PromethION 2 Solo (P2 Solo) Devices from the Software Downloads page and extract the .zip files. Follow the installation prompts to install the software.
The MinKNOW App is also available to download for iOS and Android devices to enable you to monitor experiment progress remotely.
Set up your MinION Mk1B/Mk1D with a host computer.
Connect your device to the host computer via the USB cable provided, as instructed in the user manual. Please refer to MinION Mk1B Computer requirements or MinION Mk1D Computer requirements for further information.
Log into MinKNOW.
Double-click on the MinKNOW icon on your desktop.
Click on Log in with your Nanopore account.
Enter your email address and Nanopore password.
The Connection Manager will open, and your device will be the card in the top left corner.
Click on the My device card to access and control it.
Tutorials
These are available to help you get started and run your experiments as easily as possible.
When you open the MinKNOW software for the first time, the tutorials will navigate you through the graphical user interface (GUI). Click Continue tutorial to follow or click the ⁞ to skip.
Perform a hardware check.
A hardware check must be completed on your new device or after software has been updated.
Open the MinION Mk1B/Mk1D and slide your Configuration Test Cell (CTC) under the clip. Gently press down onto the CTC until it clicks into place. To check a Flongle Adapter, insert an empty adapter instead of a CTC.
Close the device lid.
Navigate to the Start tab and click Hardware check.
Click Start. The hardware check will complete after approximately 1 minute.
After the hardware check has finished, remove the CTC and store in dry conditions.
Perform a flow cell check.
A flow cell check must be carried out prior to starting a sequencing experiment to assess the number of active pores available in your flow cell. For further information about flow cell warranty is available in the Flow cell check section.
Open the device and slide your flow cell under the clip. Firmly press down on the flow cell. For Flongle, slide the Flongle Adapter under the clip and insert a Flongle Flow Cell.
Navigate to the Start page and click Flow Cell Check.
MinKNOW will recognise the MinION Flow Cell type and IDs. Note: For Flongle, fill in the flow cell ID manually.
Click Start and the flow cell check will begin.
Set up a sequencing run.
Prime and load your flow cell with DNA or RNA library by following a library prep protocol and set up a sequencing run, as follows:
Navigate to the Start page and click Start Sequencing.
In the Positions tab, fill in the experiment name, sample ID, and select the flow cell type. Click Continue to kit selection. Note: For Flongle, fill in the flow cell ID manually.
Select the kit and any expansion(s) used to prepare the library. Click Continue to run options.
Specify the sequencing run length and minimum read length or keep the default settings. Click Continue to analysis.
Choose your basecaller model and select any available barcoding and alignment options or keep the default settings. Click Continue to output.
Specify your output data location, format and filtering options or keep the default settings. Click Continue to final review.
Click Start.
For further details, please see the Starting a sequencing run section for your device in the MinKNOW protocol.
3. MinION Mk1C quick start guide
The MinION Mk1C
This device combines the real-time, rapid, portable sequencing of a MinION Mk1B/Mk1D with a Graphical Processing Unit (GPU) and a high-resolution screen. It can be used with MinION Flow Cells, as well as the Flongle Adapter and flow cells. The device is operated by the MinKNOW software that controls the device, experimental scripts, and performs basecalling.
Below is a quick start guide to set up a new device and to start sequencing your library samples. For further details using this device, please see the MinION Mk1C User Manual.
Set up the MinION Mk1C device.
Connect the AC/DC adapter to a power source and connect the MinION Mk1C.
Switch the power source on and press the power button on the device.
For the first time, users will be taken through the onboarding process to set up the device. Through this process, you will:
- Connect your device to the internet (Ethernet recommended)
- Log into your MinKNOW account using your Community credentials
- Configure local network access to your device
- Perform a hardware check
Check the time and date of your device.
Verify the time and data of your device is correct to successfully establish a network connection.
Navigate to Device settings in the host settings.
Check the time and date.
Click Change data and time and set the time using custom date/time.
Reset the default password.
The device is shipped with a default password minit
that must be reset.
Navigate to Device settings in the host settings.
Click Reset password to open the Change password dialogue box.
Enter the current password, followed by the new password.
Click Reset password to confirm the password change.
Tutorials
These are available to help you get started and run your experiments as easily as possible.
When you open the MinKNOW software for the first time, the tutorials will navigate you through the graphical user interface (GUI). Click Continue tutorial to follow or click the ⁞ to skip.
Perform a hardware check.
A hardware check must be performed on new devices or when software has been updated.
Open the MinION Mk1C and slide the CTC under the clip. Gently press down onto the CTC until it clicks into place. To check a Flongle Adapter, insert an empty adapter instead of a CTC.
Close the device lid.
Navigate to the Start page and click Hardware check.
Click Start. The hardware check will complete after approximately 1 minute.
After the hardware check has finished, remove the CTC and store in dry conditions.
Perform a flow cell check.
A flow cell check must be carried out prior to starting a sequencing experiment to assess the number of active pores available in your flow cell. For further information about flow cell warranty is available in the Flow cell check section.
Open the device and slide your flow cell under the clip. Firmly press down on the flow cell. For Flongle, slide the Flongle Adapter under the clip and insert a Flongle Flow Cell.
Navigate to the Start page and click Flow Cell Check.
MinKNOW will recognise the MinION Flow Cell type and IDs. Note: For Flongle, fill in the flow cell ID manually.
Click Start and the flow cell check will begin.
Set up a sequencing run.
Prime and load your flow cell with DNA or RNA library by following a library prep protocol and set up a sequencing run, as follows:
Navigate to the Start page and click Start Sequencing.
In the Positions tab, fill in the experiment name, sample ID, and select the flow cell type. Click Continue to kit selection. Note: For Flongle, fill in the flow cell ID manually.
Select the kit and any expansion(s) used to prepare the library. Click Continue to run options.
Specify the sequencing run length and minimum read length or keep the default settings. Click Continue to analysis.
Choose your basecaller model and select any available barcoding and alignment options or keep the default settings. Click Continue to output.
Specify your output data location, format and filtering options or keep the default settings. Click Continue to final review.
Click Start.
For further details, please see the Starting a sequencing run section for your device in the MinKNOW protocol.
4. GridION quick start guide
The GridION
This is a compact benchtop system offering on-demand sequencing with integrated real-time data processing. Up to five MinION or Flongle Flow Cells can be run individually or concurrently, offering a cost-effective access to long-read, real-time nanopore sequencing. The device is operated by the MinKNOW software, which controls the device, experimental scripts, and performs basecalling.
Below is a quick start guide to set up a new device and to start sequencing your library samples. For further details using this device, please see the GridION User Manual.
Install the GridION device.
Unpack the device in an appropriate laboratory location and attach all the required cables to the device, including the:
- Ethernet
- HDMI or DisplayPort to monitor
- USB for a keyboard
- USB for a mouse
- C13 cable
Ensure the device is connected to a protective earth mains supply and turn the power source on and press the power button on the device. A blue light will appear in the middle of the button.
Log into MinKNOW.
Double-click on the MinKNOW icon on your desktop.
Click on Log in with your Nanopore account.
Enter your email address and Nanopore password.
The Connection Manager will open, and your device will be the card in the top left corner.
Click on the My device card to access and control it.
Tutorials
These are available to help you get started and run your experiments as easily as possible.
When you open the MinKNOW software for the first time, the tutorials will navigate you through the graphical user interface (GUI). Click Continue tutorial to follow or click the ⁞ to skip.
Configure your GridION.
To connect your GridION to a single network, use the user interface. A device can be connected to multiple networks which will require a script to be used. For more information, please see the GridION User Manual.
Validate your IP address to ensure it has been correctly set using a static or DHCP address using the command ifconfig
.
Check the time and date of your device.
Verify the time and data of your device is correct to successfully establish a network connection.
Navigate to Device settings in the host settings.
Check the time and date.
Click Change data and time and set the time using custom date/time.
Reset the default password.
The device is shipped with a default password grid
that must be reset.
Navigate to Device settings in the host settings.
Click Reset password to open the Change password dialogue box.
Enter the current password, followed by the new password.
Click Reset password to confirm the password change.
Perform a hardware check.
A hardware check must be perfomed on new devices or after software has been updated.
Open the GridION and slide a CTC under the clip for each position. Gently press down onto the CTC until it clicks into place. To check a Flongle Adapter, insert an empty adapter instead of a CTC.
The LEDs above the flow cell position will be blue when initialising and will turn green when they are ready.
Close the device lid.
Navigate to the Start page and click Hardware check.
Click Select all available positions.
Click Start. The hardware check will complete after approximately 1 minute.
After the hardware check has finished, remove the CTCs and store in dry conditions.
Perform a flow cell check.
A flow cell check must be carried out prior to starting a sequencing experiment to assess the number of active pores available in your flow cell. For further information about flow cell warranty is available in the Flow cell check section.
Open the device and slide your flow cell under the clip. Firmly press down on the flow cell. For Flongle, slide the Flongle Adapter under the clip and insert a Flongle Flow Cell.
Navigate to the Start page and click Flow Cell Check.
MinKNOW will recognise the MinION Flow Cell type and IDs. Note: For Flongle, fill in the flow cell ID manually.
Click Start and the flow cell check will begin.
Set up a sequencing run.
Prime and load your flow cell with DNA or RNA library by following a library prep protocol and set up a sequencing run, as follows:
Navigate to the Start page and click Start Sequencing.
In the Positions tab, fill in the experiment name, sample ID, and select the flow cell type. Click Continue to kit selection. Note: For Flongle, fill in the flow cell ID manually.
Select the kit and any expansion(s) used to prepare the library. Click Continue to run options.
Specify the sequencing run length and minimum read length or keep the default settings. Click Continue to analysis.
Choose your basecaller model and select any available barcoding and alignment options or keep the default settings. Click Continue to output.
Specify your output data location, format and filtering options or keep the default settings. Click Continue to final review.
Click Start.
For further details, please see the Starting a sequencing run section for your device in the MinKNOW protocol.
5. PromethION 24/48 quick start guide
The PromethION 24 and 48
This is a benchtop device designed to run up to 24 (for P24) or 48 (for P48) flow cells. Each flow cell is independently addressable, meaning that experiments can be run concurrently or individually. The integrated compute in the PromethION enables real-time data streaming and analysis. The device is operated by the MinKNOW software that controls the device, experimental scripts, and performs basecalling.
Below is a quick start guide to set up a new device and to start sequencing your library samples. For further details using this device, please see the PromethION 24/48 User Manual.
Install the PromethION device.
Unpack the device and place the Sequencing Unit and the Data Acquisition Unit within 2 meters of each other.
Connect the following cables:
- Connect either the copper or fibre cables to the data acquisition unit.
- Connect the PCIe and USB cables between the sequencing and data acquisition units
- Connect the peripheral devices (e.g. monitor, mouse, keyboard) to the appropriate ports.
- Connect the two C13 cables to both units.
Turn on the power at the mains supply and turn on the sequencing unit, wait three minutes and turn on the data acquisition unit.
Validate your IP address to ensure it has been correctly set using a static or DHCP address using the command
ifconfig
.
Log into MinKNOW.
Double-click on the MinKNOW icon on your desktop.
Click on Log in with your Nanopore account.
Enter your email address and Nanopore password.
The Connection Manager will open, and your device will be the card in the top left corner.
Click on the My device card to access and control it.
Tutorials
These are available to help you get started and run your experiments as easily as possible.
When you open the MinKNOW software for the first time, the tutorials will navigate you through the graphical user interface (GUI). Click Continue tutorial to follow or click the ⁞ to skip.
Check the time and date of your device.
Verify the time and data of your device is correct to successfully establish a network connection.
Navigate to Device settings in the host settings.
Check the time and date.
Click Change data and time and set the time using custom date/time.
Reset the default password.
The device is shipped with a default password prom
that must be reset.
Navigate to Device settings in the host settings.
Click Reset password to open the Change password dialogue box.
Enter the current password, followed by the new password.
Click Reset password to confirm the password change.
Perform a hardware check.
A hardware check must be performed on new devices or after a software update.
Open the PromethION and insert the CTCs into all positions. The LED adjacent to the flow cell will be blue when initialising and will turn green when it is ready.
Close the device lid.
Navigate to the Start page and click Hardware check.
Click Select all available positions.
Click Start. The hardware check will complete after approximately 1 minute.
After the hardware check has finished, remove the CTCs and store in dry conditions.
Perform a flow cell check.
A flow cell check must be carried out prior to starting a sequencing experiment to assess the number of active pores available in your flow cell. For further information about flow cell warranty is available in the Flow cell check section.
Open the device and insert your flow cell.
Navigate to the Start page and click Flow Cell Check.
MinKNOW will recognise the PromethION Flow Cell type and ID.
Click Start and the flow cell check will begin.
Set up a sequencing run.
Prime and load your flow cell with DNA or RNA library by following a library prep protocol and set-up a sequencing run, as follows:
Navigate to the Start page and click Start Sequencing.
In the Positions tab, fill in the experiment name, sample ID, and select the flow cell type and position(s). Click Continue to kit selection.
Select the kit and any expansion(s) used to prepare the library. Click Continue to run options.
Specify the sequencing run length and minimum read length or keep the default settings. Click Continue to analysis.
Choose your basecaller model and select any available barcoding and alignment options or keep the default settings. Click Continue to output.
Specify your output data location, format and filtering options or keep the default settings. Click Continue to final review.
Click Start.
For further details, please see the Starting a sequencing run section for your device in the MinKNOW protocol.
6. PromethION 2 Solo quick start guide
The PromethION 2 Solo
This is a small benchtop device designed to run up to two flow cells. Each flow cell is independently addressable, meaning that experiments can be run concurrently or individually. The PromethION 2 Solo plugs into a GridION Mk1 or user compute for real-time data streaming and analysis. The device is operated by the MinKNOW software that controls the device, experimental scripts, and performs basecalling.
Below is a quick start guide to set up a new device and to start sequencing your library samples. For further details using this device, please see the PromethION 2 Solo User Manual.
Install the P2 Solo with a GridION.
Place the P2 Solo and GridION on a laboratory bench.
Check the GridION serial number is greater than GXB002xxx on the back of the device.
Download and install the PromethION 2 Solo software from the Software Downloads page on the Community. For Linux, install the software via the Terminal. For more information, see the PromethION 2 Solo User Manual. Note: The MinKNOW App is also available to download for iOS and Android devices to allow you to monitor experiment progress and to control your device remotely.
Connect the P2 Solo AC power adapter into a mains supply and connect it to the P2 Solo.
Connect the USB Type-C cable to the GridION and the P2 Solo.
Turn on the power switch on the GridION and wait 60 seconds.
Install the P2 Solo with a workstation/laptop.
Place the P2 Solo on a laboratory bench.
Download and install the PromethION 2 Solo software from the Software Downloads page on the Community. For Linux, install the software via the Terminal. For more information, see the PromethION 2 Solo User Manual. Note: The MinKNOW App is also available to download for iOS and Android devices to allow you to monitor experiment progress and to control your device remotely.
Connect the P2 Solo AC power adapter into a mains supply and connect it to the P2 Solo.
Connect the USB Type-C cable to the workstation/laptop and the P2 Solo.
Log into MinKNOW.
Double-click on the MinKNOW icon on your desktop.
Click on Log in with your Nanopore account.
Enter your email address and Nanopore password.
The Connection Manager will open, and your device will be the card in the top left corner.
Click on the My device card to access and control it.
Tutorials
These are available to help you get started and run your experiments as easily as possible.
When you open the MinKNOW software for the first time, the tutorials will navigate you through the graphical user interface (GUI). Click Continue tutorial to follow or click the ⁞ to skip.
Configure your GridION.
For your P2 Solo connected to a GridION, the network will need to be configured. To connect your GridION to a single network, use the user interface. A device can be connected to multiple networks which will require a script to be used.
Validate your IP address to ensure it has been correctly set using a static or DHCP address using the command ifconfig
.
Perform a hardware check.
A hardware check must be performed on new devices and after software updates.
Open the P2 Solo and slide the CTC into each position. Note: Ensure you are using the CTCs provided with the P2 Solo device only.
Close the device lid.
Navigate to the Start page and click Hardware check.
Click Select all available positions.
Click Start. The hardware check will complete after approximately 1 minute.
After the hardware check has completed, remove the CTCs and store in dry conditions.
Perform a flow cell check.
A flow cell check must be carried out prior to starting a sequencing experiment to assess the number of active pores available in your flow cell. For further information about flow cell warranty is available in the Flow cell check section.
Open the device and insert your flow cell.
Navigate to the Start page and click Flow Cell Check.
MinKNOW will recognise the PromethION Flow Cell type and ID.
Click Start and the flow cell check will begin.
Set up a sequencing run.
Prime and load your flow cell with DNA or RNA library by following a library prep protocol and set-up a sequencing run, as follows:
Navigate to the Start page and click Start Sequencing.
In the Positions tab, fill in the experiment name, sample ID, and select the flow cell type and position(s). Click Continue to kit selection.
Select the kit and any expansion(s) used to prepare the library. Click Continue to run options.
Specify the sequencing run length and minimum read length or keep the default settings. Click Continue to analysis.
Choose your basecaller model and select any available barcoding and alignment options or keep the default settings. Click Continue to output.
Specify your output data location, format and filtering options or keep the default settings. Click Continue to final review.
Click Start.
For further details, please see the Starting a sequencing run section for your device in the MinKNOW protocol.
7. Computer requirements
Computer specification
Firewall settings needed to run the MinION Mk1B
During runs both MinKNOW and the Desktop Agent require access to the AWS IP ranges currently listed here for the region eu-west-1, and also access to:
178.79.175.200
96.126.99.215
8. Installing MinKNOW on Windows
Download and installation
This part of the configuration will introduce the MinKNOW software and explain how to download and install it. There are three items to take particular note of:
- If anti-virus software stops the installation, contact your IT department
- The MinKNOW downloads as a .zip file and all files need to be extracted before proceeding with installation
- Data generated from the MinKNOW software needs to be stored on the SSD drive, and care should be taken to ensure the data location is set to the SSD during installation
If help is needed during installation, please refer to the Support area in the Community.
Download MinKNOW
- Download MinKNOW software from the Downloads page on the Community
- Follow the on-screen instructions
- Contact the local IT administrators if there are any issues with permissions for installation
Extract the .zip files.
- Check that the Oxford Nanopore wheel icon is next to MinKNOW Stand-alone NC Windows [version number].zip
- Click on MinKNOW Stand-alone NC Windows [version number].zip
Follow the installation prompts.
At the Installation Options screen, click 'Next' to accept default installation options.
In the Choose Data Location dialogue box, check that you are happy with the location of the sequencing reads data to change to the required SSD location and click on Install.
In the Choose Data Location dialogue box, check that the read location is C:\data. If you prefer a different destination, enter the path in the box. Continue the download by clicking on Install.
Progression of installation
A dialogue box will open and shows progression of the installation.
When installation is complete, click on 'Close' to see MinKNOW successfully installed.
Navigate to the MinKNOW icon on the desktop.
FIN DEL PROCESO
The presence of the MinKNOW icon on the desktop indicates that this step has been successfully completed.
MEDIDA OPCIONAL
If you have a proxy server and would like to set up MinKNOW using a proxy, follow the instructions below.
Open the user_conf
file:
C:\ProgramFiles\OxfordNanopore\MinKNOW\conf\user_conf
And edit the following portion of the file:
"proxy": {
"cereal_class_version": 0,
"use_system_settings": true,
"auto_detect": true,
"auto_config_script": "",
"https_proxy": "",
"proxy_bypass": ""
Edit the https_proxy
setting, which should be in the style of:
scheme://[username:password@]host:port or "http://domain\\username:password@host:port", where "scheme" is one of https, socks, socks4 or socks5.
9. Installing MinKNOW on macOS
Download MinKNOW
1. Download MinKNOW software from the Downloads page on the Community. 2. Once MinKNOW has downloaded, navigate to the folder in Applications and launch the MinKNOW.pkg installer.
3. Follow the on-screen instructions.
4. Provide a fingerprint or password as required.
5. Once the installation is complete, exit the installer.
Navigate to the MinKNOW icon in the Applications folder.
FIN DEL PROCESO
The presence of the MinKNOW icon in the Applications folder indicates that this step has been successfully completed.
MEDIDA OPCIONAL
Set the directory where the read files will be saved:
Open a command line and type:
sudo /Applications/MinKNOW.app/Contents/Resources/bin/config_editor --conf user --file /Applications/MinKNOW.app/Contents/Resources/conf/user_conf --set "output_dirs.base=/where the files will be saved"
Add the full path to the location where you would like the read files saved in the place of "where the read files will be saved".
MEDIDA OPCIONAL
If you have a proxy server and would like to set up MinKNOW using a proxy, follow the instructions below.
Open the user_conf
file:
/Applications/MinKNOW.app/Contents/Resources/conf/user_conf
And edit the following portion of the file:
"proxy": {
"cereal_class_version": 0,
"use_system_settings": true,
"auto_detect": true,
"auto_config_script": "",
"https_proxy": "",
"proxy_bypass": ""
Edit the https_proxy
setting, which should be in the style of:
scheme://[username:password@]host:port or "http://domain\\username:password@host:port", where "scheme" is one of https, socks, socks4 or socks5.
10. Installing MinKNOW on Linux
To add the Oxford Nanopore apt repository, run the command below on a terminal window:
For Ubuntu 22:
sudo apt update
sudo apt install wget
wget -O- https://cdn.oxfordnanoportal.com/apt/ont-repo.pub | sudo apt-key add -
echo "deb http://cdn.oxfordnanoportal.com/apt jammy-stable non-free" | sudo tee /etc/apt/sources.list.d/nanoporetech.sources.list
For Ubuntu 20:
sudo apt update
sudo apt install wget
wget -O- https://cdn.oxfordnanoportal.com/apt/ont-repo.pub | sudo apt-key add -
echo "deb http://cdn.oxfordnanoportal.com/apt focal-stable non-free" | sudo tee /etc/apt/sources.list.d/nanoporetech.sources.list
Install MinKNOW using the command:
sudo apt update
sudo apt install ont-standalone-minknow-release
Open the MinKNOW GUI from the applications list.
Default installation directories
For the MinKNOW software: /opt/ont/minknow
For the MinKNOW user interface: /opt/ont/minknow-ui
Location of the reads folder:
The reads folder is in /var/lib/minknow/data
Location of the log files:
The MinKNOW logs are located in /var/log/minknow
The Dorado basecaller logs are located in /var/log/dorado
MEDIDA OPCIONAL
If you have a proxy server and would like to set up MinKNOW using a proxy, follow the instructions below.
Open the user_conf
file:
/opt/ONT/MinKNOW/conf/user_conf
And edit the following portion of the file:
"proxy": {
"cereal_class_version": 0,
"use_system_settings": true,
"auto_detect": true,
"auto_config_script": "",
"https_proxy": "",
"proxy_bypass": ""
Edit the https_proxy
setting, which should be in the style of:
scheme://[username:password@]host:port or "http://domain\\username:password@host:port", where "scheme" is one of https, socks, socks4 or socks5.
11. Updating MinKNOW for Windows and macOS
Actualizaciones de MinKNOW
Las actualizaciones del MinKNOW se mostrarán en la configuración del servidor o en una ventana emergente cuando se abra el programa. Para instalar nuevas versiones, el usuario deberá seguir las instrucciones que aparecezcan en pantalla.
Los detalles de cada actualización se comunicarán en los anuncios de la comunidad Nanopore.
Recomendamos a los usuarios que, cuando haya una nueva versión disponible, actualicen el programa tan pronto como sea posible.
Nótese que, los usuarios no podrán actualizar su dispositivo si se conectan de forma remota o si hay una ejecución en curso.
IMPORTANTE
Proteja los scripts personalizados, antes de actualizar MinKNOW
Si ha creado scripts personalizados en MinKNOW, guárdelos de forma segura para que no se sobrescriban durante la actualización del programa.
Tenga en cuenta que la estructura del script puede cambiar de una versión a otra; los scripts personalizados escritos para una versión pueden no ser compatibles con la siguiente.
Al abrir MinKNOW desde el icono del escritorio, el programa comprobará automáticamente si hay actualizaciones disponibles.
Cuando haya una nueva actualización disponible, se abrirá un cuadro de diálogo.
Seleccionar Actualizar.
Las actualizaciones pueden omitirse. No obstante, es recomendable actualizar el dispositivo en cuanto haya actualizaciones disponibles. Algunas actualizaciones serán obligatorias y no podrán omitirse.
Nota: En el MinION Mk1B, al pulsar Actualizar se abrirá la página de descargas del programa donde el usuario podrá descargar la actualización de MinION que corresponda.
También es posible actualizar el dispositivo desde la página Programas informáticos de la Configuración del servidor.
IMPORTANTE
Reinstalar MinKNOW
En algunos casos (por ejemplo, si hay un problema con la versión de MinKNOW que se está utilizando), será necesario volver a instalar el programa. Para ello, primero hay que desinstalar por completo la versión actual. Para realizar esta operación, siga las instrucciones del artículo de la sección Support: Cómo desinstalar MinKNOW en el Mk1B y el P2 Solo
12. Actualizaciones de MinKNOW para Linux
Actualización de MinKNOW:
sudo apt clean
sudo apt update
sudo apt install ont-standalone-minknow-release
Se instalará la última versión de MinKNOW. Cuando los comandos se hayan completado, reinicie el programa:
sudo reboot
IMPORTANTE
Reinstalar MinKNOW
En algunos casos (por ejemplo, si hay un problema con la versión de MinKNOW que se está utilizando), será necesario volver a instalar el programa. Para ello, primero hay que desinstalar por completo la versión actual. Para realizar esta operación, siga las instrucciones del artículo de la sección Support: Cómo desinstalar MinKNOW en el Mk1B y el P2 Solo
13. Login and logout
Recomendamos a los usuarios que inicien sesión en MinKNOW con los datos de acceso de la comunidad Nanopore.
Para iniciar sesión, debe estar conectado a Internet.
En la pantalla inicial, es posible cambiar el idioma de la interfaz en la esquina inferior derecha.
El sistema le pedirá que introduzca su dirección de correo electrónico y contraseña de Nanopore:
Si tiene problemas para iniciar sesión, visite la página de ayuda de la comunidad Nanopore (https://community.nanoporetech.com/support) y elija la opción Continuar como invitado de forma temporal.
To log out of the MinKNOW software:
- Click the button in the top right corner, labelled with your initials or 'Guest' and click Logout.
Guest login
The guest account can be used for individuals without a Nanopore Community login without limitations to any processes when connected locally to a device.
However, when remotely connected, guest account accessibility depending on how remote access availablility is set up in Device security settings.
14. Connection Manager
The Connection Manager enables you to connect to your devices.
MinKNOW can be accessed directly on the device or from another computer that remotely connects to the device used for sequencing, and summarises the states of the flow cells in the device.
- Blue tag: direct connection
- Purple tag: remote connection
Click Add host and enter the IP or hostname of a device to add it to the connection manager for remote access.
To interact with a device, click on the device you want to access from the Connection Manager.
You will be navigated to the Sequencing Overview page of the device where the flow cell states are displayed.
This example shows a Flongle Flow Cell inserted in a MinION Mk1C device.
You can now navigate through MinKNOW, start a new sequencing experiment, perform post-run analysis, or view previously run experiments on the device.
15. Device security settings
Default security settings
Default security settings for devices requires users to have a Nanopore account to remotely connect to a device.
To change the remote access availability, settings can be updated when directly connected to a device.
Open 'Host settings' when directly connected to a device.
Navigate to the 'Device settings'. Security settings options are located in 'Remote access availability'.
Select options for local and remote access.
16. Homepage
Homepage overview
The MinKNOW Homepage enables you to navigate to:
a. The Start homepage b. Sequencing overview of connected flow cells c. Recent and current experiments d. System messages e. Host settings f. Connection manager to connect with other available devices g. Start sequencing experiment h. Start from a sample sheet i. Flow cell check j. Post sequencing analysis k. Custom scripts l. Hardware check m. Minimap2 converter to generate .mmi from .fasta file n. Guest/user initials for application settings and logout
Sequencing Overview
This page displays the inserted flow cell state and progress of a current sequencing experiment, including pausing, pore scan and basecalling.
Flow cell with no checks: This example is on a GridION device.
Sequencing states: These examples are on a GridION device.
Pore scan:
Flow cell health after the first pore scan:
Run paused:
Basecalling catch up post-sequencing:
Click the flow cell to open the quick view of the current experiment.
Experiments page overview
The experiments page displays summary information for all experiments and device check data. You can control runs and see real-time information from sequencing flow cells.
All previous runs can be viewed here by altering the number of days available in "Experiments active in the last ... days".
System Messages
All device reports and messages are displayed here.
17. Hardware check
IMPORTANTE
Examinar el equipo
La comprobación del equipo debe realizarse en todos los dispositivos nuevos o tras actualizar el programa. Para ello se utilizan las celdas de prueba de configuración (CTC), que vienen preinsertadas en el dispositivo en lugar de las celdas de flujo.
Nota: Si se trabaja con celdas de flujo Flongle, se recomienda revisar regularmente el adaptador. Para ello se debe insertar un adaptador vacío y proceder a examinar el equipo. Para verificar la posición de la celda de flujo o del dispositivo, utilizar una celda de prueba de configuración CTC MinION, aunque se vaya a utilizar una celda de flujo Flongle en la secuenciación.
Insert a Configuration Test Cell (CTC) into the device.
Ir a la página de inicio y pulsar en la opción "Examinar el equipo".
Click 'Start' for the check to begin.
This example is on the MinION device with a Flongle adapter. Note: To check the Flongle adapter, insert the EMPTY adapter. To check device or position, insert just a MinION CTC - the Flongle adapter is not needed.
This example is on the GridION device. Ensure to select the postition(s) with a CTC inserted before starting hardware check.
You will be automatically navigated to the Sequencing Overview page.
A loading bar will be displayed under the flow cell during the checks.
This example uses a MinION CTC.
FIN DEL PROCESO
The hardware check will complete after approximately one minute.
Hardware check results are indicated as follows in the top left corner:
- Pass is indicated by a green check icon
- Fail is indicated by an orange check icon
If the hardware check fails, remove and reinsert the CTC, and run a hardware check again. If the check fails for a second time, please contact Technical Support via email (support@nanoporetech.com) or via Live Support in the Nanopore Community.
18. Flow cell check
Verificar la celda de flujo
Recomendamos examinar la celda de flujo y verificar el número de poros disponible, antes de cargar una biblioteca de ADN o ARN en ella.
Oxford Nanopore Technologies sustituirá cualquier celda de flujo con un número de poros activos inferior al indicado por la garantía —en un plazo de 12 semanas desde la compra— siempre y cuando el resultado se notifique dentro de los dos días siguientes a la verificación y se hayan seguido las instrucciones de almacenamiento.
Celdas de flujo | Número mínimo de poros activos cubierto por la garantía |
---|---|
Flongle (FLO-FLG001) | 50 |
MinION/GridION | 800 |
PromethION | 5000 |
Ir a la página de inicio y pulsar en Verificar celda de flujo
Cuando aparezca el tipo de celda de flujo y se reconozca el identificador, pulsar Empezar.
Este ejemplo es de un dispositivo GridION:
Nota: En Flongle, el identificador de la celda de flujo se debe introducir manualmente.
IMPORTANTE
En el caso de las celdas de flujo Flongle, el identificador no se asigna automáticamente en MinKNOW. Es imprescindible introducir el identificador en el formato correcto: ABC123, es decir ([A-Z] x 3 [0-9] x 3).
El identificador distingue entre mayúsculas y minúsculas, sin espacios. El programa MinKNOW no permitirá continuar hasta que se haya introducido el identificador.
Si los datos introducidos no tienen el formato correcto o falta algo, aparecerá una notificación en la esquina inferior derecha de la interfaz.
A continuación, resaltado en azul, hay un ejemplo de identificador de celda de flujo Flongle:
You will be automatically navigated to the Sequencing Overview page.
During a flow cell check, a loading bar will appear underneath the flow cell to indicate the progress of bringing the flow cell up to temperature before another loading bar appears for the flow cell checking process.
This example is a MinION Flow Cell.
Flow cell health indicators
The quality of the flow cell will be shown as one of the three outcomes on the Sequencing Overview page:
Yellow exclamation mark: The number of sequencing pores is below warranty.
Green tick: The number of sequencing pores is above warranty and ready for sequencing.
Question mark: A flow cell check has not been run on the flow cell during this MinKNOW session.
Note: the indicator of quality will only remain visible during the MinKNOW session when testing occurred. Once the sequencing device has been re-started, the status of the flow cell will be erased.
19. Experiments page
Experiments page
The experiments page displays summary information for all sequencing flow cells and device checks carried out on the device.
Previous runs can be viewed on the UI at the top of the screen and the number of days to view the last active experiments can be altered by typing in a different integer.
From this page, you can control specific runs and identify real-time information, including flow cell health and reads.
- Run statistics: The total number of reads, estimated and basecalled bases across an experiment, and number of active and total runs
- Run time: The duration of the experiment
- Run state: The current state of the sequencing run; 'Active', 'Basecalling', 'Complete', 'Stopped with error'
- Health: The current flow cell health
The white panel displays a summary of sequencing experiments and the blue panel displays status information of a specific run.
Example of experiments page on GridION:
For more status information of a specific run, click the run to open the quick view, including current temperature and voltage. In the example below, the run in position X3 was clicked to open the quick view.
Live sequencing graph configuration
Page configuration allows you to choose which graphs to generate in the quick view of an experiment.
To open page configuration, click on a run in the white panel to open the quick view and select the highlighted button to choose which graphs to display.
Tabs:
- Default: Default graphs available
- All: All graphs available
- Custom: Users can move graphs from 'Available pages' to 'Your pages' to display a custom order of graphs in the GUI. On this page, you can also choose graph order. Click the graph and drag, then click Save.
Graphs
Click on the specific run to open the experiment details and view the graphs. Use the arrows to navigate between the graphs.
For more information about the graphs, refer to Checks and monitoring.
Pausing
Sequencing experiments can be paused by selecting and pausing a single or all flow cell positions.
Pausing works by dropping the voltage potential over the membrane to 0 mV to maintain a safe environment to add components, such as more DNA/RNA library or nucleases for a flow cell wash. Data acquisition will continue during this period, as this prevents sequencing data from being lost.
To pause, click Pause in the run controls to open a dialogue box and select which flow cell position(s) to pause and click Pause.
Triggering a pore scan
The pore scan is used to assess the quality of the four wells in each channel to select the best performing pores. A new pore scan can be triggered every time a sequencing experiment is resumed after a pause (e.g. for a flow cell wash), or if the number of sequencing pores has significantly dropped during an experiment.
Navigate to the Experiments page, open a specific run, and click Start pore scan in the run controls. Confirm the flow cell to be scanned and click Start pore scan.
20. Sample sheet upload
For GridION and PromethION experiments, or when multiple MinION Mk1B/Mk1D or MinION Mk1C devices are running simultaneously, it may be preferred to upload sample names and corresponding flow cell positions from a CSV file, rather than manually.
The sample sheet may describe flow cells being run at one or more than one position. The columns available are as follows, though some are optional:
Column title | Description | Notes |
---|---|---|
flow_cell_id | Defines the flow cell ID which applies to the sample sheet row. | Used to identify which positions to apply values to in MinKNOW. This is optional if position_id is specified |
position_id | Defines the flow cell position which applies to the sample sheet row. | Used to identify which position to apply values to in MinKNOW. This is optional if flow_cell_id is specified. |
sample_id | Defines the sample ID to be applied in the run | An individual position can only have one sample_id assigned to it when starting a run. This is optional. |
experiment_id | Defines the experiment ID to be applied | Each row in the sample sheet must contain the same experiment_id value for the sample sheet to only have a single experiment_id value defined overall. All entries in each row will be validated. |
flow_cell_product_code | Defines the product code of the flow cell | Used to find the correct sequencing script to start the run |
kit | Defines the kit and any expansion kits used with the sample | Used to find the correct sequencing script to start the run. The sample sheet must contain only one sequencing kit, but expansion kits are not limited. If expansion kits are additionally defined, they should be separated by a space: e.g. SQK-LSK109 EXP-NBD104 EXP-NBD114 Note: Ensure the correct format of the kit name is used, converting any full stops in the kit name to a dash. For example, the Rapid Barcoding Kit V14 96 (SQK-RBK114.96) format in the sample sheet would be SQK-RBK114-96. |
For experiments that involve barcoding, an alias is associated with each barcode (or pair of barcodes where appropriate). Additional columns are available for barcoding runs:
Column title | Description | Notes |
---|---|---|
alias | User-specified string which applies a given label to a specific barcode or barcode pair. | The alias cannot be an existing barcode folder name e.g. 'unclassified', 'classified' and 'mixed' are not allowed. The alias must be between 1 and 40 characters. The character set needs to match the following format: /^([0-9a-zA-Z-_] and only contain the following characters: numbers, upper/lower-case letters, dashes, and underscores. |
type | One of the options: test_sample, positive_control, negative_control, no_template_control | This is optional. |
One or two columns define the barcode or barcode pair. The exact form is dependent on whether single or dual barcoding is being used.
Single barcoding: the sample sheet contains one barcoding arrangement column:
Column title | Description | Notes |
---|---|---|
barcode | The barcode identifier for the row e.g. barcode01 |
Dual barcoding: the sample sheet contains two barcoding arrangement columns:
Column title | Description | Notes |
---|---|---|
internal_barcode | The internal barcode identifier for the row, e.g. internal01. | |
external_barcode | The external barcode identifier for the row, e.g. external01. |
Column titles are defined within the first row of the sample sheet. These must be defined in lowercase using the column title values listed above.
Sample sheet validation occurs against the device configuration and between rows in the sample sheet to ensure validity when the sample sheet is loaded. Validation and importing the sample sheet requires all the flow cells to be used in the experiment. Be careful to ensure the correct flow cells and positions are used.
Below is an example sample sheet CSV file for using the Native Barcoding Expansion 96 (EXP-NBD196) with the Ligation Sequencing Kit (SQK-LSK109) on a GridION device for a single position.
Navigate to the Start page.
Click Start from a sample sheet.
Select and upload the CSV file.
If any errors are indicated in the sample sheet, these should be fixed in the CSV file. Following this, upload the CSV file as in step 3.
Once the sample sheet is uploaded with no errors, click Continue.
Instructions on selecting sequencing parameters and starting a run can be found in the Starting a sequencing run section
21. Save and load sequencing run settings
Sequencing run template
Sequencing parameters can be saved as a template in MinKNOW at the review stage for users who regularly use the same parameters and to save set-up time. The template can be loaded when setting up a new sequencing run with sample sheet but can be reviewed and edited before starting the run.
Set up a sequencing run on MinKNOW as outlined in the Sample sheet upload section.
On the Run configuration page, click Save configuration before starting the sequencing run.
Fill in the template name and click save.
To use the saved template on a new sequencing run, click Load configuration on the Run configuration page.
Select a previously saved configuration and click Load. Saved configurations in the list can be deleted by clicking Delete.
To transfer a configuration file between devices, it can be exported to a JSON file by clicking Export, or imported by clicking Import.
Review the sequencing parameters on the review tab and start the run by clicking Start.
Users can also join an existing experiment that has been previously run on the device:
- Fill in the experiment name and select flow cell position.
- Choose the same flow cell type as used in the previous experiment.
- Click Join existing.
- Select the previous experiment to run and click Join.
- The previous experiment parameters will load with the experiment name.
- Fill in the sample ID(s) and review settings in the "Review" tab and start the run.
Note: Flow cell types must be the same between both experiments to join.
Sequencing parameters using a JSON file (for MinKNOW versions 24.06 and earlier):
Alongside a CSV file containing the sample information, users can also upload a JSON file containing the sequencing parameters for their experiments rather than inputting the information manually.
A JSON file in the correct format, containing all default settings, can be exported from MinKNOW and altered:
###Run options tab:
"runLengthHours": 72,
(Run length. This must be an integer)
"enrichDepleteAdaptiveSamplingEnabled": false,
"enrichDepleteAdaptiveSamplingRefFile": null,
"adaptiveSamplingChannelStart": 1,
"adaptiveSamplingChannelEnd": 512,
"enrichDepleteAdaptiveSamplingBedFile": null,
"shouldEnrichAdaptiveSamplingRef": true,
"barcodeBalancingEnabled": false,
"barcodeBalancingCustomBarcodes": false,
"barcodeBalancingBarcodeSelection": null,
"minReadLength": 200,
(Read length selection. This can be 20, 200 or 1000)
"activeChannelSelection": true,
"muxScanPeriod": 1.5,
"groupChangePeriod": 16,
"reservedPores": true,
###Analysis tab:
"basecallingEnabled": true,
(Basecalling can be switched on/off as true/false)
"modifiedBasecallingEnabled": false,
"barcodingEnabled": true,
(Barcoding can be switched on/off as true/false) "basecallModel": "dna_r9.4.1_450bps_hac.cfg",
(Basecalling model depends on the flow cell and kit combinations. Make sure that the basecall model is stated as a ".cfg" "modifiedBasecallingContext": "",
"trimBarcodesEnabled": true,
(Trim barcodes can be switched on/off as true/false) "requireBarcodesBothEnds": false,
(Requirement to have barcodes on both ends can be switched on/off as true/false) "detectMidStrandBarcodes": false,
(Detect mid read barcodes on/off as true/false) "overrideMidBarcodingScore": false,
(Override mid barcoding score can be switched on/off as true/false) "overrideBarcodingScore": false,
(Override barcode score can be switched on/off as true/false) "minBarcodingScore": 60,
(Selection of barcode score. This can be an integer between 40 to 100) "minBarcodingScoreMid": 50,
(Selection of mid barcode score. This can be an integer between 40 to 100)
"alignmentRefFile": null,
"alignmentBedFile": null,
###Output tab:
"dataOutputLocationType": 0,
"offloadOrOutputLocationNavParams":
"path": "/data/."
` "fastQEnabled": true,` __(FASTQ files can be switched on/off as true/false)__ ` "fastQReadsPerFile": 4000,` __(Number of reads per file. This is an integer)__ ` "fastQDataCompression": true,` __(FASTQ compression can be switched on/off as true/false)__ ` "fast5Enabled": true,` __(FAST5 files can be switched on/off as true/false)__ ` "fast5ReadsPerFile": 4000,` __(Number of reads per file. This is an integer)__ ` "fast5DataCompression": "vbz_compress",` __(Compression type. This can be `"vbz_compress"` or `"zlib_compress"`)__ ``` "selectedRawOutput": "fast5", "pod5Enabled": false, "pod5ReadsPerFile": 4000, "bamEnabled": false, "bamWriteMultiple": true, "readFilteringEnabled": true, "readFilteringMinQscore": 9, "readFilteringMinReadlength": null, "readFilteringMaxReadlength": null, "readSplittingEnabled": false, "overrideMinReadSplittingScore": false, "minReadSplittingScore": 58, "bulkFileEnabled": false, "bulkFileRaw": "1-512", "bulkFileEvents": "1-512", "bulkFileReadTable": "1-512", "bulkFileRawEnabled": false, "bulkFileEventsEnabled": true, "bulkFileReadTableEnabled": true ```
22. Application settings
Application settings contains the tutorials, account/login settings and MinKNOW GUI information.
Navigate to application settings from clicking the initials in the top right corner of the GUI.
The Application settings are available on the Connection manager as well as the device homepage.
Below is an example from the Connection manager:
Tutorials
Tutorials are available here; they are also presented when logging into MinKNOW for the first time. You can use Recap to view a specific tutorial or use Reset tutorial state to go through all the tutorials again on opening the UI.
Account settings
Navigate here to logout from MinKNOW.
User email address used for login is displayed here, unless logged in as a guest.
App information
The installed version of the MinKNOW GUI is available here.
Click Reload to refresh the GUI.
Language settings
To select your language, navigate to the language tab:
23. Overview
Features of the Host settings
The Host settings have several features to co-ordinate the device. From this area, users are provided with information on system parameters, such as storage, date/time and IP address.
To navigate to this area, click 'Host settings' in the side panel.
Use the side panel to navigate through the host settings option. Depending on the device, different options are available. Below is a full list of the options available in the host settings:
Device Settings: The devices can be shut down and rebooted from this page, and settings for the time and date can be altered. Disk space can be managed and peripherals may also be added and ejected from here. Software: Users are able to download the latest software updates from this page. The option to update will only appear when an update is available. File Manager: Stored data on the device can be managed and transferred. System: Overview showing disk space utilisation, CPU and memory usage. Help: Device logs can be exported using the Export Logs function. Logs and temporary data can also be cleared by using the Clean up function. If troubleshooting of the device is required, a Repair problems function is available as well as a MinKNOW restart option. Network settings: Ethernet and WiFi settings are available here with the option to hotspot the device to connect to a larger screen. API access Beta features: An overview of the beta features available on the device. Either individual or all beta functions can be disabled from here.
Click Back to Main Menu to leave host settings.
Host settings pages
- Device settings: Unavailable on MinION Mk1B/Mk1D.
View from remotely accessed device:
View directly accessed device:
Software: Available on all devices.
File manager: Unavailable on MinION Mk1B/Mk1D.
System manager: Unavailable on MinION Mk1B/Mk1D.
Help: Available on all devices.
Network settings: Available on MinION Mk1C and MinIT.
Beta features: Available on all device.
24. Shutting down
Navigate to the Device settings and click "Shut down".
Pulsar Apagar en el menú desplegable.
25. Rebooting
Navigate to Device settings and click "Reboot".
Click "Reboot" in the pop up to confirm.
Note: Reboot is unavailable on GridION but the software can be restarted.
To restart MinKNOW on GridION, navigate to 'Help' in the host settings and click "Restart MinKNOW".
26. System package updates
System package updates
System package updates for your device can be performed through the MinKNOW UI.
Availability of system package updates are indicated via the MinKNOW host settings in the software tab.
System package updates will not affect sequencing accuracy or quality.
We recommend maintaining your device updated with the the most up-to-date system packages.
However, having out-of-date system packages will not impact sequencing accuracy or quality.
Perform system package updates at your discretion and in accordance with your IT policies.
Note: Users will not be able to update their device if connected remotely or if a run is in progress.
Navigate to the software tab in host settings.
In the System window, click "Install packages".
The system package update can be monitored via the progress bar.
Once the update completes successfully, power cycle your device to complete installation.
CONSEJO
In event of a system package update failiure, an error message will appear.
The error message contains copyable details that you can use to assist with tech support.
If you see some system packages remain after a system update, please update MinKNOW and the number should return to zero.
For more information on updating MinKNOW visit the Updating MinKNOW for Windows and macOS or Updating MinKNOW for Linux sections of this document.
27. Data management
Gestor de archivos
Los datos se administran y transfieren desde la pestaña Gestor de archivos de la Configuración del servidor.
Los datos almacenados se encuentran en las pestañas situadas en la parte superior:
- Interno: datos almacenados en el dispositivo de secuenciación conectado (MinION Mk1C, GridION, PromethION).
- Extraíble: datos almacenados en un dispositivo de almacenamiento extraíble conectado, por ejemplo, una unidad USB.
- Red: datos almacenados en una unidad de red conectada. La unidad de red debe montarse antes.
Cómo acceder al dispositivo en remoto desde una unidad de red o unidad compartida:
Ir a la configuración del dispositivo y activar la opción Share/Compartir.
Se abrirá una ventana donde crear la contraseña.
Pulsar en Establecer contraseña y tras unos segundos el interruptor se activará.
Ahora será posible compartir los datos y acceder a ellos desde diferentes redes.
Nota: La imagen de arriba es un ejemplo de uso compartido en un GridION. Cuando estén activos, en los dispositivos MinION, aparecerá 'minit' y en los PromethION aparecerá 'prom'.
CONSEJO
Si quiere dejar de compartir, mueva el interruptor a su posición inicial.
Nota: La contraseña se eliminará y debe restablecerse cuando se vuelva a activar el uso compartido.
Gestión de datos entre las pestañas Interno, Extraíble y Red:
Al activar la opción 'Seleccionar' se habilitarán las opciones atenuadas "Copiar", "Mover", "Eliminar" o "Renombrar" de la esquina inferior derecha.
Las opciones de la esquina inferior derecha se activarán al seleccionar una carpeta o archivo.
Al pulsar en "Copiar" o "Mover" se abrirá un cuadro de diálogo con una lista de las unidades a las que tendrá acceso el dispositivo.
Nota: en la carpeta "Dispositivos" aparecerá una unidad USB o una tarjeta SD conectada.
Pulsar en una unidad de disco, navegar a través del directorio de archivos y elegir el destino. Pulsar en una de las opciones "Copiar" o "Mover", según convenga.
To use the delete function, select a file or folder, and click "Delete" and confirm action in the pop up.
To use the rename function, select a file or folder, and click "Rename" and type in the new name and confirm in the pop up.
Compatible disk formats:
SD and USB on MinION Mk1C supports DOS FAT, Windows 95 FAT, xFAT, and Linux ext(2|3|4).
Es posible crear nuevos directorios desde la interfaz gráfica del dispositivo usando el icono "Nuevo directorio".
Hacer clic en el icono —Crear un nuevo directorio— situado en la esquina inferior derecha y asignarle un nombre. A continuación, pulsar Crear.
Gestión de discos
Ir a la Configuración del dispositivo para ver el espacio que hay disponible en el disco. Todos los periféricos que estén conectados, incluidos los USB, se extraen mediante la opción Expulsar.
La unidad de red también se conecta al dispositivo al seleccionar Add Network Drive/Añadir unidad de red e introducir los datos de acceso para conectarse con un servidor Samba (SMB) o a un Sistema de archivos de red (NFS).
28. Mount Network Drive
Network drives
Network drives for data storage can be mounted from either the Device Settings or the File Manager in the Network tab:
Device Settings:
File Manager:
Hacer clic en "Añadir unidad de red".
Se abrirá un modal. Hacer clic en SMB (Samba) o NFS (Network File system).
Utilizar SMB para conectarse a una unidad de disco compartida en un servidor Windows y NFS (sistema de archivos de red) para Linux. Si la unidad de disco compartida está en un dispositivo macOS o NAS (almacenamiento conectado a la red), es posible utilizar SMB o NFS.
SMB:
NFS:
Montar recursos compartidos SMB:
- Introducir el nombre de servidor o la dirección IP del recurso compartido SMB. Esta información se obtiene del administrador de red.
- Introducir la unidad de disco, en el servidor de red que el usuario quiere compartir. Nótese, debe empezar por '/', por ejemplo
/data
. - El campo "Mount Point" (punto de montaje) se rellenará automáticamente con el nombre de servidor y la ruta al recurso compartido de red. Además, el campo se puede personalizar. En el administrador de archivos, aparecerá, por ejemplo, como:
/data/network/mt-111111-data
. - Añadir un nombre de usuario.
- (Opcional) Introducir una contraseña.
- (Opcional) Introducir un nombre de dominio.
- Hacer clic en Montar.
Si los ajustes son correctos, la unidad de disco montada se agregará a la vista general del 'Administrador de discos'. El usuario podrá:
- Ver la información de espacio de la unidad de disco
- Desmontar la unidad de red
- Obtener un enlace para ir al punto de montaje dentro del administrador de archivos
Montar recursos compartidos de NFS:
- Introducir el nombre de servidor o la dirección IP del recurso compartido NFS. Esta información se encuentra en el administrador de red.
- Introducir la unidad de disco en el servidor de red que el usuario quiere compartir. Nótese que debe empezar por '/', por ejemplo
/datos
. - El campo 'Mount Point' (punto de montaje) se rellenará automáticamente con el nombre del servidor y la ruta al recurso compartido de red. Este campo se puede personalizar. En el administrador de archivos, aparecerá, por ejemplo, como: /data/network/mt-111111-data.
- Hacer clic en Montar.
Si los ajustes son correctos, la unidad de disco montada se agregará a la vista general del administrador de discos. El usuario podrá:
- Ver la información de espacio para la unidad de disco
- Desmontar la unidad de red
- Obtener un enlace para ir al punto de montaje dentro del administrador de archivos
29. Tutorials
Tutorials
On opening the MinKNOW software, the tutorials will start to navigate you through the user interface.
Skip tutorials
Tutorials may be skipped if you are familiar with the user interface.
To skip tutorials, select the three dots and choose to either skip all tutorials or just a section.
Review tutorials
Tutorials can be reviewed again by selecting Reset tutorial state in the Tutorials panel of Application Settings.
30. Configuración y conexión a la red
Los ajustes de red muestran información sobre la conexión a Internet. El MinION Mk1C se puede conectar a través de Ethernet o Wi-Fi.
Ambas opciones son compatibles, sin embargo, si Ethernet está disponible, recomendamos elegir esta opción, ya que es probable que la conexión sea más rápida y estable.
Ethernet
Conexión mediante Ethernet: 1. Conectar el cable Ethernet al dispositivo 2. Para confirmar la conexión, ir a la configuración del servidor y luego a la configuración de red. La información de la configuración IP aparecerá cuando esté conectado.
Wi-Fi
Ir a la configuración de red y activar Wi-Fi. A continuación, seleccionar una red en el panel de Redes disponibles.
Al seleccionar Avanzado se abrirá la Configuración avanzada de Wi-Fi. Aquí aparecerán, todas las redes disponibles.
IMPORTANTE
Nótese que, las conexiones Wi-Fi con portales cautivos (una página web que el usuario debe ver y en la que debe introducir sus datos de inicio de sesión antes de que se conceda el acceso) no se pueden utilizar con el MinION Mk1C.
Configurar una dirección IP estática
La dirección IP estática se puede configurar a través de MinKNOW UI tanto para WiFi como para Ethernet. A continuación, se muestra un ejemplo correspondiente a Ethernet.
- Al hacer clic en Editar en la "Configuración IP", se abrirá el cuadro de diálogo "Editar la configuración de la dirección IP".
- Seleccionar una de las pestañas, DHCP o Static, y hacer clic en Confirmar
- Una vez se haya cambiado la configuración de la dirección IP, hacer clic en Finalizar.
Activar el punto de acceso a Wi-Fi permitirá que los usuarios se conecten a una pantalla más grande.
Esta función sirve para conectarse al MinION Mk1C en lugares donde no hay infraestructura de red, por ejemplo, en el campo. Para habilitar el punto de acceso a internet, seleccionar la opción ENCENDIDO. Cuando esté activo, se mostrará el nombre del punto de acceso a internet del dispositivo.
En caso de redes congestionadas, cuando puede haber competencia por los canales, la configuración del punto de acceso a internet permite editar y seleccionar un canal.
- Ir a la configuración de red
- Habilitar el punto de acceso a internet, moviendo el interruptor a la posición de ENCENDIDO
- Hacer clic en 'Configurar punto de acceso a internet'
- Seleccionar el canal usando el menú desplegable
- Introducir la nueva contraseña
- Pulsar en 'Confirmar'
El punto de acceso a internet debe confirmarse como se especifica en la configuración del mismo.
Cómo conectar el rúter inlámbrico del MinION Mk1C a un dispositivo Windows:
- Localizar el identificador del MinION Mk1C en la etiqueta situada en la parte inferior del dispositivo:
Hacer clic en el identificador del MinION Mk1C, en el __panel de Conexiones Wi-Fi__ del __Panel de control__, o en las opciones situadas a la derecha de la __Barra de tareas__.
Iniciar sesión con la siguiente contraseña: WarmButterflyWings98
- Acceder al MinION Mk1C a través del Explorador de archivos: Ir a \\mc-XXXXXX (XXXXXX es el identificador del MinION Mk1C) en la barra de direcciones. Al conectarse al MinION Mk1C a través del Explorador de archivos, se pedirán los datos de acceso a la red.
Cómo conectar el rúter inlámbrico del MinION Mk1C a un dispositivo macOS:
- Localizar el identificador del MinION Mk1C en la etiqueta situada en la parte inferior del dispositivo:
- Pulsar en el icono de Wi-Fi a la derecha de la barra de menú, situado en la parte superior de la pantalla:
Seleccionar el identificador de MC-XXXXXX en el Nombre de red, situado en el Panel de red (la última opción bajo el icono de Wi-Fi), que se muestra en la ventana de abajo (a la izquierda)‡. Al hacerlo, aparecerá la ventana emergente de inicio de sesión Wi-Fi. Utilizar la contraseña que se muestra a continuación.
Conectarse con la siguiente contraseña: WarmButterflyWings98
- Acceder al MinION Mk1C a través del navegador de red: Utilizar el buscador para localizar la red. Hacer clic en Servidor, en la pestaña situada en la parte inferior izquierda de la barra de Búsqueda.
Se mostrará MC-XXXXXX (XXXXXX corresponde al identificador del MinION Mk1C) como opción del servidor. Al hacer clic en el icono MC-XXXXXX hacer clic en Conectarse como, situado debajo de la barra de búsqueda e introducir los datos de acceso.
‡ La conexión al dispositivo por SSH se puede abordar de tres maneras diferentes:
- Con DNS
- Con mDNS
- Mediante el uso directo de la dirección IP
En la mayoría de las organizaciones, se utilizan servidores centrales DNS. Si su dispositivo utiliza una configuración IP "estática", el departamento de Informática de su institución tendrá que crearle manualmente una entrada DNS. Si el dispositivo utiliza una configuración IP dinámica (DHCP), a menudo, la entrada DNS se creará automáticamente. Para acceder mediante SSH a su dispositivo utilizando DNS, establezca el nombre de servidor en su cliente con el nombre de servidor del dispositivo, por ejemplo, MC-112345.
Si su organización o rúter de banda ancha no proporcionan DNS, pruebe con mDNS. Cuando el dispositivo esté conectado a una red, anunciará su presencia a los demás dispositivos cercanos, como su portátil o PC. Si su portátil o PC están configurados para reconocer estos anuncios, podrá acceder a su dispositivo mediante SSH utilizando mDNS. Configurar el nombre del servidor en el cliente, escribiendo el nombre del servidor del dispositivo seguido de ".local", por ejemplo, MC-112345.local.
Si los métodos anteriores no dan resultado, use directamente la dirección IP de los dispositivos. La interfaz de usuario de MinKNOW muestra las direcciones IP para cada interfaz en la página Configuración - Red. Si su dispositivo tiene interfaces LAN y Wi-Fi, cada una tendrá una dirección IP diferente. Para acceder a su dispositivo mediante SSH, con la dirección IP del mismo, establecer el nombre de servidor en el cliente utilizando la dirección IP, por ejemplo, 10.20.30.41.
Cómo conectar el rúter inlámbrico del MinION Mk1C a un dispositivo Linux:
- Localizar el identificador del MinION Mk1C en la etiqueta situada en la parte inferior del dispositivo:
- Hacer clic en el icono de Wi-Fi a la derecha de la barra de menú, en la parte superior de la pantalla:
Localizar y hacer clic en el identificador MC-XXXXXX, situado bajo el icono de las opciones de red Wi-Fi (mostrado arriba). Introducir la contraseña para la Wi-Fi (que se muestra a continuación) en la ventana emergente Autenticación de red Wi-Fi:
Iniciar sesión con la contraseña: WarmButterflyWings98
Cuando se haya conectado al rúter inalámbrico del MinION Mk1C, aparecerá la siguiente ventana.
- Acceder al MinION Mk1C usando el Explorador de archivos Linux e introducir la dirección del servidor.
Abrir el Explorador de archivos (puede encontrarse usando la herramienta de Búsqueda). Seleccionar Conectar al servidor en la parte inferior de la lista, situada en el panel izquierdo. A continuación, introducir:
smb://mc-110013
31. Beta features
Beta feature availability
For devices with beta features available, users can choose to have beta features enabled or disabled on their device. By default, these features will be enabled and highlighted in the UI with a yellow "beta" badge.
To disable the beta features:
- Navigate to Beta features in the host setting.
- To disable all beta features and enable the "Beta features enabled" switch.
- To disable an individual feature, uncheck the tick box for the for the specific beta feature.
32. Resolución de problemas
Si surge algún problema relacionado con el dispositivo o la secuenciación, póngase en contacto con el Servicio técnico.
La sección de preguntas frecuentes sobre MinKNOW, FAQ, se encuentra aquí.
En la mayoría de casos, para identificar o resolver un problema recomendamos exportar los registros y enviarlos al Servicio de asistencia técnica.
Help feature and support link from MinKNOW.
The Nanopore support hub can also be accessed directly from your MinKNOW UI.
In the top right of MinKNOW you will see the "Help" option:
Clicking this option will bring you to a page with a link and a QR code:
On larger devices such as the GridION and PromethION 24/48, and devices such as the MinION Mk1B/Mk1D and P2 Solo, clicking the link will directly bring you to the Nanopore support page.
On devices such as the P2 Integrated and MinION Mk1C, you will be able to scan the QR code with another device, or type in the shortened URL on another device to quickly reach the support hub.
Cómo exportar registros:
En los modelos PromethION 24/48, PromethION 2i, GridION y/o PromethION 2 Solo, conectados a un GridION:
- En la sección Exportar registros, pulsar Exportar.
Cuando se hayan exportado los registros, debajo del botón aparecerá indicado dónde se encuentran. Los registros se descargarán como archivos TGZ en el directorio de registros.
Es posible cambiar la ubicación de los registros utilizando el administrador de archivos, donde pueden recuperarse fácilmente sin necesidad de SSH:
- Hacer clic en el archivo situado junto a Registros, exportado al panel Exportar registros. Esta acción abrirá la ubicación de los registros en el Gestor de archivos de MinKNOW.
- Utilizar el panel de control en la esquina inferior derecha del Gestor de archivos para mover los archivos de registro.
Si el PromethION " 2 Solo está conectado a un ordenador
Los archivos de registro de cada experimento de secuenciación se pueden encontrar en:
Windows C:\data\logs
Mac OS X /private/var/log/MinKNOW
Linux /var/log/minKNOW
Eliminar registros y datos temporales:
En la pestaña "Ayuda", en la sección 'Eliminar archivos', pulsar Eliminar y confirmar en la ventana emergente.
Nota: los datos de ejecución no se eliminarán. Se eliminarán los registros y datos temporales.
Solucionar los problemas del dispositivo:
En la página "Ayuda", sección "Resolución de problemas", pulsar en "Reparar problemas" y confirmar en la ventana emergente. MinKNOW intentará reparar los siguientes problemas:
- Comprobar que los directorios requeridos en "/data" existan y tengan la propiedad y los permisos necesarios.
- Comprobar que los archivos necesarios en "/data" tengan la propiedad y los permisos necesarios.
- Comprobar que la GPU funcione al máximo rendimiento.
- Comprobar que el Bluetooth esté desactivado.
33. Introduction to local basecalling
Introduction to live basecalling in MinKNOW
For MinION Mk1B/Mk1D, Flongle on MinION Mk1B/Mk1D, and PromethION 2 Solo, the MinKNOW software presents an option to basecall reads on the local computer. The basecalling is carried out live, as the read files are generated during a sequencing experiment.
Basecalling results are displayed in real-time in the MinKNOW user interface, and data is written out in the BAM or FASTQ file format.
Fast, High Accuracy and Super Accurate models and compatibilities
The MinKNOW basecallers offer three different basecalling models: a Fast model, a High accuracy (HAC) model, and Super accurate (SUP) model.
The Fast model is designed to keep up with data generation on Oxford Nanopore devices (MinION Mk1C, GridION, PromethION). The HAC model provides a higher raw read accuracy than the Fast model and is more computationally-intensive. The Super accurate model has an even higher raw read accuracy, and is even more intensive than the HAC model.
For more information about basecalling accuracy, see the Accuracy page on the Oxford Nanopore website.
A comparison of the speed of the models is provided in the table below:
The number of keep-up flow cells assumes a 30 Gbase flow cell output in 72 hours for MinION and GridION, and 100 Gbase output in 72 hours for PromethION.
34. Starting a sequencing run with Flongle
Click 'Start Sequencing' on the Start page to set up the sequencing parameters for your experiment.
Type in the experiment name, sample ID and choose flow cell type from the drop down menu. Fill in flow cell ID in the correct format: ABC123
Ensure the experiment name and sample ID do not contain any personally identifiable information.
Note: If sample ID is not filled in, there will be no sample ID in the folder name structure.
To use previously saved settings, please see the "Save sequencing run settings" page of this protocol.
Select Continue to move to the Kit Selection page.
IMPORTANTE
En el caso de las celdas de flujo Flongle, el identificador no se asigna automáticamente en MinKNOW. Es imprescindible introducir el identificador en el formato correcto: ABC123, es decir ([A-Z] x 3 [0-9] x 3).
El identificador distingue entre mayúsculas y minúsculas, sin espacios. El programa MinKNOW no permitirá continuar hasta que se haya introducido el identificador.
Si los datos introducidos no tienen el formato correcto o falta algo, aparecerá una notificación en la esquina inferior derecha de la interfaz.
A continuación, resaltado en azul, hay un ejemplo de identificador de celda de flujo Flongle:
Select the kit and expansion(s) used to prepare the library.
One sequencing kit can be selected as well as one or more expansions. If a sequencing kit does not have any associated expansions, no expansion options will appear.
The filter options may be used to find the kit used. For example, click DNA to filter for DNA sequencing kits.
For control runs, there is a Control checkbox which only filters for the control experiments of the kits. This will automatically set the sequencing parameters for a control run. Note: Run length will be reduced to 6 hours for control experiments.
Click Continue to navigate to the run configuration page.
CONSEJO
Default sequencing parameters
Click Continue to proceed to the run configuration page.
Default sequencing parameters will be pre-set.
For the majority of users and applications, we recommend keeping the default sequencing parameters unless you have a specific need to change them.
Experiment overview
At the top of the run configuration page you will see an overview of your experiment set-up and identifiers inlcuding:
- Experiment name: defined by user.
- Positions: Flow cell position(s) being used in the sequencing experiment, and the associated sample IDs for the position(s).
Note: If using multiple flow cells, click "show details" to open a window displaying all the positions used and the associated sample IDs. - Flow cell type: automatically detected by the MinKNOW software.
- Sequencing kit: the sequencing kit used for DNA/RNA library preparation, user-defined.
Choose your basecalling options:
The basecalling option is on by default to perform real-time basecalling. This can be switched off and basecalling performed post-sequencing.
Note: If basecalling is disabled, barcoding and alignment will not be performed during sequencing.
Modified bases is off by default. This can be switched on to use the CpG context models and basecall 5mC and 5hmC.
To specify your basecall model and modified bases, click the Edit icon to open basecalling options dialogue box.
Basecall models
Basecalling models can be selected at two stages in the MinKNOW software:
- Real-time basecalling: A basecalling model can be selected when setting up a sequencing run on the "Run configuration" page of MinKNOW. This enables basecalling of the sequencing run in real-time.
- Post-run basecalling: Basecalling can be set up post-sequencing run on MinKNOW. Instructions can be found in the "Post-run basecalling" section of this protocol.
Dorado is the basecaller server in MinKNOW which provides multiple models for basecalling nanopore data.
There are three options for model selection in the drop down menu:
1. High-accuracy basecalling (HAC) - This is our default recommended basecalling model that provides a high single-molecule accuracy. It is currently 5-8 times more computationally-intensive than the Fast model, so users should ensure their data transfer and device utilisation is scaled appropriately for this.
2. Super-accurate basecalling (SUP) - The Super accurate model has an even higher single-molecule accuracy, and is ~3 times more intensive than the HAC model.
3. Fast basecalling - This model is able to keep up with a high-throughput sequencing experiment on a MinION, GridION or PromethION.
Note: GPU devices will basecall in near real-time; CPU devices, like a standard laptop for MinION Mk1B/Mk1D, will not maintain real-time basecalling.
Choose your barcoding options:
Barcoding options are only available when a barcoding sequencing kit or expansion has been selected. Barcoding can be switched off and performed post-sequencing.
To specify the barcoding options, click the Edit icon to open the barcoding options dialogue box. From here, barcode trimming and custom barcode selection can be defined.
By default, barcoding trimming is off. This can be enabled to remove barcodes from demultiplexed reads. Please note, some primer sequences may also be trimmed together with the barcodes.
By default, custom barcode selection is off. This can be enabled to only select for specified barcodes used in your library preparation for the current sequencing run.
Note: Specifying barcodes must be entered as:
- Individual numbers.
- Numbers separated by commas.
- Range of numbers separated by a dash.
- A combination of numbers and ranges, separated by commas.
Some sequencing kits place barcodes on both ends of the read. By default, the barcode both ends feature is off. If this feature is enabled, the barcode will only classified if a barcode above the minimum barcode score is present at both ends of the basecalled read.
Note: For barcoding to be performed during sequencing, basecalling must be enabled.
Choose your alignment options:
By default, alignment is turned off.
To use alignment during sequencing, upload an alignment reference file as a .fasta or .mmi file. We recommend uploading a reference locally on bacterial-sized genomes. Uploading a file can take a few minutes and is compute-dependent.
A reference file can contain multiple entries in the same file (e.g. multiple chromosomes) and alignment hits from these files are used to populate the alignment graphs which can be viewed on the GUI.
A BED file can also be uploaded alongside the reference when there is a specific interest in a particular region of the reference (e.g. specific gene in a chromosome). Alignment hits from BED files will be highlighted in the sequencing .txt file generated in the data folder. Click Edit options to open a dialogue box to upload a BED file.
BED files will be validated upon upload. If there is an error in the validation of the file, an error message will show linking to a web page with guidance on correcting the validation errors.
Note: For alignment to be performed during sequencing, basecalling must be enabled.
Choose your adaptive sampling options:
By default, alignment is turned off.
Enabling adaptive sampling will allow you to enrich or deplete specific sequences from your aligned sequencing data.
For our barcoding kits, the barcode balancing feature is also available using adaptive sampling through the "beta" features in MinKNOW.
By default, all adaptive sampling reads, whether they are accepted or rejected, will be basecalled. If you would like to only basecall on-target reads and not rejected reads, set the Basecally on-target reads only toggle to On. If you enable raw data generation, rejected reads will still be written out but not basecalled.
More information on this feature can be found in our Adaptive sampling documentation.
MEDIDA OPCIONAL
Advanced User Options
Time between pore scans: The time between pore scans can be altered using this feature.
Reserved pore: The reserve pore feature prioritises consistency and accuracy over immediacy by reserving wells where voltages have dropped until later in the run, such that other wells can catch up. Switch off this feature to fully front-load sequence data acquisition.
Set up the data targets for your experiment:
This feature allows you to set up the rules to define when a sequencing run will stop. If multiple rules are set up, the first rule met will stop the run.
Click the Edit icon to open the options.
Run limit
This rule must be defined based on run time length in hours or when a flow cell is end of life and has no more sequencing pores available.
Use the drop-down menu to choose:
- "Time equals" and hours
- or "Flow cell is" which will automatically be set as "End of life".
Flow cell data target
This rule can be used to define a target amount of data to reach before a sequencing run is stopped. This can be specified for either estimated or basecalled bases and your data target will be available to view on the experiment graphs to allow you to monitor data progress.
Please note, basecalling must keep up with data output in real-time. If the device or basecall model will not keep up and reach the target output before the run limit rule is met, we recommend using the "Estimated bases" option. However, if your experiment will not reach the target data before the end of the experiment as defined by the run limit rule, you will be warned by the UI.
Use drop-down menu to select for "Estimated bases equal" or "Basecalled bases equal" and input the value in either Gb or Mb.
Select the output options:
The output section provides variables for data output including file name, location and format.
Click the Edit icon to open the options.
Output settings:
Data saved as:
Check the name of the output file for the data.
Output location:
Confirm the location for the output data file. Click the file path name to open a pop-up to alter file path or create a new file.
Click Choose location on the pop-up to confirm new file location.
Output location storage capacity:
A bar indicator is displayed below the selected data output file location. This bar will display red when the disk space used reaches more than 80% of the total available disk space. Otherwise, the bar will display green. Below the bar, you can see how much drive space is available.
Basecalled output options:
Confirm output file type and file compression using the checkboxes.
Note: Below, reads per file can be changed for both raw reads and basecalled reads, but take note:
- Fewer reads per file: reads become more quickly available. However, too few reads per file means MinKNOW may not keep up with writing out files in real-time.
- More reads per file: reduces the number of files especially for amplicon/cDNA experiments that produce a large number of reads. Some downstream analysis tools may have an upper limit on the uploaded file size.
Basecalled output type:
Output file type can be selected between .FASTQ or .BAM files. The .FASTQ will be on as default if basecalling in real-time.
File output frequency can be adjusted for basecalled files based on two options:
Based on time elapsed | Based on number of reads |
---|---|
Basecalled files can be produced: · every 1 minute (many small files) · every 10 minutes (many small files) · hourly (fewer larger files) · at the end of the run (single large file). | Basecalled files can be produced for specified read thresholds (number of reads). |
For barcoding runs, basecalled reads are split into files by barcode by default.
Gzip compression of FASTQ files is on by default of basecalled reads. Note: FASTQ Gzip files may prevent some downstream informatics applications.
Raw reads output options:
Raw reads: Raw reads output can be saved as .POD5 or .FAST5.
- For Kit 14 chemistry and SQK-RNA004, .POD5 is the default file output. The .POD5 output generates files hourly.
- The .FAST5 output file is the default format for our previous and "legacy" chemistry kits. The.FAST5 output produces files for every 4000 reads.
.POD5 is a Nanopore-developed file format which stores Nanopore data in a more accessible way and can be used as an alternative to FAST5 output. This output also writes data faster, uses less compute and has smaller raw data file size.
We recommend keeping the default settings.
Raw reads split by barcode: Raw read files generated in the .POD5 format can now be split by barcode (if using one of our barcoding sequencing kits.
Please note, this feature is turned off by default and not available for .FAST5 files.
CONSEJO
Advanced User Options
Option to turn bulk file saving either on or off.
Note: This will result in much larger file sizes due to additional information about the run, which is used for debugging.
Choose the filtering options:
Filtering options can be used to determine which reads are classed into pass or fail files. These options may also be used to determine which predefined reads, read lengths and Qscore during basecalling can be split out in some live graphs.
Click the Edit icon to open the filtering options:
Use the GUI to alter Qscore and to define minimum and maximum readlength for a pass read, if required.
Click 'Start' to run the experiment.
You will be automatically navigated to the Sequencing Overview when sequencing starts.
From here, you will see a progress bar below the flow cell to show the progression of the sequencing script.
In some cases, the device will take a few minutes before starting a sequencing run if an alignment reference file is used. A progress bar will show the progress before sequencing begins.
Flow cell health will be displayed after the first pore scan.
Click on the flow cell to open the quick view and check the number of active pores. The first pore scan should report a similar number of active pores (within 10-15%) to that reported in the flow cell check.
Below are recommended troubleshooting tips if there are unexpected differences in pore numbers:
- If there is a significant reduction in active pores in the first pore scan, restart MinKNOW.
- If the numbers are still significantly different, close down the host computer and reboot.
- When the numbers are similar to those reported at the end of the flow cell check, restart the experiment. There is no need to load any additional library after the restart.
To stop the experiment during sequencing, click "Stop" using the run controls on the experiments page.
This is only necessary if you want to stop your run before the end of the set run time.
Confirm to stop experiment by clicking:
- Stop sequencing which will start catch-up basecalling
- or Stop sequencing and basecalling which will stop both sequencing and basecalling immediately.
Once sequencing is complete, generate a run report.
A run report containing information about the sequencing run and performance graphs can be generated manually by clicking Export run report and selecting which experiment to export to html.
Run reports are automatically generated for Flongle running on MinION Mk1C and MinION Mk1B/Mk1D running on Linux. However, for MinION Mk1B running on Windows or Mac, the run reports need to be manually generated.
For more information about the run report, please see the Run report section of this document.
A pore activity .csv file is also generated for every run.
The report and .csv files are saved to the same folder as the .fast5 and .fastq read files e.g. :\data\experiment\sample_ID\ for MinION Mk1B/Mk1D.
FIN DEL PROCESO
MinKNOW fallback folder
If writing out reads to your specified location fails (e.g. if the disk becomes full, or the connection is disrupted), the experiment will continue, and the reads will be written into a fallback folder:
Windows .POD5 or .fast5 files: C:\data\reads\fallback (with the standard run data name sample ID as a folder) FASTQ files: C:\data\reads\fastq_fallback (with the standard run data name sample ID as a folder)
macOS: .POD5 or .fast5 files: /Library/MinKNOW/data/fallback FASTQ files: /Library/MinKNOW/data/fastq_fallback
Linux: .POD5 or .fast5 files: /var/lib/MinKNOW/data/fallback FASTQ files: /var/lib/MinKNOW/data/fastq_fallback
35. Starting a sequencing run on MinION Mk1B/Mk1D
Click 'Start Sequencing' on the Start page to set up the sequencing parameters for your experiment.
Type in the experiment name, sample ID and choose flow cell type from the drop down menu.
Ensure the experiment name and sample ID does not contain any personally identifiable information.
Note: If sample ID is not filled in, there will be no sample ID in the folder structure.
To use previously saved settings, please see the "Save sequencing run settings" page of this protocol.
Select Continue to move to the Kit Selection page.
Select the kit and expansion(s) used to prepare the library.
One sequencing kit can be selected as well as one or more expansions. If a sequencing kit does not have any associated expansions, no expansion options will appear.
The filter options may be used to find the kit used. For example, click DNA to filter for DNA sequencing kits.
For control runs, there is a Control checkbox which only filters for the control experiments of the kits. This will automatically set the sequencing parameters for a control run. Note: Run length will be reduced to 6 hours for control experiments.
Click Continue to navigate to the run configuration page.
CONSEJO
Default sequencing parameters
Click Continue to proceed to the run configuration page.
Default sequencing parameters will be pre-set.
For the majority of users and applications, we recommend keeping the default sequencing parameters unless you have a specific need to change them.
Experiment overview
At the top of the run configuration page you will see an overview of your experiment set-up and identifiers inlcuding:
- Experiment name: defined by user.
- Positions: Flow cell position(s) being used in the sequencing experiment, and the associated sample IDs for the position(s).
Note: If using multiple flow cells, click "show details" to open a window displaying all the positions used and the associated sample IDs. - Flow cell type: automatically detected by the MinKNOW software.
- Sequencing kit: the sequencing kit used for DNA/RNA library preparation, user-defined.
Choose your basecalling options:
The basecalling option is on by default to perform real-time basecalling. This can be switched off and basecalling performed post-sequencing.
Note: If basecalling is disabled, barcoding and alignment will not be performed during sequencing.
Modified bases is off by default. This can be switched on to use the CpG context models and basecall 5mC and 5hmC.
To specify your basecall model and modified bases, click the Edit icon to open basecalling options dialogue box.
Basecall models
Basecalling models can be selected at two stages in the MinKNOW software:
- Real-time basecalling: A basecalling model can be selected when setting up a sequencing run on the "Run configuration" page of MinKNOW. This enables basecalling of the sequencing run in real-time.
- Post-run basecalling: Basecalling can be set up post-sequencing run on MinKNOW. Instructions can be found in the "Post-run basecalling" section of this protocol.
Dorado is the basecaller server in MinKNOW which provides multiple models for basecalling nanopore data.
There are three options for model selection in the drop down menu:
1. High-accuracy basecalling (HAC) - This is our default recommended basecalling model that provides a high single-molecule accuracy. It is currently 5-8 times more computationally-intensive than the Fast model, so users should ensure their data transfer and device utilisation is scaled appropriately for this.
2. Super-accurate basecalling (SUP) - The Super accurate model has an even higher single-molecule accuracy, and is ~3 times more intensive than the HAC model.
3. Fast basecalling - This model is able to keep up with a high-throughput sequencing experiment on a MinION, GridION or PromethION.
Note: GPU devices will basecall in near real-time; CPU devices, like a standard laptop for MinION Mk1B/Mk1D, will not maintain real-time basecalling.
Choose your barcoding options:
Barcoding options are only available when a barcoding sequencing kit or expansion has been selected. Barcoding can be switched off and performed post-sequencing.
To specify the barcoding options, click the Edit icon to open the barcoding options dialogue box. From here, barcode trimming and custom barcode selection can be defined.
By default, barcoding trimming is off. This can be enabled to remove barcodes from demultiplexed reads. Please note, some primer sequences may also be trimmed together with the barcodes.
By default, custom barcode selection is off. This can be enabled to only select for specified barcodes used in your library preparation for the current sequencing run.
Note: Specifying barcodes must be entered as:
- Individual numbers.
- Numbers separated by commas.
- Range of numbers separated by a dash.
- A combination of numbers and ranges, separated by commas.
Some sequencing kits place barcodes on both ends of the read. By default, the barcode both ends feature is off. If this feature is enabled, the barcode will only classified if a barcode above the minimum barcode score is present at both ends of the basecalled read.
Note: For barcoding to be performed during sequencing, basecalling must be enabled.
Choose your alignment options:
By default, alignment is turned off.
To use alignment during sequencing, upload an alignment reference file as a .fasta or .mmi file. We recommend uploading a reference locally on bacterial-sized genomes. Uploading a file can take a few minutes and is compute-dependent.
A reference file can contain multiple entries in the same file (e.g. multiple chromosomes) and alignment hits from these files are used to populate the alignment graphs which can be viewed on the GUI.
A BED file can also be uploaded alongside the reference when there is a specific interest in a particular region of the reference (e.g. specific gene in a chromosome). Alignment hits from BED files will be highlighted in the sequencing .txt file generated in the data folder. Click Edit options to open a dialogue box to upload a BED file.
BED files will be validated upon upload. If there is an error in the validation of the file, an error message will show linking to a web page with guidance on correcting the validation errors.
Note: For alignment to be performed during sequencing, basecalling must be enabled.
Choose your adaptive sampling options:
By default, alignment is turned off.
Enabling adaptive sampling will allow you to enrich or deplete specific sequences from your aligned sequencing data.
For our barcoding kits, the barcode balancing feature is also available using adaptive sampling through the "beta" features in MinKNOW.
By default, all adaptive sampling reads, whether they are accepted or rejected, will be basecalled. If you would like to only basecall on-target reads and not rejected reads, set the Basecally on-target reads only toggle to On. If you enable raw data generation, rejected reads will still be written out but not basecalled.
More information on this feature can be found in our Adaptive sampling documentation.
MEDIDA OPCIONAL
Advanced User Options
Time between pore scans: The time between pore scans can be altered using this feature.
Reserved pore: The reserve pore feature prioritises consistency and accuracy over immediacy by reserving wells where voltages have dropped until later in the run, such that other wells can catch up. Switch off this feature to fully front-load sequence data acquisition.
Set up the data targets for your experiment:
This feature allows you to set up the rules to define when a sequencing run will stop. If multiple rules are set up, the first rule met will stop the run.
Click the Edit icon to open the options.
Run limit
This rule must be defined based on run time length in hours or when a flow cell is end of life and has no more sequencing pores available.
Use the drop-down menu to choose:
- "Time equals" and hours
- or "Flow cell is" which will automatically be set as "End of life".
Flow cell data target
This rule can be used to define a target amount of data to reach before a sequencing run is stopped. This can be specified for either estimated or basecalled bases and your data target will be available to view on the experiment graphs to allow you to monitor data progress.
Please note, basecalling must keep up with data output in real-time. If the device or basecall model will not keep up and reach the target output before the run limit rule is met, we recommend using the "Estimated bases" option. However, if your experiment will not reach the target data before the end of the experiment as defined by the run limit rule, you will be warned by the UI.
Use drop-down menu to select for "Estimated bases equal" or "Basecalled bases equal" and input the value in either Gb or Mb.
Select the output options:
The output section provides variables for data output including file name, location and format.
Click the Edit icon to open the options.
Output settings:
Data saved as:
Check the name of the output file for the data.
Output location:
Confirm the location for the output data file. Click the file path name to open a pop-up to alter file path or create a new file.
Click Choose location on the pop-up to confirm new file location.
Output location storage capacity:
A bar indicator is displayed below the selected data output file location. This bar will display red when the disk space used reaches more than 80% of the total available disk space. Otherwise, the bar will display green. Below the bar, you can see how much drive space is available.
Basecalled output options:
Confirm output file type and file compression using the checkboxes.
Note: Below, reads per file can be changed for both raw reads and basecalled reads, but take note:
- Fewer reads per file: reads become more quickly available. However, too few reads per file means MinKNOW may not keep up with writing out files in real-time.
- More reads per file: reduces the number of files especially for amplicon/cDNA experiments that produce a large number of reads. Some downstream analysis tools may have an upper limit on the uploaded file size.
Basecalled output type:
Output file type can be selected between .FASTQ or .BAM files. The .FASTQ will be on as default if basecalling in real-time.
File output frequency can be adjusted for basecalled files based on two options:
Based on time elapsed | Based on number of reads |
---|---|
Basecalled files can be produced: · every 1 minute (many small files) · every 10 minutes (many small files) · hourly (fewer larger files) · at the end of the run (single large file). | Basecalled files can be produced for specified read thresholds (number of reads). |
For barcoding runs, basecalled reads are split into files by barcode by default.
Gzip compression of FASTQ files is on by default of basecalled reads. Note: FASTQ Gzip files may prevent some downstream informatics applications.
Raw reads output options:
Raw reads: Raw reads output can be saved as .POD5 or .FAST5.
- For Kit 14 chemistry and SQK-RNA004, .POD5 is the default file output. The .POD5 output generates files hourly.
- The .FAST5 output file is the default format for our previous and "legacy" chemistry kits. The.FAST5 output produces files for every 4000 reads.
.POD5 is a Nanopore-developed file format which stores Nanopore data in a more accessible way and can be used as an alternative to FAST5 output. This output also writes data faster, uses less compute and has smaller raw data file size.
We recommend keeping the default settings.
Raw reads split by barcode: Raw read files generated in the .POD5 format can now be split by barcode (if using one of our barcoding sequencing kits.
Please note, this feature is turned off by default and not available for .FAST5 files.
CONSEJO
Advanced User Options
Option to turn bulk file saving either on or off.
Note: This will result in much larger file sizes due to additional information about the run, which is used for debugging.
Choose the filtering options:
Filtering options can be used to determine which reads are classed into pass or fail files. These options may also be used to determine which predefined reads, read lengths and Qscore during basecalling can be split out in some live graphs.
Click the Edit icon to open the filtering options:
Use the GUI to alter Qscore and to define minimum and maximum readlength for a pass read, if required.
Click 'Start' to run the experiment.
You will be automatically navigated to the Sequencing Overview when sequencing starts.
From here, you will see a progress bar below the flow cell to show the progression of the sequencing script.
In some cases, the device will take a few minutes before starting a sequencing run if an alignment reference file is used. A progress bar will show the progress before sequencing begins.
Flow cell health will be displayed after the first pore scan.
Click on the flow cell to open the quick view and check the number of active pores. The first pore scan should report a similar number of active pores (within 10-15%) to that reported in the flow cell check.
Below are recommended troubleshooting tips if there are unexpected differences in pore numbers:
- If there is a significant reduction in active pores in the first pore scan, restart MinKNOW.
- If the numbers are still significantly different, close down the host computer and reboot.
- When the numbers are similar to those reported at the end of the flow cell check, restart the experiment. There is no need to load any additional library after the restart.
To stop the experiment during sequencing, click "Stop" using the run controls on the experiments page.
This is only necessary if you want to stop your run before the end of the set run time.
Confirm to stop experiment by clicking:
- Stop sequencing which will start catch-up basecalling
- or Stop sequencing and basecalling which will stop both sequencing and basecalling immediately.
Once sequencing is complete, generate a run report.
A run report containing information about the sequencing run and performance graphs can be generated manually by clicking Export run report and selecting which experiment to export to html.
Run reports are automatically generated for MinION Mk1B/Mk1D running on Linux. However, for MinION Mk1B running on Windows or Mac, the run reports need to be manually generated.
For more information about the run report, please see the Run report section of this document.
A pore activity .csv file is also generated for every run.
The report and .csv files are saved to the same folder as the .fast5 and .fastq read files e.g. :\data\experiment\sample_ID\ for MinION Mk1B/Mk1D.
FIN DEL PROCESO
MinKNOW fallback folder
If writing out reads to your specified location fails (e.g. if the disk becomes full, or the connection is disrupted), the experiment will continue, and the reads will be written into a fallback folder:
Windows .POD5 or .fast5 files: C:\data\reads\fallback (with the standard run data name sample ID as a folder) FASTQ files: C:\data\reads\fastq_fallback (with the standard run data name sample ID as a folder)
macOS: .POD5 or .fast5 files: /Library/MinKNOW/data/fallback FASTQ files: /Library/MinKNOW/data/fastq_fallback
Linux: .POD5 or .fast5 files: /var/lib/MinKNOW/data/fallback FASTQ files: /var/lib/MinKNOW/data/fastq_fallback
36. Starting a sequencing run on MinION Mk1C
There are two versions of the MinKNOW GUI on the MinION Mk1C
The MinKNOW GUI on the device:
The version of the Graphical User Interface (GUI) described in this document is the touch-screen configurable GUI.
The MinKNOW GUI via Wi-Fi or Ethernet connection from a laptop:
The GUI presented on the laptop when connected to the MinION Mk1C is the same as MinION Mk1B/Mk1D desktop MinKNOW GUI. See the MinION Mk1C user guide for how to use the Wi-Fi or wired connection from a device to the MinION Mk1C version of the MinKNOW GUI.
Click the 'Start Sequencing' option on the Start homepage to choose the running parameters for your experiment.
Type in experiment name, sample ID and choose flow cell type from the drop down menu.
Ensure the experiment name and sample ID does not contain any personally identifiable information.
Note: If sample ID is not filled in, there will be no sample ID in the folder structure.
To use previously saved settings, please see the "Save sequencing run settings" page of this protocol.
Select Continue to move to the Kit Selection page.
Select the kit and expansion(s) used to prepare the library.
One sequencing kit can be selected as well as one or more expansions. If a sequencing kit does not have any associated expansions, no expansion options will appear.
The filter options may be used to find the kit used. For example, click DNA to filter for DNA sequencing kits.
For control runs, there is a Control checkbox which only filters for the control experiments of the kits. This will automatically set the sequencing parameters for a control run. Note: Run length will be reduced to 6 hours for control experiments.
Click Continue to navigate to the run configuration page.
CONSEJO
Default sequencing parameters
Click Continue to proceed to the run configuration page.
Default sequencing parameters will be pre-set.
For the majority of users and applications, we recommend keeping the default sequencing parameters unless you have a specific need to change them.
Experiment overview
At the top of the run configuration page you will see an overview of your experiment set-up and identifiers inlcuding:
- Experiment name: defined by user.
- Positions: Flow cell position(s) being used in the sequencing experiment, and the associated sample IDs for the position(s).
Note: If using multiple flow cells, click "show details" to open a window displaying all the positions used and the associated sample IDs. - Flow cell type: automatically detected by the MinKNOW software.
- Sequencing kit: the sequencing kit used for DNA/RNA library preparation, user-defined.
Choose your basecalling options:
The basecalling option is on by default to perform real-time basecalling. This can be switched off and basecalling performed post-sequencing.
Note: If basecalling is disabled, barcoding and alignment will not be performed during sequencing.
Modified bases is off by default. This can be switched on to use the CpG context models and basecall 5mC and 5hmC.
To specify your basecall model and modified bases, click the Edit icon to open basecalling options dialogue box.
Basecall models
Basecalling models can be selected at two stages in the MinKNOW software:
- Real-time basecalling: A basecalling model can be selected when setting up a sequencing run on the "Run configuration" page of MinKNOW. This enables basecalling of the sequencing run in real-time.
- Post-run basecalling: Basecalling can be set up post-sequencing run on MinKNOW. Instructions can be found in the "Post-run basecalling" section of this protocol.
Dorado is the basecaller server in MinKNOW which provides multiple models for basecalling nanopore data.
There are three options for model selection in the drop down menu:
1. High-accuracy basecalling (HAC) - This is our default recommended basecalling model that provides a high single-molecule accuracy. It is currently 5-8 times more computationally-intensive than the Fast model, so users should ensure their data transfer and device utilisation is scaled appropriately for this.
2. Super-accurate basecalling (SUP) - The Super accurate model has an even higher single-molecule accuracy, and is ~3 times more intensive than the HAC model.
3. Fast basecalling - This model is able to keep up with a high-throughput sequencing experiment on a MinION, GridION or PromethION.
Note: GPU devices will basecall in near real-time; CPU devices, like a standard laptop for MinION Mk1B/Mk1D, will not maintain real-time basecalling.
Choose your barcoding options:
Barcoding options are only available when a barcoding sequencing kit or expansion has been selected. Barcoding can be switched off and performed post-sequencing.
To specify the barcoding options, click the Edit icon to open the barcoding options dialogue box. From here, barcode trimming and custom barcode selection can be defined.
By default, barcoding trimming is off. This can be enabled to remove barcodes from demultiplexed reads. Please note, some primer sequences may also be trimmed together with the barcodes.
By default, custom barcode selection is off. This can be enabled to only select for specified barcodes used in your library preparation for the current sequencing run.
Note: Specifying barcodes must be entered as:
- Individual numbers.
- Numbers separated by commas.
- Range of numbers separated by a dash.
- A combination of numbers and ranges, separated by commas.
Some sequencing kits place barcodes on both ends of the read. By default, the barcode both ends feature is off. If this feature is enabled, the barcode will only classified if a barcode above the minimum barcode score is present at both ends of the basecalled read.
Note: For barcoding to be performed during sequencing, basecalling must be enabled.
Choose your alignment options:
By default, alignment is turned off.
To use alignment during sequencing, upload an alignment reference file as a .fasta or .mmi file. We recommend uploading a reference locally on bacterial-sized genomes. Uploading a file can take a few minutes and is compute-dependent.
A reference file can contain multiple entries in the same file (e.g. multiple chromosomes) and alignment hits from these files are used to populate the alignment graphs which can be viewed on the GUI.
A BED file can also be uploaded alongside the reference when there is a specific interest in a particular region of the reference (e.g. specific gene in a chromosome). Alignment hits from BED files will be highlighted in the sequencing .txt file generated in the data folder. Click Edit options to open a dialogue box to upload a BED file.
BED files will be validated upon upload. If there is an error in the validation of the file, an error message will show linking to a web page with guidance on correcting the validation errors.
Note: For alignment to be performed during sequencing, basecalling must be enabled.
Choose your adaptive sampling options:
By default, alignment is turned off.
Enabling adaptive sampling will allow you to enrich or deplete specific sequences from your aligned sequencing data.
For our barcoding kits, the barcode balancing feature is also available using adaptive sampling through the "beta" features in MinKNOW.
By default, all adaptive sampling reads, whether they are accepted or rejected, will be basecalled. If you would like to only basecall on-target reads and not rejected reads, set the Basecally on-target reads only toggle to On. If you enable raw data generation, rejected reads will still be written out but not basecalled.
More information on this feature can be found in our Adaptive sampling documentation.
MEDIDA OPCIONAL
Advanced User Options
Time between pore scans: The time between pore scans can be altered using this feature.
Reserved pore: The reserve pore feature prioritises consistency and accuracy over immediacy by reserving wells where voltages have dropped until later in the run, such that other wells can catch up. Switch off this feature to fully front-load sequence data acquisition.
Set up the data targets for your experiment:
This feature allows you to set up the rules to define when a sequencing run will stop. If multiple rules are set up, the first rule met will stop the run.
Click the Edit icon to open the options.
Run limit
This rule must be defined based on run time length in hours or when a flow cell is end of life and has no more sequencing pores available.
Use the drop-down menu to choose:
- "Time equals" and hours
- or "Flow cell is" which will automatically be set as "End of life".
Flow cell data target
This rule can be used to define a target amount of data to reach before a sequencing run is stopped. This can be specified for either estimated or basecalled bases and your data target will be available to view on the experiment graphs to allow you to monitor data progress.
Please note, basecalling must keep up with data output in real-time. If the device or basecall model will not keep up and reach the target output before the run limit rule is met, we recommend using the "Estimated bases" option. However, if your experiment will not reach the target data before the end of the experiment as defined by the run limit rule, you will be warned by the UI.
Use drop-down menu to select for "Estimated bases equal" or "Basecalled bases equal" and input the value in either Gb or Mb.
Select the output options:
The output section provides variables for data output including file name, location and format.
Click the Edit icon to open the options.
Output settings:
Data saved as:
Check the name of the output file for the data.
Output location:
Confirm the location for the output data file. Click the file path name to open a pop-up to alter file path or create a new file.
Click Choose location on the pop-up to confirm new file location.
Output location storage capacity:
A bar indicator is displayed below the selected data output file location. This bar will display red when the disk space used reaches more than 80% of the total available disk space. Otherwise, the bar will display green. Below the bar, you can see how much drive space is available.
Basecalled output options:
Confirm output file type and file compression using the checkboxes.
Note: Below, reads per file can be changed for both raw reads and basecalled reads, but take note:
- Fewer reads per file: reads become more quickly available. However, too few reads per file means MinKNOW may not keep up with writing out files in real-time.
- More reads per file: reduces the number of files especially for amplicon/cDNA experiments that produce a large number of reads. Some downstream analysis tools may have an upper limit on the uploaded file size.
Basecalled output type:
Output file type can be selected between .FASTQ or .BAM files. The .FASTQ will be on as default if basecalling in real-time.
File output frequency can be adjusted for basecalled files based on two options:
Based on time elapsed | Based on number of reads |
---|---|
Basecalled files can be produced: · every 1 minute (many small files) · every 10 minutes (many small files) · hourly (fewer larger files) · at the end of the run (single large file). | Basecalled files can be produced for specified read thresholds (number of reads). |
For barcoding runs, basecalled reads are split into files by barcode by default.
Gzip compression of FASTQ files is on by default of basecalled reads. Note: FASTQ Gzip files may prevent some downstream informatics applications.
Raw reads output options:
Raw reads: Raw reads output can be saved as .POD5 or .FAST5.
- For Kit 14 chemistry and SQK-RNA004, .POD5 is the default file output. The .POD5 output generates files hourly.
- The .FAST5 output file is the default format for our previous and "legacy" chemistry kits. The.FAST5 output produces files for every 4000 reads.
.POD5 is a Nanopore-developed file format which stores Nanopore data in a more accessible way and can be used as an alternative to FAST5 output. This output also writes data faster, uses less compute and has smaller raw data file size.
We recommend keeping the default settings.
Raw reads split by barcode: Raw read files generated in the .POD5 format can now be split by barcode (if using one of our barcoding sequencing kits.
Please note, this feature is turned off by default and not available for .FAST5 files.
CONSEJO
Advanced User Options
Option to turn bulk file saving either on or off.
Note: This will result in much larger file sizes due to additional information about the run, which is used for debugging.
Choose the filtering options:
Filtering options can be used to determine which reads are classed into pass or fail files. These options may also be used to determine which predefined reads, read lengths and Qscore during basecalling can be split out in some live graphs.
Click the Edit icon to open the filtering options:
Use the GUI to alter Qscore and to define minimum and maximum readlength for a pass read, if required.
Click 'Start' to run the experiment.
You will be automatically navigated to the Sequencing Overview when sequencing starts.
From here, you can see a progress bar below the flow cell to show the progression of the sequencing script.
In some cases, the device will take a few minutes before starting a sequencing run if an alignment reference file is used. A progress bar will show the progress before sequencing begins.
Flow cell health will be displayed after the first pore scan.
Click on the flow cell to open the quick view and check the number of active pores. The first pore scan should report a similar number of active pores (within 10-15%) to that reported in the flow cell check.
Below are recommended troubleshooting tips if there are unexpected differences in pore numbers:
- If there is a significant reduction in active pores in the first pore scan, restart MinKNOW.
- If the numbers are still significantly different, close down the host computer and reboot.
- When the numbers are similar to those reported at the end of the flow cell check, restart the experiment. There is no need to load any additional library after the restart.
To stop the experiment, click 'Stop' on the experiments page.
This is only necessary if you want to stop your run before the end of the set run time.
Confirm to stop experiment by clicking:
- Stop sequencing which will start catch-up basecalling
- or Stop sequencing and basecalling which will stop both sequencing and basecalling immediately.
Once sequencing is complete, generate a run report.
A run report containing information about the sequencing run and performance graphs are automatically generated but can be generated manually by clicking Export run report and selecting which experiment to export to html.
For more information about the run report, please see the Run report section of this document.
A pore activity .csv file is also generated for every run.
The report and .csv files are saved to the same folder as the .fast5 and .fastq read files e.g. :\data\experiment\sample_ID\ for MinION Mk1B/Mk1D.
FIN DEL PROCESO
MinKNOW fallback folder
If writing out reads to your specified location fails (e.g. if the disk becomes full, or the connection is disrupted), the experiment will continue, and the reads will be written into a fallback folder:
Windows .POD5 or .fast5 files: C:\data\reads\fallback (with the standard run data name sample ID as a folder) FASTQ files: C:\data\reads\fastq_fallback (with the standard run data name sample ID as a folder)
macOS: .POD5 or .fast5 files: /Library/MinKNOW/data/fallback FASTQ files: /Library/MinKNOW/data/fastq_fallback
Linux: .POD5 or .fast5 files: /var/lib/MinKNOW/data/fallback FASTQ files: /var/lib/MinKNOW/data/fastq_fallback
37. Starting a sequencing run on GridION
Click 'Start Sequencing' on the Start page to set up the sequencing parameters for your experiment.
MEDIDA OPCIONAL
When running multiple flow cells simultaneously, it may be preferred to upload sample names and corresponding flow cell positions from a CSV file, rather than manually.
Please see Sample sheet upload for instructions.
Type in the experiment name and sample ID and choose flow cell type from the drop down menu.
Ensure the experiment name and sample ID does not contain any personally identifiable information.
Note: If sample ID is not filled in, there will be no sample ID in the folder structure.
Select Continue to move to the Kit Selection page.
Select the kit and expansion(s) used to prepare the library.
One sequencing kit can be selected as well as one or more expansions. If a sequencing kit does not have any associated expansions, no expansion options will appear.
The filter options may be used to find the kit used. For example, click DNA to filter for DNA sequencing kits.
For control runs, there is a Control checkbox which only filters for the control experiments of the kits. This will automatically set the sequencing parameters for a control run. Note: Run length will be reduced to 6 hours for control experiments.
Click Continue to navigate to the run configuration page.
CONSEJO
Default sequencing parameters
Click Continue to proceed to the run configuration page.
Default sequencing parameters will be pre-set.
For the majority of users and applications, we recommend keeping the default sequencing parameters unless you have a specific need to change them.
Experiment overview
At the top of the run configuration page you will see an overview of your experiment set-up and identifiers inlcuding:
- Experiment name: defined by user.
- Positions: Flow cell position(s) being used in the sequencing experiment, and the associated sample IDs for the position(s).
Note: If using multiple flow cells, click "show details" to open a window displaying all the positions used and the associated sample IDs. - Flow cell type: automatically detected by the MinKNOW software.
- Sequencing kit: the sequencing kit used for DNA/RNA library preparation, user-defined.
Choose your basecalling options:
The basecalling option is on by default to perform real-time basecalling. This can be switched off and basecalling performed post-sequencing.
Note: If basecalling is disabled, barcoding and alignment will not be performed during sequencing.
Modified bases is off by default. This can be switched on to use the CpG context models and basecall 5mC and 5hmC.
To specify your basecall model and modified bases, click the Edit icon to open basecalling options dialogue box.
Basecall models
Basecalling models can be selected at two stages in the MinKNOW software:
- Real-time basecalling: A basecalling model can be selected when setting up a sequencing run on the "Run configuration" page of MinKNOW. This enables basecalling of the sequencing run in real-time.
- Post-run basecalling: Basecalling can be set up post-sequencing run on MinKNOW. Instructions can be found in the "Post-run basecalling" section of this protocol.
Dorado is the basecaller server in MinKNOW which provides multiple models for basecalling nanopore data.
There are three options for model selection in the drop down menu:
1. High-accuracy basecalling (HAC) - This is our default recommended basecalling model that provides a high single-molecule accuracy. It is currently 5-8 times more computationally-intensive than the Fast model, so users should ensure their data transfer and device utilisation is scaled appropriately for this.
2. Super-accurate basecalling (SUP) - The Super accurate model has an even higher single-molecule accuracy, and is ~3 times more intensive than the HAC model.
3. Fast basecalling - This model is able to keep up with a high-throughput sequencing experiment on a MinION, GridION or PromethION.
Note: GPU devices will basecall in near real-time; CPU devices, like a standard laptop for MinION Mk1B/Mk1D, will not maintain real-time basecalling.
Choose your barcoding options:
Barcoding options are only available when a barcoding sequencing kit or expansion has been selected. Barcoding can be switched off and performed post-sequencing.
To specify the barcoding options, click the Edit icon to open the barcoding options dialogue box. From here, barcode trimming and custom barcode selection can be defined.
By default, barcoding trimming is off. This can be enabled to remove barcodes from demultiplexed reads. Please note, some primer sequences may also be trimmed together with the barcodes.
By default, custom barcode selection is off. This can be enabled to only select for specified barcodes used in your library preparation for the current sequencing run.
Note: Specifying barcodes must be entered as:
- Individual numbers.
- Numbers separated by commas.
- Range of numbers separated by a dash.
- A combination of numbers and ranges, separated by commas.
Some sequencing kits place barcodes on both ends of the read. By default, the barcode both ends feature is off. If this feature is enabled, the barcode will only classified if a barcode above the minimum barcode score is present at both ends of the basecalled read.
Note: For barcoding to be performed during sequencing, basecalling must be enabled.
Choose your alignment options:
By default, alignment is turned off.
To use alignment during sequencing, upload an alignment reference file as a .fasta or .mmi file. We recommend uploading a reference locally on bacterial-sized genomes. Uploading a file can take a few minutes and is compute-dependent.
A reference file can contain multiple entries in the same file (e.g. multiple chromosomes) and alignment hits from these files are used to populate the alignment graphs which can be viewed on the GUI.
A BED file can also be uploaded alongside the reference when there is a specific interest in a particular region of the reference (e.g. specific gene in a chromosome). Alignment hits from BED files will be highlighted in the sequencing .txt file generated in the data folder. Click Edit options to open a dialogue box to upload a BED file.
BED files will be validated upon upload. If there is an error in the validation of the file, an error message will show linking to a web page with guidance on correcting the validation errors.
Note: For alignment to be performed during sequencing, basecalling must be enabled.
Choose your adaptive sampling options:
By default, alignment is turned off.
Enabling adaptive sampling will allow you to enrich or deplete specific sequences from your aligned sequencing data.
For our barcoding kits, the barcode balancing feature is also available using adaptive sampling through the "beta" features in MinKNOW.
By default, all adaptive sampling reads, whether they are accepted or rejected, will be basecalled. If you would like to only basecall on-target reads and not rejected reads, set the Basecally on-target reads only toggle to On. If you enable raw data generation, rejected reads will still be written out but not basecalled.
More information on this feature can be found in our Adaptive sampling documentation.
MEDIDA OPCIONAL
Advanced User Options
Time between pore scans: The time between pore scans can be altered using this feature.
Reserved pore: The reserve pore feature prioritises consistency and accuracy over immediacy by reserving wells where voltages have dropped until later in the run, such that other wells can catch up. Switch off this feature to fully front-load sequence data acquisition.
Set up the data targets for your experiment:
This feature allows you to set up the rules to define when a sequencing run will stop. If multiple rules are set up, the first rule met will stop the run.
Click the Edit icon to open the options.
Run limit
This rule must be defined based on run time length in hours or when a flow cell is end of life and has no more sequencing pores available.
Use the drop-down menu to choose:
- "Time equals" and hours
- or "Flow cell is" which will automatically be set as "End of life".
Flow cell data target
This rule can be used to define a target amount of data to reach before a sequencing run is stopped. This can be specified for either estimated or basecalled bases and your data target will be available to view on the experiment graphs to allow you to monitor data progress.
Please note, basecalling must keep up with data output in real-time. If the device or basecall model will not keep up and reach the target output before the run limit rule is met, we recommend using the "Estimated bases" option. However, if your experiment will not reach the target data before the end of the experiment as defined by the run limit rule, you will be warned by the UI.
Use drop-down menu to select for "Estimated bases equal" or "Basecalled bases equal" and input the value in either Gb or Mb.
Select the output options:
The output section provides variables for data output including file name, location and format.
Click the Edit icon to open the options.
Output settings:
Data saved as:
Check the name of the output file for the data.
Output location:
Confirm the location for the output data file. Click the file path name to open a pop-up to alter file path or create a new file.
Click Choose location on the pop-up to confirm new file location.
Output location storage capacity:
A bar indicator is displayed below the selected data output file location. This bar will display red when the disk space used reaches more than 80% of the total available disk space. Otherwise, the bar will display green. Below the bar, you can see how much drive space is available.
Basecalled output options:
Confirm output file type and file compression using the checkboxes.
Note: Below, reads per file can be changed for both raw reads and basecalled reads, but take note:
- Fewer reads per file: reads become more quickly available. However, too few reads per file means MinKNOW may not keep up with writing out files in real-time.
- More reads per file: reduces the number of files especially for amplicon/cDNA experiments that produce a large number of reads. Some downstream analysis tools may have an upper limit on the uploaded file size.
Basecalled output type:
Output file type can be selected between .FASTQ or .BAM files. The .FASTQ will be on as default if basecalling in real-time.
File output frequency can be adjusted for basecalled files based on two options:
Based on time elapsed | Based on number of reads |
---|---|
Basecalled files can be produced: · every 1 minute (many small files) · every 10 minutes (many small files) · hourly (fewer larger files) · at the end of the run (single large file). | Basecalled files can be produced for specified read thresholds (number of reads). |
For barcoding runs, basecalled reads are split into files by barcode by default.
Gzip compression of FASTQ files is on by default of basecalled reads. Note: FASTQ Gzip files may prevent some downstream informatics applications.
Raw reads output options:
Raw reads: Raw reads output can be saved as .POD5 or .FAST5.
- For Kit 14 chemistry and SQK-RNA004, .POD5 is the default file output. The .POD5 output generates files hourly.
- The .FAST5 output file is the default format for our previous and "legacy" chemistry kits. The.FAST5 output produces files for every 4000 reads.
.POD5 is a Nanopore-developed file format which stores Nanopore data in a more accessible way and can be used as an alternative to FAST5 output. This output also writes data faster, uses less compute and has smaller raw data file size.
We recommend keeping the default settings.
Raw reads split by barcode: Raw read files generated in the .POD5 format can now be split by barcode (if using one of our barcoding sequencing kits.
Please note, this feature is turned off by default and not available for .FAST5 files.
CONSEJO
Advanced User Options
Option to turn bulk file saving either on or off.
Note: This will result in much larger file sizes due to additional information about the run, which is used for debugging.
Choose the filtering options:
Filtering options can be used to determine which reads are classed into pass or fail files. These options may also be used to determine which predefined reads, read lengths and Qscore during basecalling can be split out in some live graphs.
Click the Edit icon to open the filtering options:
Use the GUI to alter Qscore and to define minimum and maximum readlength for a pass read, if required.
Click 'Start' to run the experiment.
You will be automatically navigated to the Sequencing Overview when sequencing starts.
From here, you can see a progress bar below the flow cell to show the progression of the sequencing script.
In some cases, the device will take a few minutes before starting a sequencing run if an alignment reference file is used. A progress bar will show the progress before sequencing begins.
Flow cell health will be displayed after the first pore scan.
Click on the flow cell to open the quick view and check the number of active pores. The first pore scan should report a similar number of active pores (within 10-15%) to that reported in the flow cell check.
Below are recommended troubleshooting tips if there are unexpected differences in pore numbers:
- If there is a significant reduction in active pores in the first pore scan, restart MinKNOW.
- If the numbers are still significantly different, close down the host computer and reboot.
- When the numbers are similar to those reported at the end of the flow cell check, restart the experiment. There is no need to load any additional library after the restart.
To stop the experiment during sequencing, click "Stop" using the run controls on the experiments page.
This is only necessary if you want to stop your run before the end of the set run time.
Confirm to stop experiment by clicking:
- Stop sequencing which will start catch-up basecalling
- or Stop sequencing and basecalling which will stop both sequencing and basecalling immediately.
Once sequencing is complete, generate a run report.
A run report containing information about the sequencing run and performance graphs are automatically generated. To manually generate a run report, click Export run report and selecting which experiment to export to html.
For more information about the run report, please see the Run report section of this document.
A pore activity .csv file is also generated for every run.
The report and .csv files are saved to the same folder as the .fast5 and .fastq read files e.g. :\data\experiment\sample_ID\ for MinION Mk1B.
FIN DEL PROCESO
MinKNOW fallback folder
If writing out reads to your specified location fails (e.g. if the disk becomes full, or the connection is disrupted), the experiment will continue, and the reads will be written into a fallback folder:
Windows .POD5 or .fast5 files: C:\data\reads\fallback (with the standard run data name sample ID as a folder) FASTQ files: C:\data\reads\fastq_fallback (with the standard run data name sample ID as a folder)
macOS: .POD5 or .fast5 files: /Library/MinKNOW/data/fallback FASTQ files: /Library/MinKNOW/data/fastq_fallback
Linux: .POD5 or .fast5 files: /var/lib/MinKNOW/data/fallback FASTQ files: /var/lib/MinKNOW/data/fastq_fallback
38. Starting a sequencing run on PromethION 24 and 48
Click 'Start Sequencing' on the Start page to set up the sequencing parameters for your experiment.
MEDIDA OPCIONAL
When running multiple flow cells simultaneously, it may be preferred to upload sample names and corresponding flow cell positions from a CSV file, rather than manually.
Please see Sample sheet upload for instructions.
Type in the experiment name, sample ID and choose flow cell type from the drop down menu.
Select Continue to move to the Kit Selection page.
Ensure the experiment name and sample ID does not contain any personally identifiable information.
To use previously saved settings, please see the "Save sequencing run settings" page of this protocol.
Use "Select all available" to select all the connected flow cells or use the diagram above to select specific flow cells for an experiment.
Note: If sample ID is not filled in, there will be no sample ID in the folder structure.
Select the kit and expansion(s) used to prepare the library.
One sequencing kit can be selected as well as one or more expansions. If a sequencing kit does not have any associated expansions, no expansion options will appear.
The filter options may be used to find the kit used. For example, click DNA to filter for DNA sequencing kits.
For control runs, there is a Control checkbox which only filters for the control experiments of the kits. This will automatically set the sequencing parameters for a control run. Note: Run length will be reduced to 6 hours for control experiments.
Click Continue to navigate to the run configuration page.
CONSEJO
Default sequencing parameters
Click Continue to proceed to the run configuration page.
Default sequencing parameters will be pre-set.
For the majority of users and applications, we recommend keeping the default sequencing parameters unless you have a specific need to change them.
Experiment overview
At the top of the run configuration page you will see an overview of your experiment set-up and identifiers inlcuding:
- Experiment name: defined by user.
- Positions: Flow cell position(s) being used in the sequencing experiment, and the associated sample IDs for the position(s).
Note: If using multiple flow cells, click "show details" to open a window displaying all the positions used and the associated sample IDs. - Flow cell type: automatically detected by the MinKNOW software.
- Sequencing kit: the sequencing kit used for DNA/RNA library preparation, user-defined.
Choose your basecalling options:
The basecalling option is on by default to perform real-time basecalling. This can be switched off and basecalling performed post-sequencing.
Note: If basecalling is disabled, barcoding and alignment will not be performed during sequencing.
Modified bases is off by default. This can be switched on to use the CpG context models and basecall 5mC and 5hmC.
To specify your basecall model and modified bases, click the Edit icon to open basecalling options dialogue box.
Basecall models
Basecalling models can be selected at two stages in the MinKNOW software:
- Real-time basecalling: A basecalling model can be selected when setting up a sequencing run on the "Run configuration" page of MinKNOW. This enables basecalling of the sequencing run in real-time.
- Post-run basecalling: Basecalling can be set up post-sequencing run on MinKNOW. Instructions can be found in the "Post-run basecalling" section of this protocol.
Dorado is the basecaller server in MinKNOW which provides multiple models for basecalling nanopore data.
There are three options for model selection in the drop down menu:
1. High-accuracy basecalling (HAC) - This is our default recommended basecalling model that provides a high single-molecule accuracy. It is currently 5-8 times more computationally-intensive than the Fast model, so users should ensure their data transfer and device utilisation is scaled appropriately for this.
2. Super-accurate basecalling (SUP) - The Super accurate model has an even higher single-molecule accuracy, and is ~3 times more intensive than the HAC model.
3. Fast basecalling - This model is able to keep up with a high-throughput sequencing experiment on a MinION, GridION or PromethION.
Note: GPU devices will basecall in near real-time; CPU devices, like a standard laptop for MinION Mk1B/Mk1D, will not maintain real-time basecalling.
Choose your barcoding options:
Barcoding options are only available when a barcoding sequencing kit or expansion has been selected. Barcoding can be switched off and performed post-sequencing.
To specify the barcoding options, click the Edit icon to open the barcoding options dialogue box. From here, barcode trimming and custom barcode selection can be defined.
By default, barcoding trimming is off. This can be enabled to remove barcodes from demultiplexed reads. Please note, some primer sequences may also be trimmed together with the barcodes.
By default, custom barcode selection is off. This can be enabled to only select for specified barcodes used in your library preparation for the current sequencing run.
Note: Specifying barcodes must be entered as:
- Individual numbers.
- Numbers separated by commas.
- Range of numbers separated by a dash.
- A combination of numbers and ranges, separated by commas.
Some sequencing kits place barcodes on both ends of the read. By default, the barcode both ends feature is off. If this feature is enabled, the barcode will only classified if a barcode above the minimum barcode score is present at both ends of the basecalled read.
Note: For barcoding to be performed during sequencing, basecalling must be enabled.
Choose your alignment options:
By default, alignment is turned off.
To use alignment during sequencing, upload an alignment reference file as a .fasta or .mmi file. We recommend uploading a reference locally on bacterial-sized genomes. Uploading a file can take a few minutes and is compute-dependent.
A reference file can contain multiple entries in the same file (e.g. multiple chromosomes) and alignment hits from these files are used to populate the alignment graphs which can be viewed on the GUI.
A BED file can also be uploaded alongside the reference when there is a specific interest in a particular region of the reference (e.g. specific gene in a chromosome). Alignment hits from BED files will be highlighted in the sequencing .txt file generated in the data folder. Click Edit options to open a dialogue box to upload a BED file.
BED files will be validated upon upload. If there is an error in the validation of the file, an error message will show linking to a web page with guidance on correcting the validation errors.
Note: For alignment to be performed during sequencing, basecalling must be enabled.
Choose your adaptive sampling options:
By default, alignment is turned off.
Enabling adaptive sampling will allow you to enrich or deplete specific sequences from your aligned sequencing data.
For our barcoding kits, the barcode balancing feature is also available using adaptive sampling through the "beta" features in MinKNOW.
By default, all adaptive sampling reads, whether they are accepted or rejected, will be basecalled. If you would like to only basecall on-target reads and not rejected reads, set the Basecally on-target reads only toggle to On. If you enable raw data generation, rejected reads will still be written out but not basecalled.
More information on this feature can be found in our Adaptive sampling documentation.
MEDIDA OPCIONAL
Advanced User Options
Time between pore scans: The time between pore scans can be altered using this feature.
Reserved pore: The reserve pore feature prioritises consistency and accuracy over immediacy by reserving wells where voltages have dropped until later in the run, such that other wells can catch up. Switch off this feature to fully front-load sequence data acquisition.
Set up the data targets for your experiment:
This feature allows you to set up the rules to define when a sequencing run will stop. If multiple rules are set up, the first rule met will stop the run.
Click the Edit icon to open the options.
Run limit
This rule must be defined based on run time length in hours or when a flow cell is end of life and has no more sequencing pores available.
Use the drop-down menu to choose:
- "Time equals" and hours
- or "Flow cell is" which will automatically be set as "End of life".
Flow cell data target
This rule can be used to define a target amount of data to reach before a sequencing run is stopped. This can be specified for either estimated or basecalled bases and your data target will be available to view on the experiment graphs to allow you to monitor data progress.
Please note, basecalling must keep up with data output in real-time. If the device or basecall model will not keep up and reach the target output before the run limit rule is met, we recommend using the "Estimated bases" option. However, if your experiment will not reach the target data before the end of the experiment as defined by the run limit rule, you will be warned by the UI.
Use drop-down menu to select for "Estimated bases equal" or "Basecalled bases equal" and input the value in either Gb or Mb.
Choose your analysis workflow options:
By default, the analysis workflow option is turned off.
To enable this feature, switch the Workflow toggle on. Select a workflow to add to your experiment and click 'Select workflow' to continue.
From the Review workflow settings window, you can select from the Workflow options and import Human genome reference files. To use the Methylation sub-workflow, Modified base calls must be enabled.
Input options are limited in comparison to the EPI2ME desktop application. The desktop version should be used to access advanced options. It is recommended that only one workflow is run at a time. The workflow outputs a VCF file which will be saved to the experiment directory. When the workflow is complete, a link to the workflow report will appear in the MinKNOW experiments page.
Select the output options:
The output section provides variables for data output including file name, location and format.
Click the Edit icon to open the options.
Output settings:
Data saved as:
Check the name of the output file for the data.
Output location:
Confirm the location for the output data file. Click the file path name to open a pop-up to alter file path or create a new file.
Click Choose location on the pop-up to confirm new file location.
Output location storage capacity:
A bar indicator is displayed below the selected data output file location. This bar will display red when the disk space used reaches more than 80% of the total available disk space. Otherwise, the bar will display green. Below the bar, you can see how much drive space is available.
Basecalled output options:
Confirm output file type and file compression using the checkboxes.
Note: Below, reads per file can be changed for both raw reads and basecalled reads, but take note:
- Fewer reads per file: reads become more quickly available. However, too few reads per file means MinKNOW may not keep up with writing out files in real-time.
- More reads per file: reduces the number of files especially for amplicon/cDNA experiments that produce a large number of reads. Some downstream analysis tools may have an upper limit on the uploaded file size.
Basecalled output type:
Output file type can be selected between .FASTQ or .BAM files. The .FASTQ will be on as default if basecalling in real-time.
File output frequency can be adjusted for basecalled files based on two options:
Based on time elapsed | Based on number of reads |
---|---|
Basecalled files can be produced: · every 1 minute (many small files) · every 10 minutes (many small files) · hourly (fewer larger files) · at the end of the run (single large file). | Basecalled files can be produced for specified read thresholds (number of reads). |
For barcoding runs, basecalled reads are split into files by barcode by default.
Gzip compression of FASTQ files is on by default of basecalled reads. Note: FASTQ Gzip files may prevent some downstream informatics applications.
Raw reads output options:
Raw reads: Raw reads output can be saved as .POD5 or .FAST5.
- For Kit 14 chemistry and SQK-RNA004, .POD5 is the default file output. The .POD5 output generates files hourly.
- The .FAST5 output file is the default format for our previous and "legacy" chemistry kits. The.FAST5 output produces files for every 4000 reads.
.POD5 is a Nanopore-developed file format which stores Nanopore data in a more accessible way and can be used as an alternative to FAST5 output. This output also writes data faster, uses less compute and has smaller raw data file size.
We recommend keeping the default settings.
Raw reads split by barcode: Raw read files generated in the .POD5 format can now be split by barcode (if using one of our barcoding sequencing kits.
Please note, this feature is turned off by default and not available for .FAST5 files.
CONSEJO
Advanced User Options
Option to turn bulk file saving either on or off.
Note: This will result in much larger file sizes due to additional information about the run, which is used for debugging.
Choose the filtering options:
Filtering options can be used to determine which reads are classed into pass or fail files. These options may also be used to determine which predefined reads, read lengths and Qscore during basecalling can be split out in some live graphs.
Click the Edit icon to open the filtering options:
Use the GUI to alter Qscore and to define minimum and maximum readlength for a pass read, if required.
Click 'Start' to run the experiment.
You will be automatically navigated to the Sequencing Overview when sequencing starts.
From here, you can see a progress bar below each flow cell to show progression of the sequencing script.
In some cases, the device will take a few minutes before starting a sequencing run if an alignment reference file is used. A progress bar will show the progress before sequencing begins.
Flow cell health will be displayed after the first channel scan.
Click on the flow cell to open the quick view and check the number of active pores. The first pore scan should report a similar number of active pores (within 10-15%) to that reported in the flow cell check.
Below are recommended troubleshooting tips if there are unexpected differences in pore numbers:
- If there is a significant reduction in active pores in the first pore scan, restart MinKNOW.
- If the numbers are still significantly different, close down the host computer and reboot.
- When the numbers are similar to those reported at the end of the flow cell check, restart the experiment. There is no need to load any additional library after the restart.
To stop the experiment during sequencing, click "Stop" using the run controls on the experiments page.
This is only necessary if you want to stop your run before the end of the set run time.
Confirm to stop experiment by clicking:
- Stop sequencing which will start catch-up basecalling
- or Stop sequencing and basecalling which will stop both sequencing and basecalling immediately.
Once sequencing is complete, generate a run report.
A run report containing information about the sequencing run and performance graphs are automatically generated but can be generated manually by clicking Export run report and selecting which experiment to export to html.
For more information about the run report, please see the Run report section of this document.
A pore activity .csv file is also generated for every run.
The report and .csv files are saved to the same folder as the .fast5 and .fastq read files e.g. :\data\experiment\sample_ID\ for MinION Mk1B.
FIN DEL PROCESO
MinKNOW fallback folder
If writing out reads to your specified location fails (e.g. if the disk becomes full, or the connection is disrupted), the experiment will continue, and the reads will be written into a fallback folder:
Windows .POD5 or .fast5 files: C:\data\reads\fallback (with the standard run data name sample ID as a folder) FASTQ files: C:\data\reads\fastq_fallback (with the standard run data name sample ID as a folder)
macOS: .POD5 or .fast5 files: /Library/MinKNOW/data/fallback FASTQ files: /Library/MinKNOW/data/fastq_fallback
Linux: .POD5 or .fast5 files: /var/lib/MinKNOW/data/fallback FASTQ files: /var/lib/MinKNOW/data/fastq_fallback
39. Starting a sequencing run on PromethION 2 Solo
Click 'Start Sequencing' on the Start page to set up the sequencing parameters for your experiment.
MEDIDA OPCIONAL
When running multiple flow cells simultaneously, it may be preferred to upload sample names and corresponding flow cell positions from a CSV file, rather than manually.
Please see Sample sheet upload for instructions.
Type in the experiment name, sample ID and choose flow cell type from the drop down menu.
Select Continue to move to the Kit Selection page.
Ensure the experiment name and sample ID does not contain any personally identifiable information.
To use previously saved settings, please see the "Save sequencing run settings" page of this protocol.
Use "Select all available" to select all the connected flow cells or use the diagram above to select specific flow cells for an experiment.
Note: If sample ID is not filled in, there will be no sample ID in the folder structure.
Select the kit and expansion(s) used to prepare the library.
One sequencing kit can be selected as well as one or more expansions. If a sequencing kit does not have any associated expansions, no expansion options will appear.
The filter options may be used to find the kit used. For example, click DNA to filter for DNA sequencing kits.
For control runs, there is a Control checkbox which only filters for the control experiments of the kits. This will automatically set the sequencing parameters for a control run. Note: Run length will be reduced to 6 hours for control experiments.
Click Continue to navigate to the run configuration page.
CONSEJO
Default sequencing parameters
Click Continue to proceed to the run configuration page.
Default sequencing parameters will be pre-set.
For the majority of users and applications, we recommend keeping the default sequencing parameters unless you have a specific need to change them.
Experiment overview
At the top of the run configuration page you will see an overview of your experiment set-up and identifiers inlcuding:
- Experiment name: defined by user.
- Positions: Flow cell position(s) being used in the sequencing experiment, and the associated sample IDs for the position(s).
Note: If using multiple flow cells, click "show details" to open a window displaying all the positions used and the associated sample IDs. - Flow cell type: automatically detected by the MinKNOW software.
- Sequencing kit: the sequencing kit used for DNA/RNA library preparation, user-defined.
Choose your basecalling options:
The basecalling option is on by default to perform real-time basecalling. This can be switched off and basecalling performed post-sequencing.
Note: If basecalling is disabled, barcoding and alignment will not be performed during sequencing.
Modified bases is off by default. This can be switched on to use the CpG context models and basecall 5mC and 5hmC.
To specify your basecall model and modified bases, click the Edit icon to open basecalling options dialogue box.
Basecall models
Basecalling models can be selected at two stages in the MinKNOW software:
- Real-time basecalling: A basecalling model can be selected when setting up a sequencing run on the "Run configuration" page of MinKNOW. This enables basecalling of the sequencing run in real-time.
- Post-run basecalling: Basecalling can be set up post-sequencing run on MinKNOW. Instructions can be found in the "Post-run basecalling" section of this protocol.
Dorado is the basecaller server in MinKNOW which provides multiple models for basecalling nanopore data.
There are three options for model selection in the drop down menu:
1. High-accuracy basecalling (HAC) - This is our default recommended basecalling model that provides a high single-molecule accuracy. It is currently 5-8 times more computationally-intensive than the Fast model, so users should ensure their data transfer and device utilisation is scaled appropriately for this.
2. Super-accurate basecalling (SUP) - The Super accurate model has an even higher single-molecule accuracy, and is ~3 times more intensive than the HAC model.
3. Fast basecalling - This model is able to keep up with a high-throughput sequencing experiment on a MinION, GridION or PromethION.
Note: GPU devices will basecall in near real-time; CPU devices, like a standard laptop for MinION Mk1B/Mk1D, will not maintain real-time basecalling.
Choose your barcoding options:
Barcoding options are only available when a barcoding sequencing kit or expansion has been selected. Barcoding can be switched off and performed post-sequencing.
To specify the barcoding options, click the Edit icon to open the barcoding options dialogue box. From here, barcode trimming and custom barcode selection can be defined.
By default, barcoding trimming is off. This can be enabled to remove barcodes from demultiplexed reads. Please note, some primer sequences may also be trimmed together with the barcodes.
By default, custom barcode selection is off. This can be enabled to only select for specified barcodes used in your library preparation for the current sequencing run.
Note: Specifying barcodes must be entered as:
- Individual numbers.
- Numbers separated by commas.
- Range of numbers separated by a dash.
- A combination of numbers and ranges, separated by commas.
Some sequencing kits place barcodes on both ends of the read. By default, the barcode both ends feature is off. If this feature is enabled, the barcode will only classified if a barcode above the minimum barcode score is present at both ends of the basecalled read.
Note: For barcoding to be performed during sequencing, basecalling must be enabled.
Choose your alignment options:
By default, alignment is turned off.
To use alignment during sequencing, upload an alignment reference file as a .fasta or .mmi file. We recommend uploading a reference locally on bacterial-sized genomes. Uploading a file can take a few minutes and is compute-dependent.
A reference file can contain multiple entries in the same file (e.g. multiple chromosomes) and alignment hits from these files are used to populate the alignment graphs which can be viewed on the GUI.
A BED file can also be uploaded alongside the reference when there is a specific interest in a particular region of the reference (e.g. specific gene in a chromosome). Alignment hits from BED files will be highlighted in the sequencing .txt file generated in the data folder. Click Edit options to open a dialogue box to upload a BED file.
BED files will be validated upon upload. If there is an error in the validation of the file, an error message will show linking to a web page with guidance on correcting the validation errors.
Note: For alignment to be performed during sequencing, basecalling must be enabled.
Choose your adaptive sampling options:
By default, alignment is turned off.
Enabling adaptive sampling will allow you to enrich or deplete specific sequences from your aligned sequencing data.
For our barcoding kits, the barcode balancing feature is also available using adaptive sampling through the "beta" features in MinKNOW.
By default, all adaptive sampling reads, whether they are accepted or rejected, will be basecalled. If you would like to only basecall on-target reads and not rejected reads, set the Basecally on-target reads only toggle to On. If you enable raw data generation, rejected reads will still be written out but not basecalled.
More information on this feature can be found in our Adaptive sampling documentation.
MEDIDA OPCIONAL
Advanced User Options
Time between pore scans: The time between pore scans can be altered using this feature.
Reserved pore: The reserve pore feature prioritises consistency and accuracy over immediacy by reserving wells where voltages have dropped until later in the run, such that other wells can catch up. Switch off this feature to fully front-load sequence data acquisition.
Set up the data targets for your experiment:
This feature allows you to set up the rules to define when a sequencing run will stop. If multiple rules are set up, the first rule met will stop the run.
Click the Edit icon to open the options.
Run limit
This rule must be defined based on run time length in hours or when a flow cell is end of life and has no more sequencing pores available.
Use the drop-down menu to choose:
- "Time equals" and hours
- or "Flow cell is" which will automatically be set as "End of life".
Flow cell data target
This rule can be used to define a target amount of data to reach before a sequencing run is stopped. This can be specified for either estimated or basecalled bases and your data target will be available to view on the experiment graphs to allow you to monitor data progress.
Please note, basecalling must keep up with data output in real-time. If the device or basecall model will not keep up and reach the target output before the run limit rule is met, we recommend using the "Estimated bases" option. However, if your experiment will not reach the target data before the end of the experiment as defined by the run limit rule, you will be warned by the UI.
Use drop-down menu to select for "Estimated bases equal" or "Basecalled bases equal" and input the value in either Gb or Mb.
Select the output options:
The output section provides variables for data output including file name, location and format.
Click the Edit icon to open the options.
Output settings:
Data saved as:
Check the name of the output file for the data.
Output location:
Confirm the location for the output data file. Click the file path name to open a pop-up to alter file path or create a new file.
Click Choose location on the pop-up to confirm new file location.
Output location storage capacity:
A bar indicator is displayed below the selected data output file location. This bar will display red when the disk space used reaches more than 80% of the total available disk space. Otherwise, the bar will display green. Below the bar, you can see how much drive space is available.
Basecalled output options:
Confirm output file type and file compression using the checkboxes.
Note: Below, reads per file can be changed for both raw reads and basecalled reads, but take note:
- Fewer reads per file: reads become more quickly available. However, too few reads per file means MinKNOW may not keep up with writing out files in real-time.
- More reads per file: reduces the number of files especially for amplicon/cDNA experiments that produce a large number of reads. Some downstream analysis tools may have an upper limit on the uploaded file size.
Basecalled output type:
Output file type can be selected between .FASTQ or .BAM files. The .FASTQ will be on as default if basecalling in real-time.
File output frequency can be adjusted for basecalled files based on two options:
Based on time elapsed | Based on number of reads |
---|---|
Basecalled files can be produced: · every 1 minute (many small files) · every 10 minutes (many small files) · hourly (fewer larger files) · at the end of the run (single large file). | Basecalled files can be produced for specified read thresholds (number of reads). |
For barcoding runs, basecalled reads are split into files by barcode by default.
Gzip compression of FASTQ files is on by default of basecalled reads. Note: FASTQ Gzip files may prevent some downstream informatics applications.
Raw reads output options:
Raw reads: Raw reads output can be saved as .POD5 or .FAST5.
- For Kit 14 chemistry and SQK-RNA004, .POD5 is the default file output. The .POD5 output generates files hourly.
- The .FAST5 output file is the default format for our previous and "legacy" chemistry kits. The.FAST5 output produces files for every 4000 reads.
.POD5 is a Nanopore-developed file format which stores Nanopore data in a more accessible way and can be used as an alternative to FAST5 output. This output also writes data faster, uses less compute and has smaller raw data file size.
We recommend keeping the default settings.
Raw reads split by barcode: Raw read files generated in the .POD5 format can now be split by barcode (if using one of our barcoding sequencing kits.
Please note, this feature is turned off by default and not available for .FAST5 files.
CONSEJO
Advanced User Options
Option to turn bulk file saving either on or off.
Note: This will result in much larger file sizes due to additional information about the run, which is used for debugging.
Choose the filtering options:
Filtering options can be used to determine which reads are classed into pass or fail files. These options may also be used to determine which predefined reads, read lengths and Qscore during basecalling can be split out in some live graphs.
Click the Edit icon to open the filtering options:
Use the GUI to alter Qscore and to define minimum and maximum readlength for a pass read, if required.
Click 'Start' to run the experiment.
You will be automatically navigated to the Sequencing Overview when sequencing starts.
From here, you can see a progress bar below the flow cell to show the progression of the sequencing script.
In some cases, the device will take a few minutes before starting a sequencing run if an alignment reference file is used. A progress bar will show the progress before sequencing begins.
Flow cell health will be displayed after the first pore scan.
Click on the flow cell to open the quick view and check the number of active pores. The first pore scan should report a similar number of active pores (within 10-15%) to that reported in the flow cell check.
Below are recommended troubleshooting tips if there are unexpected differences in pore numbers:
- If there is a significant reduction in active pores in the first pore scan, restart MinKNOW.
- If the numbers are still significantly different, close down the host computer and reboot.
- When the numbers are similar to those reported at the end of the flow cell check, restart the experiment. There is no need to load any additional library after the restart.
To stop the experiment during sequencing, click "Stop" using the run controls on the experiments page.
This is only necessary if you want to stop your run before the end of the set run time.
Confirm to stop experiment by clicking:
- Stop sequencing which will start catch-up basecalling
- or Stop sequencing and basecalling which will stop both sequencing and basecalling immediately.
Once sequencing is complete, generate a run report.
A run report containing information about the sequencing run and performance graphs are automatically generated. To manually generate a run report, click Export run report and selecting which experiment to export to html.
For more information about the run report, please see the Run report section of this document.
A pore activity .csv file is also generated for every run.
The report and .csv files are saved to the same folder as the .fast5 and .fastq read files e.g. :\data\experiment\sample_ID\ for MinION Mk1B.
FIN DEL PROCESO
MinKNOW fallback folder
If writing out reads to your specified location fails (e.g. if the disk becomes full, or the connection is disrupted), the experiment will continue, and the reads will be written into a fallback folder:
Windows .POD5 or .fast5 files: C:\data\reads\fallback (with the standard run data name sample ID as a folder) FASTQ files: C:\data\reads\fastq_fallback (with the standard run data name sample ID as a folder)
macOS: .POD5 or .fast5 files: /Library/MinKNOW/data/fallback FASTQ files: /Library/MinKNOW/data/fastq_fallback
Linux: .POD5 or .fast5 files: /var/lib/MinKNOW/data/fallback FASTQ files: /var/lib/MinKNOW/data/fastq_fallback
40. Starting a sequencing run on PromethION P2i
Click 'Start Sequencing' on the Start page to set up the sequencing parameters for your experiment.
MEDIDA OPCIONAL
When running multiple flow cells simultaneously, it may be preferred to upload sample names and corresponding flow cell positions from a CSV file, rather than manually.
Please see Sample sheet upload for instructions.
Type in the experiment name, sample ID and choose flow cell type from the drop down menu.
Select Continue to move to the Kit Selection page.
Ensure the experiment name and sample ID does not contain any personally identifiable information.
To use previously saved settings, please see the "Save sequencing run settings" page of this protocol.
Use "Select all available" to select all the connected flow cells or use the diagram above to select specific flow cells for an experiment.
Note: If sample ID is not filled in, there will be no sample ID in the folder structure.
Select the kit and expansion(s) used to prepare the library.
One sequencing kit can be selected as well as one or more expansions. If a sequencing kit does not have any associated expansions, no expansion options will appear.
The filter options may be used to find the kit used. For example, click DNA to filter for DNA sequencing kits.
For control runs, there is a Control checkbox which only filters for the control experiments of the kits. This will automatically set the sequencing parameters for a control run. Note: Run length will be reduced to 6 hours for control experiments.
Click Continue to navigate to the run configuration page.
CONSEJO
Default sequencing parameters
Click Continue to proceed to the run configuration page.
Default sequencing parameters will be pre-set.
For the majority of users and applications, we recommend keeping the default sequencing parameters unless you have a specific need to change them.
Experiment overview
At the top of the run configuration page you will see an overview of your experiment set-up and identifiers inlcuding:
- Experiment name: defined by user.
- Positions: Flow cell position(s) being used in the sequencing experiment, and the associated sample IDs for the position(s).
Note: If using multiple flow cells, click "show details" to open a window displaying all the positions used and the associated sample IDs. - Flow cell type: automatically detected by the MinKNOW software.
- Sequencing kit: the sequencing kit used for DNA/RNA library preparation, user-defined.
Choose your basecalling options:
The basecalling option is on by default to perform real-time basecalling. This can be switched off and basecalling performed post-sequencing.
Note: If basecalling is disabled, barcoding and alignment will not be performed during sequencing.
Modified bases is off by default. This can be switched on to use the CpG context models and basecall 5mC and 5hmC.
To specify your basecall model and modified bases, click the Edit icon to open basecalling options dialogue box.
Basecall models
Basecalling models can be selected at two stages in the MinKNOW software:
- Real-time basecalling: A basecalling model can be selected when setting up a sequencing run on the "Run configuration" page of MinKNOW. This enables basecalling of the sequencing run in real-time.
- Post-run basecalling: Basecalling can be set up post-sequencing run on MinKNOW. Instructions can be found in the "Post-run basecalling" section of this protocol.
Dorado is the basecaller server in MinKNOW which provides multiple models for basecalling nanopore data.
There are three options for model selection in the drop down menu:
1. High-accuracy basecalling (HAC) - This is our default recommended basecalling model that provides a high single-molecule accuracy. It is currently 5-8 times more computationally-intensive than the Fast model, so users should ensure their data transfer and device utilisation is scaled appropriately for this.
2. Super-accurate basecalling (SUP) - The Super accurate model has an even higher single-molecule accuracy, and is ~3 times more intensive than the HAC model.
3. Fast basecalling - This model is able to keep up with a high-throughput sequencing experiment on a MinION, GridION or PromethION.
Note: GPU devices will basecall in near real-time; CPU devices, like a standard laptop for MinION Mk1B/Mk1D, will not maintain real-time basecalling.
Choose your barcoding options:
Barcoding options are only available when a barcoding sequencing kit or expansion has been selected. Barcoding can be switched off and performed post-sequencing.
To specify the barcoding options, click the Edit icon to open the barcoding options dialogue box. From here, barcode trimming and custom barcode selection can be defined.
By default, barcoding trimming is off. This can be enabled to remove barcodes from demultiplexed reads. Please note, some primer sequences may also be trimmed together with the barcodes.
By default, custom barcode selection is off. This can be enabled to only select for specified barcodes used in your library preparation for the current sequencing run.
Note: Specifying barcodes must be entered as:
- Individual numbers.
- Numbers separated by commas.
- Range of numbers separated by a dash.
- A combination of numbers and ranges, separated by commas.
Some sequencing kits place barcodes on both ends of the read. By default, the barcode both ends feature is off. If this feature is enabled, the barcode will only classified if a barcode above the minimum barcode score is present at both ends of the basecalled read.
Note: For barcoding to be performed during sequencing, basecalling must be enabled.
Choose your alignment options:
By default, alignment is turned off.
To use alignment during sequencing, upload an alignment reference file as a .fasta or .mmi file. We recommend uploading a reference locally on bacterial-sized genomes. Uploading a file can take a few minutes and is compute-dependent.
A reference file can contain multiple entries in the same file (e.g. multiple chromosomes) and alignment hits from these files are used to populate the alignment graphs which can be viewed on the GUI.
A BED file can also be uploaded alongside the reference when there is a specific interest in a particular region of the reference (e.g. specific gene in a chromosome). Alignment hits from BED files will be highlighted in the sequencing .txt file generated in the data folder. Click Edit options to open a dialogue box to upload a BED file.
BED files will be validated upon upload. If there is an error in the validation of the file, an error message will show linking to a web page with guidance on correcting the validation errors.
Note: For alignment to be performed during sequencing, basecalling must be enabled.
Choose your adaptive sampling options:
By default, alignment is turned off.
Enabling adaptive sampling will allow you to enrich or deplete specific sequences from your aligned sequencing data.
For our barcoding kits, the barcode balancing feature is also available using adaptive sampling through the "beta" features in MinKNOW.
By default, all adaptive sampling reads, whether they are accepted or rejected, will be basecalled. If you would like to only basecall on-target reads and not rejected reads, set the Basecally on-target reads only toggle to On. If you enable raw data generation, rejected reads will still be written out but not basecalled.
More information on this feature can be found in our Adaptive sampling documentation.
MEDIDA OPCIONAL
Advanced User Options
Time between pore scans: The time between pore scans can be altered using this feature.
Reserved pore: The reserve pore feature prioritises consistency and accuracy over immediacy by reserving wells where voltages have dropped until later in the run, such that other wells can catch up. Switch off this feature to fully front-load sequence data acquisition.
Set up the data targets for your experiment:
This feature allows you to set up the rules to define when a sequencing run will stop. If multiple rules are set up, the first rule met will stop the run.
Click the Edit icon to open the options.
Run limit
This rule must be defined based on run time length in hours or when a flow cell is end of life and has no more sequencing pores available.
Use the drop-down menu to choose:
- "Time equals" and hours
- or "Flow cell is" which will automatically be set as "End of life".
Flow cell data target
This rule can be used to define a target amount of data to reach before a sequencing run is stopped. This can be specified for either estimated or basecalled bases and your data target will be available to view on the experiment graphs to allow you to monitor data progress.
Please note, basecalling must keep up with data output in real-time. If the device or basecall model will not keep up and reach the target output before the run limit rule is met, we recommend using the "Estimated bases" option. However, if your experiment will not reach the target data before the end of the experiment as defined by the run limit rule, you will be warned by the UI.
Use drop-down menu to select for "Estimated bases equal" or "Basecalled bases equal" and input the value in either Gb or Mb.
Select the output options:
The output section provides variables for data output including file name, location and format.
Click the Edit icon to open the options.
Output settings:
Data saved as:
Check the name of the output file for the data.
Output location:
Confirm the location for the output data file. Click the file path name to open a pop-up to alter file path or create a new file.
Click Choose location on the pop-up to confirm new file location.
Output location storage capacity:
A bar indicator is displayed below the selected data output file location. This bar will display red when the disk space used reaches more than 80% of the total available disk space. Otherwise, the bar will display green. Below the bar, you can see how much drive space is available.
Basecalled output options:
Confirm output file type and file compression using the checkboxes.
Note: Below, reads per file can be changed for both raw reads and basecalled reads, but take note:
- Fewer reads per file: reads become more quickly available. However, too few reads per file means MinKNOW may not keep up with writing out files in real-time.
- More reads per file: reduces the number of files especially for amplicon/cDNA experiments that produce a large number of reads. Some downstream analysis tools may have an upper limit on the uploaded file size.
Basecalled output type:
Output file type can be selected between .FASTQ or .BAM files. The .FASTQ will be on as default if basecalling in real-time.
File output frequency can be adjusted for basecalled files based on two options:
Based on time elapsed | Based on number of reads |
---|---|
Basecalled files can be produced: · every 1 minute (many small files) · every 10 minutes (many small files) · hourly (fewer larger files) · at the end of the run (single large file). | Basecalled files can be produced for specified read thresholds (number of reads). |
For barcoding runs, basecalled reads are split into files by barcode by default.
Gzip compression of FASTQ files is on by default of basecalled reads. Note: FASTQ Gzip files may prevent some downstream informatics applications.
Raw reads output options:
Raw reads: Raw reads output can be saved as .POD5 or .FAST5.
- For Kit 14 chemistry and SQK-RNA004, .POD5 is the default file output. The .POD5 output generates files hourly.
- The .FAST5 output file is the default format for our previous and "legacy" chemistry kits. The.FAST5 output produces files for every 4000 reads.
.POD5 is a Nanopore-developed file format which stores Nanopore data in a more accessible way and can be used as an alternative to FAST5 output. This output also writes data faster, uses less compute and has smaller raw data file size.
We recommend keeping the default settings.
Raw reads split by barcode: Raw read files generated in the .POD5 format can now be split by barcode (if using one of our barcoding sequencing kits.
Please note, this feature is turned off by default and not available for .FAST5 files.
CONSEJO
Advanced User Options
Option to turn bulk file saving either on or off.
Note: This will result in much larger file sizes due to additional information about the run, which is used for debugging.
Choose the filtering options:
Filtering options can be used to determine which reads are classed into pass or fail files. These options may also be used to determine which predefined reads, read lengths and Qscore during basecalling can be split out in some live graphs.
Click the Edit icon to open the filtering options:
Use the GUI to alter Qscore and to define minimum and maximum readlength for a pass read, if required.
Click 'Start' to run the experiment.
You will be automatically navigated to the Sequencing Overview when sequencing starts.
From here, you can see a progress bar below the flow cell to show the progression of the sequencing script.
In some cases, the device will take a few minutes before starting a sequencing run if an alignment reference file is used. A progress bar will show the progress before sequencing begins.
Flow cell health will be displayed after the first pore scan.
Click on the flow cell to open the quick view and check the number of active pores. The first pore scan should report a similar number of active pores (within 10-15%) to that reported in the flow cell check.
Below are recommended troubleshooting tips if there are unexpected differences in pore numbers:
- If there is a significant reduction in active pores in the first pore scan, restart MinKNOW.
- If the numbers are still significantly different, close down the host computer and reboot.
- When the numbers are similar to those reported at the end of the flow cell check, restart the experiment. There is no need to load any additional library after the restart.
To stop the experiment during sequencing, click "Stop" using the run controls on the experiments page.
This is only necessary if you want to stop your run before the end of the set run time.
Confirm to stop experiment by clicking:
- Stop sequencing which will start catch-up basecalling
- or Stop sequencing and basecalling which will stop both sequencing and basecalling immediately.
Once sequencing is complete, generate a run report.
A run report containing information about the sequencing run and performance graphs are automatically generated. To manually generate a run report, click Export run report and selecting which experiment to export to html.
For more information about the run report, please see the Run report section of this document.
A pore activity .csv file is also generated for every run.
The report and .csv files are saved to the same folder as the .fast5 and .fastq read files e.g. :\data\experiment\sample_ID\ for MinION Mk1B.
FIN DEL PROCESO
MinKNOW fallback folder
If writing out reads to your specified location fails (e.g. if the disk becomes full, or the connection is disrupted), the experiment will continue, and the reads will be written into a fallback folder:
Windows .POD5 or .fast5 files: C:\data\reads\fallback (with the standard run data name sample ID as a folder) FASTQ files: C:\data\reads\fastq_fallback (with the standard run data name sample ID as a folder)
macOS: .POD5 or .fast5 files: /Library/MinKNOW/data/fallback FASTQ files: /Library/MinKNOW/data/fastq_fallback
Linux: .POD5 or .fast5 files: /var/lib/MinKNOW/data/fallback FASTQ files: /var/lib/MinKNOW/data/fastq_fallback
41. Refuelling your flow cell
IMPORTANTE
Refuelling: general advice
Note: This is only relevant for our Kit 9 chemistry.
Refuelling is the replenishment of motor fuel in the sequencing experiment through the addition of Flush Buffer (FB) from the Flow Cell Priming Kit (EXP-FLP002). The translocation speed graph in MinKNOW can indicate whether it is necessary to top up fuel. Volumes and processes of refuelling are specific to the flow cell type. Please follow the instructions relevant to your flow cell type e.g. Flongle™, MinION™ or PromethION™.
When to refuel
If the DNA translocation speed drops below 300 bases per second, you may start to see a reduction in quality of data reflected in the Qscore. We therefore recommend topping up the flow cell with fuel, using the Flush Buffer (FB) from the Flow Cell Priming Kit. Please follow the instructions below if you wish to top up the fuel during an experiment.
CONSEJO
Please consult the 'Priming and loading the [SpotON/Flongle/PromethION] flow cell' step from the relevant library preparation protocol for instructions on adding solutions to the flow cell type that will be used.
Refuelling a Flongle™ flow cell
Remove one tube of FB from the freezer and thaw by bringing to room temperature
Pause the experiment on the GridION position/on the MinION Mk1B/Mk1D on which the flow cell is being refuelled:
a. Navigate to Experiments and open the experiment running b. Click Pause c. A dialogue box will open. Choose the flow cell to pause and click Pause to confirm
- Pull back the seal tab to reveal the sample port
- Pass 30 µl of FB through sample port
- Reseal the tab, ensuring the drain ports are covered
- Unpause the experiment on the relevant GridION position/on the MinION Mk1B/Mk1D by clicking Resume
- (optional) Click Start pore scan to pick a new set of the best channels for the remainder of the sequencing experiment
Refuelling a MinION™/GridION™ flow cell
Instructions for refuelling a MinION/GridION flow cell:
Remove one tube of Flush Buffer (FB) from the freezer and thaw by bringing to room temperature
Pause the experiment on the GridION position/on the MinION Mk1B/Mk1D on which the flow cell is being refuelled:
a. Navigate to Experiments and select the experiment running b. Click Pause c. A dialogue box will open. Choose the flow cell to pause and click Pause to confirm
After opening the priming port, check for a small bubble under the cover. Draw back a small volume to remove the bubble (a few µl):
a. Set a P1000 pipette to 200 µl b. Insert the tip into the priming port c. Turn the wheel until the dial shows 220-230 µl, or until you can see a small volume of buffer entering the pipette tip
Visually check that there is continuous buffer from the priming port across the sensor array.
Complete the flow cell refuelling:
- Load 250 µl of the FB into the flow cell via the priming port (i.e. not the SpotON port), avoiding the introduction of air bubbles
- Close the priming port and replace the MinION Mk1B/Mk1D or GridION lid
- Unpause the experiment on the relevant GridION position/on the MinION Mk1B/Mk1D by clicking Resume
- (optional) Click Start pore scan and choose your flow cell, to pick a new set of the best channels for the remainder of the sequencing experiment
Refuelling a PromethION™ flow cell
Remove one tube of FB from the freezer and thaw by bringing to room temperature
Open the valve to reveal the inlet port
Pause the experiment on the relevant PromethION Flow Cell position(s) that will be refuelled:
a. Navigate to Experiments and open the experiment running b. Click Pause c. A dialogue box will open. Choose the flow cell to pause and click Pause to confirm
- Set a P1000 pipette to 200 µl
- Insert the tip into the inlet port
- Turn the wheel until the dial shows 220-230 µl, or until you can see a small volume of buffer entering the pipette tip.
- Using a P1000 pipette, load 250 µl of the FB into the inlet port of the flow cell, avoiding the introduction of air bubbles
- Close the valve
- Incubate the flow cell with the added FB for 3 mins
- Unpause the experiment on the relevant PromethION Flow Cell position(s) after this process is complete by clicking Resume
- (optional) Click Start pore scan and choose your flow cell, to pick a new set of the best channels for the remainder of the sequencing experiment
The outcome and benefits of refuelling
Translocation speed and Qscore over time
Below is a graph that shows what is expected for translocation speed after the addition of FB to the flow cell in a previous version of MinKNOW.
As the speed drops below 300 bases per second, the Qscore begins to decline for the reads processed through the nanopores at this speed. After refuelling at the 17.5 hour mark, the speed begins to increase and returns to an improved rate (~400 bases per second), which is similar to the speed at the start of the experiment. After the addition of fuel, the quality of the data increases and returns to Qscores equivalent to those seen at the start of the run.
Refuelling multiple times in a run
You can refuel a sequencing run multiple times over an experiment. When you should refuel will depend on when the translocation speed drops below 300 bases per second on the speed graph in the MinKNOW GUI for Kit 9 (e.g. SQK-LSK109). Kit 14 (e.g. SQK-LSK114) adapter contains fuel fix technology, enabling users to run long experiments without the need for fuel addition.
ATENCIÓN
Warning - overloading the flow cell when refuelling
If you refuel your flow cell multiple times, the waste reservoir of the flow cell will gradually fill up with buffer.
The array and waste reservoir of the below platforms (Flongle, MinION/GridION, PromethION) will take the following fluid loads:
- priming mix
- a library
- one refuel - for Flongle
- three refuels - for MinION/GridION
- four refuels - for PromethION
42. Checks and monitoring
During the sequencing experiment, you can check various flow cell health and performance parameters that are shown in the MinKNOW GUI. Each parameter is described in more detail in this section.
Flow cell health
During a sequencing experiment, the MinKNOW Sequencing Overview page shows a flow cell icon with coloured bars. The bars represent the combined health of all pores in a flow cell, and indicate how well the flow cell is performing. The colours are:
- Light green: sequencing
- Dark green: open pore
- Dark blue: pore recovering
- Light blue: pore inactive
This information is identical to the last bar of the pore activity plot (described later).
a) Flongle/MinION/GridION flow cell health b) PromethION flow cell health
Experiment summary information
The Experiments page displays summary information for all sequencing flow cells and device checks carried out on the device.
From this page, the user is able to control specific runs and identify real-time information including flow cell health and reads, giving users real-time feedback for sequencing flow cells.
- Read count: The total number of reads across the experiment.
- Estimated bases: The number of estimated bases to be basecalled from the experiment
- Basecalled bases: The number of basecalled bases from the experiment.
- Total run time: The duration of the experiment.
- Temperature: The heatsink temperature of the selected position, which for sequencing should reach 34°C with Kit 9-11, 30°C with Kit 12 or 35°C on Flongle. For Kit 14, sequencing temperature is approximately 36°C.
CONSEJO
As the MinKNOW script progresses, you can check the following:
- Number of active pores
- Heatsink temperature
- Development of the read histogram
- Pore occupancy
- Local basecalling report
Channel states
The channel states pannel gives an overview of the states the flow cell pores are in to give the user an idea of how well the sequencing run is performing in real time. A good library will be indicated by a higher proportion of light green channels in "Sequencing" than are in "Pore available". The combination of "Sequencing" and "Pore available" indicates the number of active pores at any point in time. A low proportion of "Sequencing" channels will reduce the output of the run.
Clicking on the Show Detailed button reveals a more detailed array of channel states:
- Sequencing: Pore currently sequencing.
- Pore Available: Pore available for sequencing.
- Adapter: Pore currently sequencing adapter.
- Active feedback: Channel ejecting analyte.
- No pore: No pore detected in channel.
- Multiple: Multiple pores detected. Unavailable for sequencing.
- Unavailable: Pore unavailable for sequencing.
- Unclassified: Pore status unknown.
- Saturated: The channel has switched off due to current levels exceeding hardware limitations.
- Out of range-high: Current is positive but unavailable for sequencing.
- Out of range-low: Current is negative but unavailable for sequencing.
- Zero: Pore currently unavailable for sequencings.
Pore activity plots
The pore activity plot summarises the channel states over time. Each bar shows the sum of all channel activity in a particular amount of time. This time bucket defaults to 1 minute, and scales to 5 minutes automatically after 48 minutes. However, bucket size can be adjusted in the "Bucket size" box in Display Settings.
The graph populates over time, and can be used as a way to assess the quality of your sequencing experiment, and make an early decision whether to continue with the experiment or to stop the run.
To see the more detailed view of channel states, click Show detailed.
- Sequencing: Pore currently sequencing.
- Adapter: Pore currently sequencing adapter.
- Pore available: Pore available for sequencing.
- Unavailable: Pore unavailable for sequencing.
- Active feedback: Channel ejecting analyte.
- No pore: No pore detected in channel.
- Out of range-high: Current is positive but unavailable for sequencing.
- Out of range-low: Current is negative but unavailable for sequencing.
- Multiple: Multiple pores detected. Unavailable for sequencing.
- Saturated: The channel has switched off as current level exceed hardware limitations.
- Zero: Pore currently unavailable for sequencing.
- Channel disabled: Channel is disabled and awaiting another pore scan.
Read length histogram
The cumulative histogram shows reads compared to bases. Use the options below to choose the axis legends:
- Y-axis: Estimated bases or basecalled bases
- X-axis: Read length or read counts
Read count - this shows the number of reads vs read length. This enables you to understand how the read lengths vary in number and size.
Read length - this shows the total number of bases vs the read length.
The N50 value is presented (only for the whole set of passed reads) in the top left corner of the histogram.
Each histogram's X-axis (read length) can be zoomed in using the scaled bar under the histogram. Use Reset to refocus the zoom bar and histogram for the entire 'passed read' dataset. You can see the number of bases by hovering over the bar in question.
Reads that are outliers in terms of length can be removed from the graph by ticking the Hide outliers box below the histogram.
Select Split by read end reason to view split reads and hover over for further information. This is useful for adaptive sampling which is further explained in the Adaptive Sampling info sheet.
- Device changed MUX/Pore scan initiated: The strand ended because there was a scheduled pore scan that interrupted the read.
- Read completed: The strand ended naturally as it passed through the pore.
- Read blocked: The strand ended because it was deemed of low quality and purposefully rejected.
- Adaptive sampling voltage reversal/Adaptive sampling rejection: The strand was rejected by adaptive sampling because it did not align to the target sequence when enriching, or the strand matched to the target sequence when depleting.
Duplex output
This graph is available to display cumulative output of both simplex and duplex data, including unpaired and, optionally, paired simplex data. Data output can be displayed as bases or reads.Note, the complement and template split in the graph are based on estimates.
Note: This graph is only available when duplex basecalling is turned on and HD flow cells (R10.4.1HD) are used.
Cumulative output
The cumulative output graph shows:
- the number of bases that have been sequenced and basecalled
- the number of reads that have been sequenced and basecalled; and whether the reads have passed of failed the quality filters
Cumulative output of multiple flow cells
If there are multiple flow cells running under the same experiment name, you will see the Experiment view. This gives output information on all assigned flow cells, plus a running cumulative total of bases or reads sequenced.
The cumulative output graph shows the running total number of Gbases sequenced by the GridION.
The output generated by each flow cell to make the total cumulative output can be represented by individual output plots.
Both graphs can be switched between in the MinKNOW GUI. Reads, bases (estimated or basecalled) depending on the name, sample ID or flow cell ID can be selected to tailor the output graph, as required.
Temperature and Bias Voltage graph
Temperature vs time graph
The temperature graph gives a real-time representation of the heatsink temperature of the flow cell. If the temperature reading drifts out of the target zone, please consult Technical Services, otherwise the quality of your data may be compromised.
Please note, for our kits using Kit 14 chemistry, there will be some temperature fluctation at the beginning of the run due to speed normalisation.
Bias voltage vs time graph
The bias voltage graph provides the running voltage in real-time. MinKNOW will automatically adjust the applied voltage and will naturally drift to lower voltages as the electrochemistry in the flow cell is depleted. This graph is useful for running a flow cell multiple times.
If you set the voltage for a subsequent run as the final running voltage of the previous run, then MinKNOW will find it easier to identify the appropriate running voltage.
You will notice drops in the voltage at regular intervals and these will correspond to the channel scans that are defaulted to occur every one and a half hours. Here, each channel will be scanned to look for its availability for sequencing. The common voltage is reversed before and after each channel assessment for clearer results.
Translocation speed and quality score graphs
Note: These graphs are only present if Basecalling is turned on.
Translocation speed vs time
The translocation graph gives a real-time representation of the speed at which DNA/RNA strands pass through the pore. If the translocation speed drops below this window, data quality and output may be compromised as strands take longer to move through the pore.
Please note, translocation speed will be dependent on the kit chemistry used.
Quality score vs time
The Quality score graph gives a live representation of the median strand Q-score over time.
Modal quality score graph is available across the run. This graph presents both the spread of quality scores and the modal quality score across the run, and the minimum quality score set.
Q score histogram
This Q score graph will be generated over time. Both simplex and duplex Q score can be viewed and there is a zoom function available in the X-axis.
Barcode read counts
The Barcode Read Counts graph shows the breakdown of barcoded reads, if barcoding was used for the experiment. The default view only shows reads that have passed the quality score filters. However, selecting the Display failed box will show all reads.
The X-axis of the histogram also has a zoom function using the scaled bar underneath. Use Reset to refocus the zoom bar and graph.
Note that there is a small amount of cross-talk between barcodes. Some barcoded reads may appear on the graph even if the barcode in question was not used for the experiment.
Note: This graph is only present if barcoded is turned on.
Alignment hits
The alignment hits graph will populate when alignment and basecalling is set-up to run during sequencing. This bar graph shows the number of reads and bases that align to each of the entries in the user reference .fasta file or minimap index file. An entry in the reference file will only appear on the graph once a single read has aligned to it.
The X-axis of the histogram also has a zoom function using the scaled bar underneath. Use the Reset to refocus the zoom bar and graph.
A target alignment hits view is also available in the same graph by clicking Alignment coverage. This is populated by the .BED targets if a .BED file is supplied with the alignment reference.
Alignment Q accuracy histogram
The Alignment Q accuracy histogram will populate when alignment and basecalling is set-up to run during sequencing, displaying alignment accuracy. The graph is functional for both Duplex and Simplex runs.
Alignment and barcode heatmap
The alignment and barcode heatmap is only available when alignment and demultiplexing is performed with basecalling during sequencing. The heatmap graph shows the alignment hits split per barcode. The colour gradient shows bases and reads which are the more popular barcode and alignment hit combinations. Use the options below to view reads or bases and the slide bar above to focus on specific regions.
Note: These graphs are only present if barcoding and alignment are both turned on.
Traceviewer
The Traceviewer displays the current levels from individual channels. By default, it is set to show 10 channels. This number can be changed through the selection boxes beneath the viewer. Additional parameters that can be altered:
- Time: The length of time plotted on one screen
- Maximum: The highest current level to be shown on the y axis
Please note that viewing a high number of channels in the traceviewer may impact the speed at which the GUI is able to function.
Pore scan
As the sequencing protocol starts, a pore scan begins before the sequencing. There are four groups of active pores, and the pore scan allows MinKNOW to pick the best-performing pores in each group, maximising the data output in the initial stages of the run. The software also instantly switches to a new channel in the group if a channel is in the “Saturated” state, or after ~5 minutes if a channel is “Recovering”.
FIN DEL PROCESO
End of sequencing protocol script.
The length of the sequencing scripts are indicated during script selection, e.g. 72 Hr. However, if live basecalling is selected, a minimum-spec laptop may not keep up with the speed of data acquisition, and not all reads will be basecalled by the end of the experiment. The reads that had not finished being basecalled during the experiment will continue to be basecalled in Catch-Up mode.
The reads from the experiment will be found in the location set during experiment set-up in MinKNOW. The read file structure is described here. If the Desktop Agent is running simultaneously to MinKNOW, the full report will also be available. If it is being run at different times, the reads will be present in the data/reads folder ready to be processed.
43. Troubleshooting your run from the pore activity plots
Pore activity plot introduction
The pore activity plot feature in the MinKNOW software can be used to judge the quality of your experiment. The pore activity plot shows the distribution of channel states over time, grouped by time chunks, or 'buckets'. The basic view shows the five main channel states: Sequencing, Pore, Recovering, Inactive, and Unclassified. Clicking the "More" button shows a more detailed breakdown of channel states.
It is recommended to observe the pore activity plot populating over the first 30 min-1 hr of the sequencing run. By this time, the channel state distribution will give an indication whether the DNA/RNA library is of a good quality, and whether the flow cell is performing well.
If Active Channel Selection is enabled during the run, the software instantly switches to a new channel in the group if a channel is in the “Saturated” or “Multiple” state, or after ~5 minutes if a channel is “Recovering”. This feature maximises the number of channels sequencing at the start of the experiment, however this may also result in an artificially high number of "Sequencing" or "Pore" channels in the pore activity plot. For this reason, we recommend referring to the pore scan plot, which shows the true distribution of channel states at the point of the most recent pore scan.
Good library
A good quality library will result in most of the pores being in the "Sequencing" state, and very few in "Pore", "Recovering" or "Inactive". A library that looks like this is likely to give a good sequencing output.
Channel blocking
Under certain conditions (usually the presence of contaminants in the library), pores may become blocked and therefore unable to sequence. This manifests itself as a build-up of "Unavailable" pores over time.
Recommendation:
- If, despite the channel blocking, the library is still producing a sufficient number reads to answer your biological question, you can carry on with the sequencing experiment.
- Otherwise, stop the sequencing run in MinKNOW. Then wash out the library from the flow cell using the instructions for the Flow Cell Wash Kit. Then prepare another library and load it on the flow cell.
Osmotic imbalance
If the plot shows a high number of "Inactive" channels building up over time, this could indicate that the channels or membranes have been damaged, for example by air bubbles, osmotic imbalance, or the presence of detergents or surfactants in the library.
Pore activity:
Pore scan:
Recommendation:
- Check the channel panel: if the Inactive channels are all grouped in one part of the flow cell, this could indicate an air bubble that has been introduced during flow cell flushing or library loading. If the remaining channels are still sequencing, it is possible to carry on with the run. Do not try to move the air bubble, as this can damage even more channels.
If the Inactive channels are distributed throughout the flow cell:
- Check that the heat tape on the underside of the flow cell is intact.
- Make sure that the input DNA is in either TE buffer or nuclease-free water, and that the buffer contains no detergents or surfactants.
- Make a new batch of flow cell priming buffer (a mixture of Flush Buffer/Flow Cell Flush and Flush Tether/Flow Cell Tether). Flush the flow cell with the mixture and load the library again.
Low pore occupancy
If there was insufficient starting material, or some sample has been lost during library prep, or the sequencing adapters did not ligate well to the strand ends, the plot will show a high ratio of "Pore available" to "Sequencing" states, meaning that only a limited number of pores are sequencing at any one time.
Recommendation:
- Check the amount of DNA/RNA in your prepared library, for example by using the Qubit fluorometer. We recommend preparing a fresh library and reloading your flow cell with the recommended loading input from the relevant protocol
- If your library is at a low concentration, prepare the library again using a higher amount of starting material.
- Ensure you are adding the flush tether to your priming mix during flow cell priming and loading before adding your library.
- For ligation-based protocols, ensure you are following the protocol to ligate the sequencing adapter correctly and performing any clean-up steps after adapter ligation with short or long fragment buffer rather than ethanol.
RNA pore activity
For RNA in particular, the expanded channels view may show a large proportion of pores sequencing Adapter. This happens because RNA strands are usually shorter than DNA, and the adapter takes up a larger proportion of the strand. Additionally, the RNA sequencing chemistry is optimised for sequencing RNA, whereas the adapter is DNA, and is processed slower. As long as the 'basic' pore activity plot view shows the majority of pores in "Sequencing", a high proportion of Adapter should not be a problem.
44. Completion of a sequencing protocol script
Catch-up notifications
Catch-up basecalling is carried out either after the sequencing run completes (e.g. after 72 hours), or if the run is manually terminated. To manually terminate a run, select sequencing flow cells and click Stop.
A pop-up window will appear:
A progress bar is displayed during catch-up basecalling on the Sequencing Overview and Experiments pages.
IMPORTANTE
Please note that in the current version of MinKNOW, stopping your experiment and stopping basecalling through the GUI when ONLY FASTQ output is selected leads to queued reads being discarded. We are working on a fix.
CSV files output by MinKNOW
The data used by MinKNOW to generate the pore activity and Cumulative Output plots are output as CSV files. These files are in the run-specific folder in the reports directory (e.g. \data\reports on Windows).
Using the data in the CSV files, users can recreate pore activity and Cumulative Output graphs themselves in Excel by adding the various pore states to the 'Legend Entries (series)' panel:
Below are definitions of the columns in the output CSV file from MinKNOW:
Column title | Description |
---|---|
Experiment time (minutes) | Time in minutes from the beginning of the sequencing run. |
Reads | Cumulative number of reads basecalled since the beginning of the sequencing run. |
Basecalled reads passed | Cumulative number of reads basecalled since the beginning of the sequencing run with a Qscore above the filter threshold. |
Basecalled reads failed | Cumulative number of reads basecalled since the beginning of the sequencing run with a Qscore below the filter threshold. |
Basecalled reads skipped | Cumulative number of reads that have not been basecalled since the beginning of the sequencing run. |
Selected raw samples | Raw analog-to-digital converter (ADC) samples that have been identified by MinKNOW as part of a read. |
Selected events | Measure MinKNOW uses to estimate bases and distinct from events used in basecalling. |
Estimated bases | Number of (MinKNOW) events multiplied by some fixed factor defined per chemistry. |
Basecalled bases | Number of estimated bases that have been in all selected reads above. |
Basecalled samples | Number of basecalled bases that have been in all selected reads above. |
Acquisition termination file for LIMS
Customers using LIMS will receive a summary file once data acquisition and file writing has completed. The file is named final_summary.txt, and is written out to the output directory.
An example of the file contents is shown below:
instrument=PCT0009
position=1-A5-D5
flow_cell_id=PAD15520
sample_id=Chinese_NA24631
protocol_group_id=JB_47x_P48005_270319
protocol=4a37d56a62b6425a2af4d01d4970c7b5cc7b7c80
protocol_run_id=2a4ccaa1-8aaf-4872-a1f3-773a686d64de
acquisition_run_id=7eeaea330d1fe2ec43583072bbe21288254bef1b
started=2019-03-27T17:23:55.542284+00:00
acquisition_stopped=2019-03-28T09:58:37.505691+00:00
processing_stopped=2019-03-28T09:58:37.505788+00:00
basecalling_enabled=1
sequencing_summary_file=sequencing_summary/PCT0009_20190327_172337_PAD15520_promethion_sequencing_run_Chinese_NA24631_sequencing_summary.txt
fast5_files_in_final_dest=1606
fast5_files_in_fallback=0
fastq_files_in_final_dest=1197
fastq_files_in_fallback=0
45. Run report
Run reports overview
Run reports contain information about the sequencing run and include performance graphs. These graphs are automatically generated at the end of a run but can be manually generated by clicking Export run report and selecting which experiment to export to html.
The run report includes the run summary and configuration, sequence output, run health, and run log. This html report is interactive, allowing users to jump to the information they need and hide other details they do not require. Troubleshooting suggestions are also available throughout the report, with links to further information available on the Community.
Run summary
This is an overview of the sequencing run, including output and baseacalling results along with the duration of the run.
During a run: When a run report has been generated during a run, the elapsed time will show in the progress bar, along with:
- The estimated time until flow cell end of life (if selected)
- The estimated time until the data target condition will be met and if the flow cell will reach the target during the run time or flow cell life (if selected). A warning will appear under the progress bar if the data target will not be met.
If a run report was generated when a sequencing run is paused, the run status will only display "PAUSED" with no progress bar or estimations.
After a run: When a run report is generated after a sequencing run has completed, the duration of the run will be displayed, along with:
- The run status confirming the flow cell end of life condition was met and completed progress bar.
- The run status confirming the data target was met and a partially filled progress bar reaching the data target. If the data target was not met, a warning will appear under the completed progress bar.
Note: The relevant run until parameters must be defined during the sequencing run set up for these status reports to appear on the run report.
Run configuration
A detailed overview of the settings selected for the sequencing run and data output, including the software versions used to sequence the data. We have also included further information about the modified bases and basecalling models chosen, barcode balancing settings, expansion kits used and read splitting preferences selected.
Sequence output
This section includes a more detailed view of the sequencing output, such as read lengths, barcodes detected and quality score.
Read lengths The total number of bases against the read length are displayed in this graph. Any outliers displayed in a table below, displaying read length and aggregated reads.
Barcodes Barcodes detected are displayed in a searchable table which can be exported as a .CSV file. Two graphs for bases and reads are available to view and displays total number of reads/bases above a Qscore of 9. Passed and failed data is also displayed and can be sorted by barcode.
Detected barcodes:
Bases graph:
Reads graph:
Cumulative output Total output of the bases and reads sequenced during the experiment are outlined in the graphs here.
Quality score Quality score (Qscore) of your sequencing run is displayed here, with the minimum value set on MinKNOW during run set up.
Alignment If an alignment file was supplied and alignment turned on during run set-up, the Reference alignment and Bed regions sections will be displayed with tables that can be exported as CSV files.
Reference alignment: This table will display the specified reference sequence and the number of reads, bases and coverage percentage.
Bed region: This table will display the specified reference sequence with the coordinates of the specific target within the reference sequence as well as the number of reads, bases and coverage percentage.
Run health
This provides a detailed view of the pore activity and pore scan results throughout the run, along with graphs displaying the translocation speed and temperature.
Pore activity states:
- No pore from scan: No pore detected in channel
- Sequencing: Pore currently sequencing
- Adapter: Pore currently sequencing adapter
- Pore available: Pore available for sequencing
- Unavailable: Pore unavailable for sequencing
- Active feedback: Channel ejecting analyte
- Out of range-high: Current is positive but unavailable for sequencing
- Multiple: Multiple pores detected. Unavailable for sequencing
- Saturated: The channel has switched off as current levels exceed hardware limitations
- Out of range-low: Current is negative but unavailable for sequencing
- Zero: Pore currently unavailable for sequencing
- Channel disabled: Channel is disabled and awaiting another pore scan
Pore scan states:
- Pore available: Pore in channel available for sequencing
- Reserved pore: Pore in reserve, will return to available when required
- Unavailable: Pore inhibited from sequencing
- Saturated: Possible contamination in the sample
- Zero: No current is passing through this pore, possibly due to bubbles on the membrane
- Inactive: Pore no longer suitable for sequencing
Run log
The run log includes system messages sent during the sequencing run regarding errors, warning, and any events.
46. Closing MinKNOW and shutting down a MinION Mk1B/Mk1D
Ensure that the flow cell is not running an experiment.
Close MinKNOW by closing down the GUI.
Disconnect the MinION Mk1B/Mk1D.
47. Cerrar MinKNOW y apagar el GridION
Apagar el GridION
El ordenador conectado al GridION se debe apagar de manera escalonada y procesada; de lo contrario es posible que surjan problemas, por ejemplo, al detectar celdas de flujo.
Para apagar correctamente el dispositivo y evitar contratiempos, preste atención a las instrucciones de esta sección.
Procurar que no haya celdas de flujo realizando ningún experimento.
Una indicación de que no se están realizando experimentos es la ausencia de barras de estado debajo de las celdas de flujo.
Ir a la Configuración del dispositivo y hacer clic en "Shutdown/Apagar".
Si procede, apagar el dispositivo desde la toma de corriente.
Si se conecta a un dispositivo de forma remota y utiliza un ordenador que no está conectado directamente al dispositivo, cierre la ventana de la aplicación MinKNOW.
48. Closing MinKNOW and shutting down on PromethION
Shutting down your PromethION
The PromethION's computer requires a stepwise, processed shutdown, otherwise you may face problems e.g. when recognising flow cells.
Follow the instruction in this section to ensure you do not face errors with your PromethION from incorrectly shutting down your device.
Ensure none of the flow cells are running an experiment.
An indication no experiments are running is the lack of an experiment status bar beneath individual flow cells.
Ir a la Configuración del dispositivo y hacer clic en "Shutdown/Apagar".
IMPORTANTE
Do NOT select 'Reboot'. This will lead to errors in recognising the flow cells when commencing an experiment.
Once the screen goes blank, turn off the sequencing module and tower via the switch at the rear of the device.
Si se conecta a un dispositivo de forma remota y utiliza un ordenador que no está conectado directamente al dispositivo, cierre la ventana de la aplicación MinKNOW.
49. Post-run basecalling
Basecalling overview
A user can basecall and demultiplex their data directly in MinKNOW after a sequencing experiment has finished to avoid having to use command-line tools, or to re-analyse old data using the latest basecalling models. Reads can also be aligned against a reference post-sequencing.
Note: Both barcoding and alignment can be run on FASTQ, POD5 or FAST5 reads when coupled with basecalling.
Click 'Post sequencing analysis' on the start page.
Click 'Basecalling' to open the post-run basecalling set-up options.
Select input folder containing the files to basecall from a previous run.
Select whether you want to process reads in sub-directories.
If your chosen read input folder contains sub-directories with FAST5 files, you can choose whether to basecall files in these sub-directories by enabling this option.
Select output folder and file type.
By default, MinKNOW will create a /basecalled
folder in /data
. You can set a different folder in which to save the basecalled reads. Note: This must be a sub-folder of /data
directory.
By default, output FASTQ files will be compressed using Gzip. This feature can be toggled off by the user.
Choose basecalling model from the drop-down menu.
Set-up the configuration of your basecalling run using the drop-down menus:
- In the run setting, select the parameters used to initially sequence the data.
- In the basecalling settings, select the basecall model used to process raw signal, and whether to use modified basecalling.
Once all the parameters have been selected, the basecalling configuration will be displayed in the lower panel.
Given the recent improvements to basecalling accuracy, Q-score cut-off for reads put into the "pass" folder has been increased to:
Fast basecalling model >8 High accuracy (HAC) model >9 Super accurate (SUP) model >10
MEDIDA OPCIONAL
Select any barcoding kits used for the run from the drop-down menu.
MinKNOW will write out basecalled reads into barcode-specific folders and enable demultiplexing during basecalling.
Users are able to choose specific settings, including trimming barcodes and barcoding both ends (available for specific barcoding kits).
MEDIDA OPCIONAL
Select to use alignment and import a reference sequence in a FASTA file.
We currently only recommend uploading an alignment reference locally for bacterial-sized genomes. Upload can take a few minutes and is compute dependent.
A reference file must by uploaded as a FASTA file that can contain multiple entries in the same file (e.g. multiple chromosomes).
However, a .bed file may also be uploaded alongside the reference FASTA file. The BED file option can be used when the user is interested in a particular region of the reference (e.g. specific gene in the chromosome). Alignment generates FASTQ output files when performed with basecalling.
Click 'Start' to begin post-run basecalling.
50. Post-run barcoding
Barcoding overview
A user can barcode their data directly in MinKNOW after a sequencing experiment has finished, using FASTQ data.
Click 'Barcoding' in the analysis menu to open the post-run barcoding set-up options.
Select the input folder containing the FASTQ data to barcode from a previous run.
Select whether you want to process FASTQ reads in sub-directories.
If your chosen read input folder contains sub-directories with FASTQ files, you can choose whether to barcode FASTQ files in these sub-directories by switching this option on.
Note: Data can only be saved to the /data
folder.
Choose output folder for the post-run barcoded data.
By default, MinKNOW will create a /barcoding
folder in /data/
. You can set a different folder which to save the barcoded reads. Note: This must be a sub-folder of /data
directory.
You can also select your output file formats to be generated as .BAM or .FASTQ.
Select any barcoding kits used for the run from the drop down menu.
MinKNOW will write out basecalled reads into barcode-specific folders and enable demultiplexing during basecalling.
Users are able to choose specific settings, including trimming barcodes and barcoding both ends (available for specific barcoding kits).
Click 'Start' to begin post-run barcoding.
51. Post-run alignment
Alignment overview
A user can align their data directly in MinKNOW after a sequencing experiment has finished, using a FASTQ file from a previous run.
The reference file of bacterial-sized genomes must be uploaded locally as a FASTA file. Alignment hits from these files are used to populate the alignment graphs.
A BED file may also be uploaded alongside the reference FASTA file when the user is interested in a particular region of the reference (e.g. specific gene in the chromosome). The BED file alignment hits will be highlighted in the sequencing .txt file generated in the data folder.
When alignment is run independently from basecalling, BAM files are generated.
Click 'Post sequencing analysis' on the start page.
Click 'Alignment' to open the post-run analysis set-up options.
Select the input file containing the FASTQ data to carry out alignment from a previous run.
Select whether you want to process FASTQ reads in sub-directories.
If your chosen read input folder contains sub-directories with FASTQ files, you can choose whether or not to align FASTQ files in these sub-directories by switching this option on.
Note: Data can only be saved to the /data
folder.
Choose the output folder for the post-run aligned data.
By default, MinKNOW will create an /alignment/
folder in /data/
. You can set a different folder which to save the aligned reads. Note: This must be a sub-folder of /data
directory.
Select the alignment reference to carry out the post-run alignment.
The alignment reference must either be a FASTA file.
However, there is also the option to use a BED file alignment reference as well.