Genome Visualisation

Layering information onto your sequences

Author

Prof. Peter Kille and Dr. Sarah Christofides

Published

September 9, 2026

As you go through each step of the annotation process, use loops to apply it to all the virus genomes you’ve assembled.

Pick one virus genome and work through annotating it. Use the time later in the extension session to use loops to apply the process to all the virus genomes.

Visualising genomes using Artemis

Artemis is a rather old but very elegant genome visualisation tool. To get you used to using it, we will try it out using an example genome that’s already been annotated.

Artemis can be installed locally local install instructions. Warning: this can take time, so please do not do it during teaching session.

Additional Sanger Centre training material can be downloaded using the following link - Sanger center training

  1. download latest version of Artemis from https://github.com/sanger-pathogens/Artemis/releases/download/v18.2.0/artemis-macosx-release-18.2.0.dmg.gz

  2. download java from Latest Releases - must be jdk v11 or above, from TechSpot or Adoptium

  3. unpack Artemis - and move the files to a folder somewhere … i.e to an Artemis directory you’ve made somewhere.

  4. find out what version of java is currently on your system

java -version

or you can see the java versions you have available using

/usr/libexec/java_home -V
  1. then depending on your shell - edit the relevant rc file
nano ~/.zshrc

and add a line …. change the -v1.8 to -vXX depending on the version of java you have as default.

export JAVA_HOME=$(/usr/libexec/java_home - v1.8)
  1. now install the version of java you have just downloaded - this will install and make the default java change to this version. You should also see a new line appear when you run this command.
/usr/libexec/java_home -V
  1. now run Artemis - use terminal to change to the directory you put the apps in in step 3
cd ~/Artemis/
Artemis.app/Contents/art
  • will run Artemis - or alternatively you should be able to click on the icons in finder to run.

  • If there is a security issue - go … File – System Settings – Privacy & Security .. and then look for a statement that says “Artemis” was blocked from use because it is not from an identified developer …. and click Open Anyway - you need to have admin/sudo privileges to do this.

  • Artemis should run

  1. the next time you log into your mac - the default java will be the default one and not the one required to use Artemis … so to the terminal and type (change -v flag depending on jvm version)
export JAVA_HOME=$(/usr/libexec/java_home -v16)
  • and now you should be able to run Artemis again

  • if you want to keep use this java as default - edit your .zshrc file

  • if you don’t want to type in that command all the time, add this to your .zshrc file

alias javaart='export JAVA_HOME=$(/usr/libexec/java_home -v16)'
  • and then type javaart into a terminal to change to the version of java required for Artemis

  • alternatively you should be able to edit the

Artemis.app/Contents/art
#script and add
export JAVA_HOME=$(/usr/libexec/java_home - v16)
  • at the top somewhere - haven’t tested this to force the right version of java to be used.

To use Artemis via your Linux desktop on the server, you need to enable it to use a visual interface. Open a new tab in MobaXterm and log in using the slightly modified command:

#For masters' students
ssh [your username]@sponsa.bios.cf.ac.uk -X -p [your port number]
#For Y3 students
ssh [your username]@hawker.bios.cf.ac.uk -X -p [your port number]

Use the three-word passphrase you were assigned.

The -X enables the graphical interface.

ImportantExercise: Loading a Genome into Artemis

Load the Artemis module and initiate Artemis with command art

module load artemis/18.2.0-conda
art

Artemis Opening Screen

Open Genbank File

>File >Open

Navigate to your Session3 folder and select the genbank file (NC_003428.gb).

Cancel any warnings you should see the following window;

The blue highlighted area should highlight open reading frames (ORFs) and the vertical lines stop codons - notice that there are vertical line in the middle of ORFs this indicates that we are using the wrong codon table. Arrange your graphics windows so you can see the Opening window which will be hidden behind the gene display window - you should see something like this.

Now change the codon table by selecting

> Options > Genetic Code Tables
selecet
Vertebrate Mitochondrial

Your gene visualisation should now look like this

As we create our annotations, you will be able to visualise the various outputs using Artemis.

WarningExtension Work

I have included a range of extension exercises / guides generated by the Sanger Centre (the people who wrote Artemis) these are included in your Session3 folder under Artemis_Sanger_Center