Skip to content

Symmetry data and utilities related to crystallography and X-ray scattering

License

Notifications You must be signed in to change notification settings

Stianpr20/MaXrd

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

12 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MaXrd: Mathematica X-ray diffraction package

A comprehensive Mathematica package for crystallographic computations, MaXrd, has been developed. It comprises space group representations based on International Tables for Crystallography, volume A together with scattering factors from XOP and cross sections from xraylib. Featured functionalities include calculation of structure factors, linear absorption coefficients and crystallographic transformations. The crystal data used by MaXrd is normally generated from external cif files.

The package comes with a dynamic documentation seamlessly integrated with the Mathematica system, including code, examples, details and options. From the onset, minimal Mathematica experience is required to make use of the package. It may be a helpful supplement in research and teaching where crystallography and X-ray diffraction are essential. Although Mathematica is a proprietary software, all the code of this package is open source. It may easily be extended to cover user-specific applications.

The article Using Mathematica as a platform for crystallographic computing was published in the Journal of Applied Crystallography in February 2019 (Ramsnes, S., Larsen, H. B. & Thorkildsen, G. (2019). J. Appl. Cryst. 52, 214–218).

Getting started

Download

Clone or download the repository if you want to develop on the package.

If you want to use the package, download the latest (or desired) release (MaXrd_<version>.zip).

Installation

In the file menu in Mathematica, select File -> Install.... In the pop-up window select Application as the type of item to install and From File ... as the source. Select the downloaded zip file and click on OK. Wait for the extraction of files to be completed and restart Mathematica.

Using MaXrd

Load the package with:

<< MaXrd`

If you want MaXrd to launch automatically on startup, first open the Wolfram Language Documentation Center. This can be done from the file menu: Help -> Wolfram Documentation. Scroll to the bottom and click on Add-ons and Packages. Click on the triangle next to MaXrd to open the cell and then the same for Manage. Make sure the option Startup is selected.

To access the package documentation, open the Wolfram Documentation in Mathematica after installing it and search for «MaXrd» or any related content.

Note on version compatibility

The latest version of MaXrd is 1.5.1 which is compatible with Mathematica version 11.3 and above.

It is technically compatible with Mathematica version 10.3 with regards to functionallity, but the documentation will appear broken.

Contact

Any comments or feedback is welcome. E-mail stian.p.ramsnes@uis.no or submit an issue in the repository.