diff --git a/README.md b/README.md index 67f879c0..2da26e96 100644 --- a/README.md +++ b/README.md @@ -9,7 +9,7 @@ To start using Emperor, please refer to the [installation notes](INSTALL.md). ## Usage examples -The main interface to create Emperor visualizations is the `make_emperor.py` script, inputing a mapping file and a PCoA data file, will generate an Emperor graphical user interface to analize and visualize your data. +The main interface to create Emperor visualizations is the `make_emperor.py` script, inputing a mapping file and a PCoA data file, will generate an Emperor graphical user interface to analyze and visualize your data. If you have a QIIME compliant mapping file and a PCoA file, try the following command from a terminal session: diff --git a/emperor/format.py b/emperor/format.py index 35cccd1f..d844349d 100755 --- a/emperor/format.py +++ b/emperor/format.py @@ -489,7 +489,21 @@ def format_emperor_html_footer_string(has_biplots=False, has_ellipses=False, -
+ + +Emperor's visualization framework is WebGL based, it seems that your system doesn't have this resource available. Here is what you can do:
+Chrome: Type "chrome://flags/" into the address bar, then search for "Disable WebGL". Disable this option if you haven't already. Note: If you follow these steps and still don't see an image, go to "chrome://flags/" and then search for "Override software rendering list" and enable this option.
+Safari: Open Safari's menu and select Preferences. Click on the advanced tab, and then check "Show Developer" menu. Then open the "Developer" menu and select "Enable WebGL".
+Firefox: Go to Options through Firefox > Options or Tools > Options. Go to Advanced, then General. Check "Use hardware acceleration when available" and restart Firefox.
+Other browsers: The only browsers that support WebGL are Chrome, Safari, and Firefox. Please switch to these browsers when using Emperor.
+Note: Once you went through these changes, reload the page and it should work!
+Sources: Instructions for Chrome and Safari, and Firefox
+