Marlowe User Interface (MUI)

version 0.2.3

Julu 1, 2014

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

About Malouwe User Interface

Marlowe User Interface (MUI) is support program for marlowe (a binary collision simulator, http://www.oecd-nea.org/tools/abstract/detail/psr-0137/) to desgin input data.

Download

Distributed packages

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

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

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

    Windows 64bit standalone

  • marlowe_ui-(version)-win32.exe

    Windows 32bit standalone

Python library and scripts for Unix and Mac are available at PyPI http://pypi.python.org/pypi/marlowe_ui/

Source code repository

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

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/marlowe_ui

Install & Run

For windows, two options are avaliable 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 marlowe_ui-(version)-win32.exe, or marlowe_ui-(version)-win-amd64.exe, and run it. Softwares are expanded at appropriate place, such as C:\Program Files\marlowe_ui, and the shortcut is added on the start menu.

  2. Run

    Find and Double-click mui.exe

Option 2: Install as python script and package

The second option is that install marlowe_ui programs as package of python library

Environment

MUI 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

Package sources is available at PyPI (https://pypi.python.org/pypi/marlowe_ui). If you have already installed easy_install or pip, run

easy_install marlowe_ui

, or

pip install marlowe_ui

otherwise, download and expand marlowe_ui-(version).zip, and

python setup.py install

Run

  • type mui.py in command prompt
  • find mui.py using explore (i.e. C:\Python33\Script\mui.py) and click it.

Usage and current limitation

Fill parameters as you like and push [Save] button.

[Save (& run)]

Save widget contents for both marlowe input data (usually having .dat extension) file and .json format. The .json file can be loaded by [load .json] button.

When parameter file is saved correctly, then a dialog to run marlowe program will pop-up.

[Load .json]

Currently, mui.py cannot load marlowe data format yet, but allows to load data file in JSON format created by above [Save (& run)] command.

[Validate]

[validate] button tests widget contents (if a content of widget is not valid the widget turns red) This validation routine also runs before [Save (& run)] action.

Note

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

Other Buttons

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

More Information

Detail information especially for developers are found in marlowe_ui/doc/*

Bugs, issues, discussion for developers

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