Downloading and Installing SerialEM and Related Components


Getting Started
Upgrading
Packages Available Here
SerialEM License Terms
Stable Release Version - SerialEM 3.7
Previous Release Version - SerialEM 3.6
Shrmemframe Packages
FrameGPU Packages
Development/Beta Versions
Other Files Available

Getting Started

To install SerialEM you need two self-extracting archives:

  1. An install package with the SerialEM executable, plugins and help files; see Packages Available Here
  2. An archive that sets up a framework and configuration files for SerialEM. We highly recommended that you get a framework file customized for your scope. To do so, fill out the microscope questionnaire and send it to serialemsupport@colorado.edu. Framework files are available in the Frameworks folder on the download site. If there is a framework file customized for your scope, get that; otherwise get "GenericFramework.exe".

Extract the framework first. Accept the default location to extract to for a customized file; for GenericFramework.exe, be sure it is extracted to "C:\ProgramData" on Windows 7/10/Server 2008/Server 2012, or "C:\Program Files" for Windows 2000 and XP.

If you start with the GenericFramework.exe, get GenericProperties.txt from the Tools folder, rename it to SerialEMproperties.txt and replace the out-of-date one from the package. You can also get appropriate magnification table and camera property files from the Tools folder and insert them at the indicated places in SerialEMproperties.txt (see Starting with a Generic Properties File).

Run the SerialEM package file and extract to the default location; it will create a folder C:\Program Files\SerialEM\SerialEM_x-x-x with its contents.

Start the help by clicking on the file SerialEM.chm, or follow the links below to use the online help.

In the "General Topics" chapter, the following introductory sections are recommended reading before trying to set up the program:
     Introduction to SerialEM
     Mouse and Keyboard Controls
     Control Panels
     Image Acquisition from CCD Cameras and Direct Electron Detectors

Go to the section Setting Up SerialEM. Read and follow the procedures in Program Installation.

Read the section on A Minimal Setup Procedure, which you can follow on a relatively simple microscope if you want to get the program going quickly and start trying to work with it. Otherwise just slog through all of the Priority 1 and 2 setup procedures in order.

Upgrading

To upgrade, download the latest version and extract it. Open the new folder SerialEM_x-x-x within C:\Program Files\SerialEM and click on install.bat. (Right-click and Run as Administrator under newer Windows versions.) This will remove unneeded older files and copy needed ones into the upper directory. If you are connecting to DigitalMicrograph on a remote computer, it is also important to update the plugin on the other computer. See the section on Upgrading to a New Version in the Program Installation section of the help.

The installer lets you upgrade a 32-bit version to a 64-bit version on a 64-bit computer or switch back to a 32-bit version from a 64-bit version.

Packages Available Here

SerialEM install packages are available in three forms:

Shrmemframe packages are needed for aligning frames from a K2 or K3 camera with the CPU in SerialEM 3.7.

FrameGPU packages provide the optional module and CUDA runtime libraries for aligning frames from a K2/K3, Falcon, or Direct Electron camera with a GPU.

SerialEM License Terms

SerialEM is copyright (C) 2003-2019 by the Regents of the University of Colorado. See the file "Copyright.txt" for the full copyright notice and acknowledgements of other software used.

The SerialEM executable is open source under an MIT license, but the microscope and camera plugins to SerialEM are not open source. The software distributions containing these plugins are provided free for non-commercial purposes. By downloading these software packages, you agree that you will use it for research rather than commercial purposes, and that you will not distribute it outside of your own institution.

Stable Release Version - SerialEM 3.7

The stable release version receives only bug fixes and trivial modifications after it is first released. The higher the update number, the more mature it is. The previous update will usually be available here as well in case there is a problem with the latest update.

Previous Release Version - SerialEM 3.6

The previous release version is not updated after a new stable release. It will be the safest thing to use soon after a new stable release, but may contain bugs that have been fixed in newer versions.

Shrmemframe Packages

The Shrmemframe program is needed to use the CPU for aligning frames from a K2 or K3 camera with SerialEM 3.7. The program is included in the 64-bit SerialEM package and will be installed by the "install.bat" installer in that package when running on the K2 computer. However, you need to install one of the packages here separately in two cases:

  1. You are running SerialEM on a computer other than the K2/K3 computer.
  2. You are running a 32-bit version of SerialEM on the K2/K3 computer.

The packages here are for your convenience, to save you from copying multiple files from the SerialEM installation to a remote computer (their most likely use). They thus include the SEMCCD plugin to DigitalMicrograph, and you must pick the package that fits your GMS version:

FrameGPU Packages

These packages provide both the FrameGPU.dll module and the CUDA libraries needed for doing frame alignment with the GPU. The same files are used for aligning K2/K3 frames in the SEMCCD plugin to DigitalMicrograph and frames from a Falcon or Direct Electron camera in SerialEM itself. The packages have no default location to unpack to, so when you run one, you must select to unpack it in either C:\ProgramData\Gatan\Plugins (for a K2/K3 camera) or in the location where the SerialEM executable is (usually C:\Program Files\SerialEM) for Falcon and DE cameras.

Development/Beta Versions

Development versions of SerialEM are made available frequently. In general, you should try a development version only if you have a good mechansim for reverting to version you were using previously. That can be as simple as renaming the current executable or re-running install.bat in the previously used package folder.

These development beta versions come in two forms: just the executable SerialEM.exe, or a full installation package. A full package will have some difference in plugins or libraries since the stable release, and may or may not have plugin/library differences from previous beta packages. Check the README.txt file in the beta folder to see what beta package version, if any, is required to run the current SerialEM.exe. Often, when you have already installed the required beta package, you can simply substitute the SerialEM.exe and need not install the latest beta package. The beta folders may also have plugins that have changed since the last install package, but it is usually not necessary to update with these except to make a specific new feature work.

There may also be beta versions of the current stable release, with bug fixes since the last package was released. These are a lot safer to use, although sometimes a specific change still needs to be tested by the user who reported the bug. Changes in this version will marked as "(In 3.7)" in the development change list.

Other Files Available

Third party items are not available here.