help/help/html/memory.html

   1 <html>
   2 <!--
   3  * Jalview - A Sequence Alignment Editor and Viewer ($$Version-Rel$$)
   4  * Copyright (C) $$Year-Rel$$ The Jalview Authors
   5  *
   6  * This file is part of Jalview.
   7  *
   8  * Jalview is free software: you can redistribute it and/or
   9  * modify it under the terms of the GNU General Public License
  10  * as published by the Free Software Foundation, either version 3
  11  * of the License, or (at your option) any later version.
  12  *
  13  * Jalview is distributed in the hope that it will be useful, but
  14  * WITHOUT ANY WARRANTY; without even the implied warranty
  15  * of MERCHANTABILITY or FITNESS FOR A PARTICULAR
  16  * PURPOSE.  See the GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with Jalview.  If not, see <http://www.gnu.org/licenses/>.
  20  * The Jalview Authors are detailed in the 'AUTHORS' file.
  21  -->
  22 <head>
  23 <title>Memory Settings</title>
  24 </head>
  25 <body>
  26   <h2>
  27     <center>
  28       <strong>Memory Usage Settings for Jalview</strong>
  29     </center>
  30   </h2>
  31   <p>
  32     When launched as an Application, Jalview automatically tries to
  33     maximise the amount of memory allocated to it (default settings are
  34     to try and use up to 90% of physical memory available to it).
  35     Sometimes it may require more memory, or if you are working in a
  36     shared memory environment you may want to limit the maximum amount
  37     of memory that it might use.
  38     This has to be set at the time Jalview is launched because of the way
  39     that Java runs on a computer - what is actually run is a program called
  40     a Java virtual machine (a JVM) which executes the java program instructions.
  41     The JVM has limits on the memory that can be allocated to the java program - and
  42     you might need to increase them if you are working with particularly
  43     large datasets.<br> If Jalview has not explicitly told you that
  44     it has run out of memory, then a common sign is that a function that
  45     normally works seems to have no effect when working with a larger
  46     set of sequences (this might include open dialog boxes for saving
  47     PNG files, or when interpreting the result of a web service
  48     calculation).
  49   </p>
  50   <p>
  51     <em>Jalview Memory Usage Monitor</em>: If you are concerned about
  52     memory, or think that things might be behaving strangely because of
  53     a shortage of memory, then you can check this by enabling the memory
  54     usage monitor. This is done by selecting the <strong>Tools&#8594;Show
  55       Memory Usage</strong> option. Once enabled, the memory usage monitor
  56     displays the currently available memory, the total memory, and the
  57     percentage free at the bottom left hand side of the Jalview Desktop
  58     window's background.
  59   </p>
  60   <p>
  61     <em>Increasing the memory available to Jalview</em><br/>
  62     Since Jalview 2.11, the program automatically configures the JVM memory settings to set the maximum memory available to Jalview to be 90% of physical memory.
  63     This default setting can be altered in a number of different ways, depending on how you prefer to launch Jalview and how specific you want to be with the maximum memory setting.
  64   </p>
  65
  66   <ul>
  67     <li><em><font size="3">JVL file</font></em>
  68       <p>
  69       The easiest way to launch Jalview with a different percentage of physical memory available is to
  70       create a text file with extension <em>.jvl</em> and with content that looks like
  71       <pre>
  72       jalview.jvmmempc=50
  73       </pre>
  74       Replace the value with the percentage of memory you wish to allocate to Jalview.
  75       </p>
  76       <p>
  77       In Windows and in macOS you can then launch Jalview by double clicking on this file, and your memory setting will be used instead of the default value of 90.
  78       </p>
  79       <p>
  80       In Linux or other unix variants you can launch Jalview on the command line and provide your JVL file as an argument with
  81       <pre>
  82       /PATH_TO_JALVIEW/Jalview /path/to/file/mymemorysetting.jvl
  83       </pre>
  84
  85       </p>
  86       <p>
  87       If you want to use a memory setting like this and open a file you can use both files as arguments in the command line, but you must put the <em>jvl</em> file first, e.g.
  88       <pre>
  89       /PATH_TO_JALVIEW/Jalview /path/to/file/mymemorysetting.jvl /path/to/alignments/myalignment.fa
  90       </pre>
  91
  92
  93       </p>
  94     </li>
  95
  96
  97     <li><em><font size="3"></font></em>
  98       <p>
  99       </p>
 100     </li>
 101
 102
 103
 104
 105     <li><em><font size="3"></font></em>
 106       <p>
 107       </p>
 108     </li>
 109
 110
 111
 112
 113     <li><em><font size="3"></font></em>
 114       <p>
 115       </p>
 116     </li>
 117
 118
 119
 120
 121     <li><em><font size="3"></font></em>
 122       <p>
 123       </p>
 124     </li>
 125
 126
 127
 128
 129     <li><em><font size="3"></font></em>
 130       <p>
 131       </p>
 132     </li>
 133
 134
 135   </ul>
 136
 137 </body>
 138 </html>