Skip to main content

v_ase logo

v_ase

PyPI version Python versions Documentation Status License: AGPL v3+

Documentation · PyPI · Changelog · Issues · Software paper and LaTeX source

0.3.5 · Coordination polyhedra · Changes

An ASE-native workspace for building, editing and visualizing atomic structures, trajectories and volumetric data.

Phosphorene nanoribbon manipulation

Installation And Launch

python -m pip install v_ase-gui
v_ase gui POSCAR

Use v_ase gui for an empty workspace or --interactive to edit a file. Installation · First session · Supported formats · Troubleshooting

Explore

Work with Guide
Atoms and molecules Move · Rotate · Build
Periodic interfaces Cells, matching, registry
Trajectories and fields Analysis · Volumetric data
Figures and projects Appearance · Export
AI agents MCP setup · GUI/MCP comparison
Numerical methods Validation · Source audit

Save And Share

One HTML file for offline viewing and project recovery. Project HTML · Export HTML View

A self-contained v_ase HTML project with a static preview and offline 3D interaction

Work With An AI Agent

You and an external agent edit the same live document. Connect MCP · Scene workflow · CLI compatibility

ChatGPT Chat setup · personal connection.

Human and external AI agent working in one live v_ase document

python -m pip install "v_ase-gui[mcp]"
v_ase mcp

60-run comparison: MCP completed 30/30 strict targets; GUI completed 24/30. Images, token usage and success criteria

A natural-language request passing through an external AI Agent into the same live revisioned v_ase GUI

Exact atom edits from a natural-language request. Agent workflow · Bundled Skill

Natural-language pyridinic N3 graphene edit in the shared GUI

Edit Structures

Select atoms, then use G to move, R to rotate and S to scale coordinates. Editing guide · Controls

Build From Scratch

Define a cell and distribute atoms; refine overlaps with repulsion. Atomic distributions · ASE crystal builder

Building an amorphous structure from an empty v_ase document

Add Atoms

Set composition, density, placement and allowed regions. Insertion workflow

Oxygen distributed through a bulk-like Cu(111) insertion region

Add Molecules

Place rigid molecules around an existing structure. Molecular insertion

Rigid water molecules placed around edge- and basal-hydroxylated graphene-oxide layers

Rotate Selected Atoms

Rotate around an active atom, center of mass or explicit pivot. Pivot controls

Ferrocene pivot rotation

Build a phosphorene twist through successive selections and rotations. Worked examples

Cumulative phosphorene manipulation

Periodic Cells And Interfaces

Commensurate Cells

Find compatible 2D cells within declared strain and search limits. Same-lattice matching

Graphene hBN commensurate rotation

Match separate host and guest lattices. Host/guest workflow

Graphene and MoS2 host/guest common-cell search with a live angle plane

Rigid Translation

Map registry or relax a selected rigid component. Registry maps · Rigid relaxation

Periodic planar translation scan with current and optimum translations

Rigid planar translation trials without a precomputed colorscale map

Analyze Structures And Fields

Ordered Geometry

Select 2, 3 or 4 atoms for distance, angle or torsion. Measurements

Ordered distance angle and torsion measurement

Trajectories And Displacement

Scrub frames and inspect displacement against a reference. Trajectory analysis

Trajectory displacement analysis

Map Per-Atom Data

Color atoms by stored properties and display force vectors. Colorscales · Forces

Trajectory-wide force-magnitude colorscale with locked limits and matching Cartesian force vectors

Volumetric Fields

Inspect charge, potential and orbital grids as isosurfaces or planar sections. Isosurfaces · Planes · Combine fields

Signed isosurface threshold moving across a fixed volumetric distribution

Interactive hkl scalar-field plane clipped to the displayed cell

Radial And Pair-distribution Functions

Plot periodic RDFs or finite pair distributions with the appropriate normalization. RDF guide

Pairwise amorphous Cu-Zr RDF curves approaching the bulk limit

Constraints And Relaxation

Constrain physical motion using ASE constraints. Constraint guide

FixedLine

Restrict motion to a line. Details

FixedLine movement

FixedPlane And FixScaled

Restrict motion in Cartesian or fractional directions. FixedPlane · FixScaled

FixedPlane movement and guide plane

Hookean

Apply spring-like restraints. Details

Hookean constraint

Hookean motion

Relaxation

Reduce overlaps or optimize with a configured calculator. Repulsion · Run relaxation

Repulsive relaxation trajectory

Coordination Polyhedra

Color coordination cages and adjust opacity by element, label, or atom group. Polyhedra guide

IrO2 coordination polyhedra with independent colors and face opacity

Style Atoms, Bonds, And Rendering

Control colors, radii and visibility by label or atom index. Appearance

View-mode label and appearance editing on Cu5O4

Choose Standard, Metal, Rubber or flat 2D rendering. Materials and rendering

Standard Metal and Rubber atom materials

Set bond topology and appearance by pair or exact atom indices. Bond controls

Pairwise Cu O bonds in a Cu2O(111) film on Cu(111)

Export And Save

Images and video · Render Area · Blender / OBJ / Rhino · Projects and presets

Python And Remote Systems

from ase.build import molecule
from v_ase import view

view(molecule("H2O"))

Python API · Jupyter · SSH / remote files

License And Citation

AGPL-3.0-or-later · Three.js MIT license · Cite v_ase

Release files for v-ase-gui 0.3.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for v-ase-gui 0.3.5
File Size Uploaded
v_ase_gui-0.3.5.tar.gz 30.3 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for v-ase-gui 0.3.5
File Interpreter ABI Platform
v_ase_gui-0.3.5-py3-none-any.whl Python 3 none any Details

Total release size: 36.8 MB

Release files / v_ase_gui-0.3.5.tar.gz

Download URL v_ase_gui-0.3.5.tar.gz
Size 30.3 MB
Tags Source
SHA-256 checksum
How to use checksums
8cd12fb5b10f1200a64fb1b796b582f9490097168296211b5b1b100641f37804
BLAKE2b-256 checksum
How to use checksums
9c3103303a4c6a3d73d5b57b2f86063e3b0b9003a1b66b035898110a1f9a7a64
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release files / v_ase_gui-0.3.5-py3-none-any.whl

Download URL v_ase_gui-0.3.5-py3-none-any.whl
Size 6.5 MB
Tags Python 3
SHA-256 checksum
How to use checksums
dff82b3275bdaa22f18ca05ad0f44ea422a373f12db965a96e31f7a05241b911
BLAKE2b-256 checksum
How to use checksums
113ec6e1497913263941cfbb3aa68a4eafbdc53ca4c82746bfefe9b7c89f18a3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release history Release notifications | RSS feed

0.4.7

2 release files

0.4.6

2 release files

0.4.5

2 release files

0.4.4

2 release files

0.4.3

2 release files

0.4.2

2 release files

0.4.1

2 release files

0.3.8

2 release files

0.3.7

2 release files

0.3.6

2 release files

This release

0.3.5 This release

2 release files

0.3.4

2 release files

0.3.3

2 release files

0.3.2

2 release files

0.3.1

2 release files

0.2.35

2 release files

0.2.34

2 release files

0.2.33

2 release files

0.2.31

2 release files

0.2.30

2 release files

0.2.29

2 release files

0.2.28

2 release files

0.2.27

2 release files

0.2.26

2 release files

0.2.25

2 release files

0.2.24

2 release files

0.2.23

2 release files

0.2.22

2 release files

0.2.21

2 release files

0.2.20

2 release files

0.2.19

2 release files

0.2.18

2 release files

0.2.17

2 release files

0.2.16

2 release files

0.2.15

2 release files

0.2.14

2 release files

0.2.13

2 release files

0.2.12

2 release files

0.2.11

2 release files

0.2.10

2 release files

0.2.9

2 release files

0.2.8

2 release files

0.2.7

2 release files

0.2.6

2 release files

0.2.5

2 release files

0.2.4

2 release files

0.2.3

2 release files

0.2.2

2 release files

0.2.1

2 release files

0.1.18

2 release files

0.1.17

2 release files

0.1.16

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.0.99

2 release files

0.0.98

2 release files

0.0.97

2 release files

0.0.96

2 release files

0.0.95

2 release files

0.0.94

2 release files

0.0.93

2 release files

0.0.92

2 release files

0.0.91

2 release files

0.0.90

2 release files

0.0.89

2 release files

0.0.88

2 release files

0.0.87

2 release files

0.0.86

2 release files

0.0.85

2 release files

0.0.84

2 release files

0.0.83

2 release files

0.0.82

2 release files

0.0.81

2 release files

0.0.80

2 release files

0.0.79

2 release files

0.0.78

2 release files

0.0.77

2 release files

0.0.76

2 release files

0.0.75

2 release files

0.0.74

2 release files

0.0.73

2 release files

0.0.72

2 release files

0.0.71

2 release files

0.0.69

2 release files

0.0.68

2 release files

0.0.67

2 release files

0.0.66

2 release files

0.0.65

2 release files

0.0.64

2 release files

0.0.63

2 release files

0.0.62

2 release files

0.0.61

2 release files

0.0.60

2 release files

0.0.59

2 release files

0.0.58

2 release files

0.0.57

2 release files

0.0.56

2 release files

0.0.55

2 release files

0.0.54

2 release files

0.0.53

2 release files

0.0.52

2 release files

0.0.51

2 release files

0.0.50

2 release files

0.0.49

2 release files

0.0.48

2 release files

0.0.47

2 release files

0.0.46

2 release files

0.0.45

2 release files

0.0.44

2 release files

0.0.43

2 release files

0.0.42

2 release files

0.0.41

2 release files

0.0.40

2 release files

0.0.39

2 release files

0.0.38

2 release files

0.0.37

2 release files

0.0.36

2 release files

0.0.35

2 release files

0.0.34

2 release files

0.0.33

2 release files

0.0.32

2 release files

0.0.30

2 release files

0.0.29

2 release files

0.0.28

2 release files

0.0.27

2 release files

0.0.26

2 release files

0.0.25

2 release files

0.0.24

2 release files

0.0.23

2 release files

0.0.22

2 release files

0.0.20

2 release files

0.0.19

2 release files

0.0.18

2 release files

0.0.17

2 release files

0.0.16

2 release files

0.0.15

2 release files

0.0.14

2 release files

0.0.13

2 release files

0.0.9

2 release files

0.0.8

2 release files

0.0.7

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page