Java Heap Space

20 views
Skip to first unread message

Adeyeye Haastrup

unread,
Dec 11, 2024, 6:49:41 PM12/11/24
to gsea-help
Hello. I am having this error on the app :
<Error Details>

---- Full Error Message ----
Java heap space

---- Stack Trace ----
# of exceptions: 1
------Java heap space------
java.lang.OutOfMemoryError: Java heap space

how do I solve it please?

Anthony Castanza

unread,
Dec 13, 2024, 4:20:16 PM12/13/24
to gsea...@googlegroups.com
Hi Adeyeye,

This would appear to be an issue with the amount of memory allocated to Java on your machine.
Is this a Mac or a PC and are you using the application bundle or the command line version of GSEA?
How much RAM is your machine configured with and what size is the expression dataset you're attempting to analyze?

If you have a severely memory constrained machine, or an extremely large dataset, one option would be to run GSEA through the free bioinformatics cloud platform at cloud.genepattern.org.
This offers GSEA with all the same features as the desktop application, but with the ability to request very large amounts of memory which will allow exceptionally large datasets to be analyzed.

-Anthony

Anthony S. Castanza, PhD
Curator, Molecular Signatures Database
Mesirov Lab, Department of Medicine
University of California, San Diego

--
You received this message because you are subscribed to the Google Groups "gsea-help" group.
To unsubscribe from this group and stop receiving emails from it, send an email to gsea-help+...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/gsea-help/7f6740c7-ae84-4270-a6c0-870fc73a008bn%40googlegroups.com.

David Eby

unread,
Mar 10, 2025, 2:09:52 PM3/10/25
to gsea...@googlegroups.com
Hi Adeyeye,

I just wanted to let you know that we released a new version of GSEA (v4.4.0) over the weekend that gives another way to address this problem.  You can now add a special configuration file that GSEA will use when loading to set a custom memory specification.

The details are in this README.  As that document covers other material (and is a bit technical as well), here's a summary.  You can change the default memory specification by editing GSEA's java_arguments file, found here (create it if it doesn't exist):
  • $HOME/.gsea/java_arguments           (Mac and Linux)
  • %USERPROFILE%/.gsea/java_arguments   (Windows)
Within that file, adding the following on a single line will allow GSEA to use 8 GB on memory instead of the default of 4 GB:
-Xmx8g

You can change this accordingly for 16 GB, etc.  Note that you'll be limited by your computer's actual memory capacity.

Regards,
David

Thanks!
David



David Eby

unread,
Mar 10, 2025, 3:21:03 PM3/10/25
to gsea...@googlegroups.com
Just as a quick follow-up, it's worth mentioning that the java_arguments file should be created with a plain-text editor (like NotePad, TextEdit, or emacs) and should have no extension.  I should add that note to the README.

Reply all
Reply to author
Forward
0 new messages