SUZU

version 0.2.0

Apr 4, 2014

Takaaki AOKI (aoki@sakura.nucleng.kyoto-u.ac.jp)

Japanese

About SUZU

SRIM (http://www.srim.org/) is the most famous software to simulate the trajectroy and radiation effects of energetic particles in various materials. SRIM is equped with well-made GUI program for parameter setup (TIN.exe), however, it cannot run correctly on the Windows OS based multibyte characters, such as Japanese. SUZU (a japanese tranlation of tin :-) is aimed to be a gui program with compatible functions to tin.exe and run on multilingual windows (and possibly other OS platforms).

Download

Distributed packages

installation packages are availabel at http://sakura.nucleng.kyoto-u.ac.jp/~aoki/suzu/dist

the directory includes several types of package. See Install & Run section.

  • suzu-(version)-win32.exe

    Windows 32bit standalone

  • suzu-(version)-win-amd64.exe

    Windows 64bit standalone

  • suzu-(version).zip

    installer for standard python environment

    use 'setup.py install', 'easy_install', or 'pip'

Source code repository

Source code is maintaned at http://sakura.nucleng.kyoto-u.ac.jp/~aoki/hg/suzu

Code is managed using mercurial (http://mercurial.selenic.com/). So you can access the latest source code set by ...

hg clone http://sakura.nucleng.kyoto-u.ac.jp/~aoki/hg/suzu

Install & Run

For windows, two options are available to setup this program. The second option is also available for unix or mac user.

Option 1: Use standalone package (for Windows)

  1. Download Standalone package
Download suzu-(version)-win32.exe, or suzu-(version)-win-amd64.exe, and run it. Softwares are expanded at appropriate place, such as C:\Program Files\suzu, and the shortcut is added on the start menu.
  1. Run
Find and Double-click suzu.exe

Option 2: Install as python script and package

The second option is installing suzu as a package of python library

Environment

version >= 0.1.0 is developed to run on python 3.3.5 (or above). Setup python core program from http://www.python.org/

Install from source code

  1. Download package archive suzu-(version).zip
  2. If you have already installed easy_install or pip, run
easy_install suzu-(version).zip

, or

pip install suzu-(version).zip

(If you do not have easy_install nor pip, expand above package archive and find setup.py. Then,)

python setup.py install

Run

  • type suzu.py in command prompt
  • or, find suzu.py using explore (i.e. C:\Python33\Script\suzu.py) and double-click it.

Usage

[Save (&Run Trim)]

Fill parameters as you like and push [Save (& Run Trim)] button.

When you save the data with the filename of 'TRIM.in' and you put it in the same folder where TRIM.exe exists (== where SRIM is setup), a dialog window pops-up to confirm run TRIM.exe calculation with this new TRIM data.

[Load .json]

Currently suzu cannot parse TRIM.in format directly, but suzu saves TRIM.in.json data with TRIM.in simultaneously. You may load this .json file by [Load .json] button.

[Validate]

[Validate] button tests a contents of widgets. This validation routine also runs before [Save (&Run Trim)] action.

Note

Validation does not run automatically. The user should push [Validate] button explicitly to confirm the modification on GUI is correct or not.

[Compound DB]

[Compount DB] button is placed at target layer frame. This button provides an access to the compoond database given by SRIM. At database dialog, indicate the path to compound.dat (usually, [SRIM INSTALL PATH]/DATA/Compound.dat). You may construct your own database.

Other Buttons

[Set Example] [Dump to Console] [Clear] buttons still remains for debugging.

More Information

Detail information especially for developers are found in dummy_tin/doc/* (python script package).

Bugs, issues, discussion for developers

The author is pleased to here bug & issue reports and suggest & request for the software.