TSRI

MGLTools

Standalone Packages

Overview

Follow these instructions very carefully to get up and running with ePMV as a plugin for your favorite professional 3D animation application. 
 
Once installed, ePMV will extend any of the following professional 3D applications with a multitude of powerful scientific algorithms, save you loads of time, and greatly simplify your workflow.
If you encounter any problem please contact us.

    Host software Pros and Cons:

  • Blender 2.49b 
    • Preferred by scientists because it is completely open-source and powerful. 
    • Con– the interface is notoriously difficult.
  • Blender 2.58x and 2.60
    • Nicer interface than 2.49 and some powerful features.
    • Con– the more attractive interface is still very tricky to learn.
  • MaxonCinema4d r12–r14
    • Preferred by Medical Illustrators. 
    • Powerful commercial package that is famous for its intuitive interface and general ease of use.
    • It can't be over expressed how much easier C4D is to use compared to the other packages- makes it worth the cost for most users.
    • Cons– C4D is not cheap, even for academics pricing ~$900 US from maxon.net for an unlimited time and ~$300 from other academic software companies for a 3 year lease. Please write maxon to plead for better academic pricing (i.e., free)!
      • Maxon has started an educational program available this coming fall!
    • Cons– No longer available for Linux.
  • Autodesk Maya 2011-2013
    • Unlimited power
    • The workhorse of Hollywood. 
    • Con– not cheap in the real world, but available free to academics for 3 years as of Spring 2011!
    • Con– this massive application has a steep learning curve that takes a career to master.


Install a Host: Own or Install a Professional 3D Software Package

The Blender installation includes a copy of Blender with ePMV preinstalled, just follow instructions below.
Unless you already have an appropriate copy of Cinema 4D, or MAYA installed, you'll need to install an appropriate version one of these packages now: 
MAYA2013 is arguably the most powerful package. It is the workhorse of Hollywood animation studios, but has a steep learning curve.
Cinema 4D (C4D v 12–14) is used by most medical illustrators. It is powerful, easy to learn and is enriched by a community of medical illustrators that strives for scientific accuracy. Although its not free, we use C4D in our tutorials and classrooms because it boasts the most intuitive interface that leads to a relatively pleasant experience for 1st time 3D exposure. You can download and install a demonstration version for free from maxon.


Blender 2.49b

We have prepared a complete package for blender 2.49b for all platforms:

1) Download for your architecture:
    Windows
        - epmv-blender-2.49b-windows32_VC.zip             requires Python2.6.6_32 (Note: Work also nicely with wine )
        epmv-blender-2.49b-windows64_VC.zip             requires Python2.6.6_64   
    Mac OS
        - epmv-blender-2.49b-OSX-10.5-py2.5-intel.zip    a version of Python2.5 may be required
    Linux
        - epmv-blender2.49b-i386-linux-py25.zip              unzip and run epmv-blender bash script (Note :You may need to change the script directory from the blender preference)
        - epmv-blender2.49b-x86_64-linux-py25.zip         unzip and run epmv-blender bash script (Note :You may need to change the script directory from the blender preference)

2) Extract and launch ePMV through Script->System->ePMV

3) Follow the quick start page for a very basic introduction to get a molecule into your scene. 

4) Follow the tutorial pages to learn all the tools you'll need to complete more interesting projects.

Blender 2.60a

Still EXPERIMENTAL.
1) Download for your architecture:

    Mac OS
        - Blender-2.60a OSX 10.5 i386           32bits  unzip & launch blender.app
        - Blender-2.60a OSX 10.5 x86_64      64bits  unzip & launch blender.app
    Linux
        Blender-2.62-linux-glibc27-i686        32bits 
unzip & run epmv-blender bash script, or type "source setenvTk.sh" bash script to configure the library path to Tk,
            then run with ./blender
        Blender-2.62-linux-glibc27-x86_64    64bits  unzip & run epmv-blender bash script, or type "source setenvTk.sh" bash script to configure the library path to Tk,
            then run with ./blender

    Windows
        - Blender-2.62-win32                         32bits  unzip and launch blender.exe. Note : APBS extension is not working yet for this version.
        - Blender-2.62-win64                         64bits  unzip and launch blender.exe. Note : APBS extension is not working yet for this version.


2) Activate the plugin:
    -> File ->User Preferences
    -> click on the Add-Ons Tab
    -> click on System
    -> click on the litlle check box next to ePMV
    -> File -> Save User Setting

4) Launch epmv from the epmv icon or using the "Add->ePMV" menu item.
    ePMV will appear in the Object Tool shelf on the left of the 3dViewport.

5) Follow the quick start page for a very basic introduction to get a molecule into your scene.

6) Follow the tutorial pages to learn all the tools you'll need to complete more interesting projects.




Cinema4D R12, R13, and R14

1) Download ePMV for your operating system and C4D version:
    Mac:
        - epmv-C4D-mac.zip
            Note : this package includes both 32bits and 64bits
                and works with R12, R13 and R14.
            The 64bit only works for SnowLeopard (OS10.6.x) and
                the current Mac OS, Lion (OS10.7.x)
    Windows:
        - epmv-C4D-win.zip
            Note : this package includes both 32bits and 64bits
                and works with R12 and R13 (not yet tested on R14).
        - epmv-C4Dr13-win.zip
            Note : this package includes both 32bits and 64bits and works only with R13 (not yet tested on R14). 
            It is a package of lower size and only patch the python dll file. 
            If you get trouble using it, use the r12 & r13 version above.

2) Launch Cinema4D

3) Locate your Cinema4D preferences folder
    Note: On OS10.7 (Lion), you'll have to reveal your Library folder
        (Apple brilliantly hides it in the newer operating systems).
    1) In Cinema 4D's menu, go to Edit->Preferences
    2) Click [Open Preferences Folder] button
        You'll see the Preferences window now open on your desktop with a name similar to:
            /Users/<username>/Library/Preferences/MAXON/CINEMA 4D R13_AB12BC3E/  (the number at the end will be different and may also say R12)

4) Close Cinema4D

5) Drag and drop the extracted folder into the plugins folder of your Cinema4D preferences folder (get correct folder with step 3):
    Mac:
        1) The extracted archive contains a folder called ePMV-Mac with another folder inside called ePMV
        2) Drag the ePMV folder out of ePMV-Mac and place it into your Cinema4D preference plugin folder:
            /Users/<username>/Library/Preferences/MAXON/CINEMA 4D R1<2or3>_<yourSpecificID>/plugins/
        3) To fix a small temporary glitch in the extracted folder, you may need to fix the permissions:
            1) Using your System Finder, Get Info on the entire C4D prefs folder.
            2) Unlock the lock in the lower right of the GetInfo window.
            3) At the bottom of the get info window, set permissions for your UserName (or Everybody if on your own safe computer) to "Read and Write"
            4) Click the little cog and choose "Apply to enclosed items" and accept the popup.

    Windows Cinema4D R12:
        1) Using Explorer, extract the content of the archive you downloaded above. 
        2) The archive expands to a folder called ePMV-Win that contains two subfolders called ePMV and resources
        3) Copy the folder ePMV from ePMV-Win into your Cinema4D preferences plugin folder:
                Find the folder by opening Cinema 4D
                In Cinema 4D's menu, go to Edit->Preferences
                Click [Open Preferences Folder] button
                    You'll see the Preferences window now open on your desktop with a name similar to:
                    C:\Documents and Setting\$username\Application Data\MAXON\CINEMA4D R12\plugins
                    now becomes
                    C:\Documents and Setting\$username\Application Data\MAXON\CINEMA4D R12\plugins\ePMV
        4) Go to your Cinema4D program folder, e.g. C:\Program Files\MAXON\CINEMA 4D\resource\modules\python\res\
            - rename Python.win32.framework to Python.win32.framework.old
            - rename Python.win64.framework to Python.win64.framework.old
        5) Copy the downloaded folders:
            Python.win32.framework
            Python.win64.framework
            from your downloaded resources\module\python\res\ folder into the Cinema4D program
                folder, e.g. C:\Program Files\MAXON\CINEMA 4D\resource\modules\python\res\
         The new versions of the Python framework folders should sit next to the .old versions of the folders
         (this will overwrite the python framework if you didnt follow step 4 by setting the original folders to .old)

    Windows Cinema4D R13:
        1–3) Follow steps 1–3 for Windows Cinema4D r12 above.
        4) Go to your Cinema4D program folder, e.g. C:\Program Files\MAXOB\CINEMA 4D R13\resource\modules\python\res\
            - Go into the Python.win32.framework folder and rename python26.dll to python26.dll.old
            - Go into the Python.win64.framework folder and rename python26.dll to python26.dll.old
        5) Copy the downloaded file 
resources\module\python\res\Python.win32.framework\python26.dll
            and paste into C:\Program Files\MAXOB\CINEMA 4D R13\resource\modules\python\res\Python.win32.framework\
        6) Copy the downloaded file resources\module\python\res\Python.win32.framework\python26.dll
            and paste into C:\Program Files\MAXOB\CINEMA 4D R13\resource\modules\python\res\Python.win64.framework\
        The new versions of the python26.dll files should sit next to the .old versions of the files
        (this will overwrite the python26.dll files if you didnt follow step 4 by setting the original folders to .old)

6) Restart Cinema4D 

7) Launch ePMV, it should now be available from C4D's main menu bar under Python->plugin->ePMV
    Note : This version of ePMV work with both 32 and 64bit mode of Cinema4D

8) Spent a few minutes to follow some basic tutorials to get up and running, or just click [Fetch], zoom in, and start playing with buttons
     
9) Follow the quick start page for a very basic introduction to get a molecule into your scene.
 
10) Follow the tutorial pages to learn all the tools you'll need to complete more interesting projects.



Autodesk Maya 2011 - 2012 - 2013

1) Download ePMV for Mac or Windows
    Choose 32 or 64 bit appropriate to your Maya architecture (open Maya and click Maya>about Maya to see what you run)
    Mac:
    The same archive (2011, works for Maya 2011, 2012, and 2013 on a Mac)
    The 64bit version only works for SnowLeopard (OS10.6.x) and Lion (OS10.7.x) operating systems on the Mac.

    Windows:
    Only available for 2011/2012 and 2013.
2) Place the extracted folder in your Maya preferences folder:
    Mac:
    The archive contains a plug-ins folder with an epmv_maya_plugin.py file and a MGLToolsPckgs folder, place these items into either/both folders below:
        /Users/<username>/Library/Preferences/Autodesk/maya/2013/plug-ins/        (or /2011 or 2012)
        /Users/<username>/Library/Preferences/Autodesk/maya/2013-x64/plug-ins/  (or /2011-x64 or 2012-x64)
    The archive also contains a prefs folder with icons and shelves folders, place these two into either/both folders (replacing them), 
    or move their contents into the existing folders to retain your original prefs:
        /Users/<username>/Library/Preferences/Autodesk/maya/2013/prefs/            (or /2011 or 2012)
        /Users/<username>/Library/Preferences/Autodesk/maya/2013-x64/prefs/      (or /2011-x64 or 2012-x64)

    Windows:
    Windows Maya preferences are in your documents folder, e.g.: 
       C:\Users\<username>\Documents\maya\2012
       C:\Users\<username>\Documents\maya\2012-x64
    The archive contains a plug-ins folder with an epmv_maya_plugin.py file and a MGLToolsPckgs folder, place these items into either/both folders below:
       C:\Users\<username>\Documents\maya\2012\plug-ins\       (or /2011 or 2013)
       C:\Users\<username>\Documents\maya\2012-x64\plug-ins\ (or /2011-x64 or 2013-x64)
    The archive also contains a prefs folder with icons and shelves folders, place these two into either/both folders (replacing them), 
    or move their contents into the existing folders to retain your original prefs:
       C:\Users\<username>\Documents\maya\2012\prefs\       (or /2011 or 2013)
       C:\Users\<username>\Documents\maya\2012-x64\prefs\ (or /2011-x64 or 2013-x64)

3) Start Maya (or restart)

4) If necessary, activate the plugin with the plugin manager:
    a. 1st, look for it first in the custom shelf:
        
        
    b. If you don't see the ePMV icon in the shelf, then activate it with the plugin manager:
        1. Maya Menu >Window> Settings/Preferences>Plug–in Manager
        2. Find epmv_maya_plugin.py in the list and check both [√] Loaded and [√] Auto load
        3. Restart Maya

5) Launch ePMV from the icon that should appear in the custom shelf

6) Follow the quick start page for a very basic introduction to get a molecule into your scene.

7) Follow the tutorial pages to learn all the tools you'll need to complete more interesting projects.

Autodesk 3D Studio Max 2013 - 64bits

Please visit the 3D Studio Max installation page of the autoPack website and follow the instructions to install ePMV and autoPack with a single installer.


Comments