Quick start guide
First-time initialization instructions
-
Contact support (antti (at) smeklab.com) to obtain your licence and download instruction.
-
Download and unzip the toolbox
- Add EMDtool (with all subfolders) to your Matlab path
- e.g.
addpath(genpath('C:/path_to_folder/EMDtool'))
- or add permanently via
startup.m
- e.g.
- Activate your license
emdtool.load_license('license_file_name.lic')
- (OPTIONAL:)(But preferred) Download and unzip the free
gmsh
mesh generator for your operating system- Downloads page
- Please do recognize that
gmsh
is a separate software, governed by its own license agreement, only interfaced byEMDtool
via a limited-functionality file interfaced - If you require other mesh generators, or wish to use
EMDtool
’s own development-version mesh generator, please enquire via email
- (OPTIONAL:) Setup gmsh path, e.g.
emdtool.set_gmsh_path('C:/Programs/gmsh/')
- see
help emdtool.set_gmsh_path
- see
Usage instructions
- Add EMDtool to your Matlab path (see 3. above)
- Do check out the
EMDtool
familiarization exercises. - Analyze away!
- see
Examples/readme.m
+ example scripts for more detailed examples
- see
Where to find information?
Wondering how to do something? Please see if one of the following bullets helps:
- See the documentation for a specific
EMDtool
class or functionality by either typinghelp classname
orhelp classname.method_name
in the Matlab command prompt, or by checking up the corresponding documentation here online.- The search bar on the top of the page is super-helpful.
- See EMDtool briefly for a brief overview
- Again, do check out the
EMDtool
familiarization exercises. - See the frequently asked questions page
- Read the quick notes
Downloading a new version?
-
Download
-
Unzip
-
Add the new version to the path.
Indeed, you can easily switch between versions by simply adding and removing versions from the Matlab path. It’s a good idea to call restoredefaultpath
and clear classes
inbetween, though.
Occasionally, Matlab
can be very obstinate about using old implementations of some classes, even if they have been nominally removed from the path. This can be verified by typing open <ClassName>
in the command window, to open the class file (or its docfile, in case of .p-files) in the editor, and then checking if its path is old_version/EMDtool/ClassName.m
instead of new_version/EMDtool/ClassName.m
. Fear not - this is nothing that a good o’ restart (of Matlab) won’t fix.
NOTE: Loading objects made with different EMDtool versions may lead to unexpected behaviour.