Skip to content

odarbelaeze/vegas-lattice-rs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

vegas-lattice-rs

Crates.io Build Status Documentation DOI

A little tool to build lattices and samples out of patterns written in rust.

Installation

vegas-lattice-rs can be used as a standalone executable in order to build yourself some lattices and otherwise it can be used as a rust crate (library). If you have cargo installed in your system, you can grab the executable from crates.io using:

cargo install vegas-lattice

after runing that you will have an executable vegas-lattice in your system that will run as expected.

If you intent to use it as a library just add the the following line to your Cargo.toml:

vegas-lattice = "*"

Pin it at will when you're done, since this is an actively developed package.

Usage

I'd recommend to alias vegas-lattice to something shorter, since the pipelines can get really complex real quick.

alias vl=vegas-lattice

Now, lets write a basic example,

vl bcc \
    | vl expand --along-x 10 --along-y 10 --along-z 5 \
    | vl alloy A Fe+ 50 Fe 50 \
    | vl alloy B Fe+ 50 Fe 50 \
    | vl into xyz

This command will create a 10x10x5 bcc lattice, and will turn half the iron sites into iron + and after that it will transform the lattice into an xyz file representation.

Notice that you can pipe the output of one command to the next one using the standard io.