• 设为首页
  • 点击收藏
  • 手机版
    手机扫一扫访问
    迪恩网络手机版
  • 关注官方公众号
    微信扫一扫关注
    公众号

Exabyte-io/materials-designer: A standalone React.js/Redux based web application ...

原作者: [db:作者] 来自: 网络 收藏 邀请

开源软件名称(OpenSource Name):

Exabyte-io/materials-designer

开源软件地址(OpenSource Url):

https://github.com/Exabyte-io/materials-designer

开源编程语言(OpenSource Language):

JavaScript 85.5%

开源软件介绍(OpenSource Introduction):

npm version License: Apache

Materials Designer

This a standalone react/redux application for atomistic material structures design. Used within the Exabyte.io platform as explained in the corresponding part of its documentatation here.

Materials Designer in action

Functionality

As below:

  • Input/Output Menu

    • Export materials in JSON/POSCAR formats
  • Edit Menu

    • Undo/Redo/Reset/Clone operations
  • View

    • Fullscreen mode
  • Advanced Menu

    • Creating supercell
    • Creating combinatorial set
    • Creating interpolated set
    • Creating surface/slab
  • Basis Editor

    • Adding/Removing/Modifying sites
    • Adding/Removing/Modifying atomic constraints
    • Switching Crystal/Cartesian units
  • Lattice Editor

    • Adjusting lattice units/types/parameters
  • 3D Editor

    • Visualizing materials
      • Rotation
      • Repetition/Radius
      • Toggle axes
    • Adjusting materials
      • add/remove/select atoms

Installation

Run with Node v12.21.0, tested with Node v8.11.4. The corresponding version(s) of npm should be fine, tested with v6.4.1. We recommend using nvm for version management.

Materials Designer can be installed from source as follow:

git clone [email protected]:Exabyte-io/materials-designer.git
cd materials-designer

sh run-application.sh

Open http://localhost:3001 to view the application in the browser.

Development

Execute the following commands when running the application in development mode.

npm install
npm start

Tests

Start the application and then run one of the below commands to run the tests.

To run all tests:

sh run-tests.sh

To run a specific test feature, pass it's relative path as option:

sh run-tests.sh -f=menu/advanced/create-supercell.feature       # to run a specific test

TODO list

Desirable features/fixes for implementation:

  • add tests for all the functionality listed above. We only tests advanced operations at current.
  • switch color back to white when the material is back to original after editing
  • add logic for Interstitials, Vacancy concentrations in combinatorial sets
  • fix modal dialog exceptions for AdvancedGeometryDialog
  • add line numbers to SourceEditor
  • remove updateIndex action when index is the same
  • show the total number of materials in set and the current index
  • fix fullscreen support

Dependencies

This package depends on Made.js and Wave.js. See package.json for the full list.

Links

  1. Create React App, GitHub Repository

CI Docker files

There are two docker files used for testing in CI. In principle, we could use more targeted base images for the use case (e.g. node or selenium images), but we want to verify correct behavior on a specific CentOS version. The first dockerfiles/centos/Dockerfile builds and runs the application. The second dockerfiles/test/Dockerfile provisions and runs the tests. The test image uses the centos image as a base and is related by the entrypoint.sh script. It is targeted for CI so if you are editing the entrypoint.sh you may need to re-build both containers for your changes to work. It can also be useful to comment out the ENTRYPOINT in the centos dockerfile as well as the CMD in the test dockerfile in order to easily run and debug both containers. There is also a docker-compose.yml file which can be used for local building and testing. Provided docker-compose is installed, it can be used like so:

docker-compose build materials-designer
docker-compose build materials-designer-test

docker-compose up -d materials-designer
sleep 30  # let the app actually start
docker-compose run materials-designer-test



鲜花

握手

雷人

路过

鸡蛋
该文章已有0人参与评论

请发表评论

全部评论

专题导读
热门推荐
阅读排行榜

扫描微信二维码

查看手机版网站

随时了解更新最新资讯

139-2527-9053

在线客服(服务时间 9:00~18:00)

在线QQ客服
地址:深圳市南山区西丽大学城创智工业园
电邮:jeky_zhao#qq.com
移动电话:139-2527-9053

Powered by 互联科技 X3.4© 2001-2213 极客世界.|Sitemap