.. vestacrystparser documentation master file, created by
   sphinx-quickstart on Thu Jul 24 17:08:06 2025.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

vestacrystparser documentation
==============================

**vestacrystparser** is an unofficial general-purpose parser for
`VESTA <https://jp-minerals.org/vesta/>`_ crystal visualisation files.
It provides a programmatic API for creating and modifying VESTA files.
It is intended to enable creating consistent visualisation states in bulk,
removing the tedium of manually adjusting settings via the GUI.

Check out the :doc:`usage` section for further information, including
how to :ref:`install <installation>` the project.

.. toctree::
   :maxdepth: 2
   :caption: Contents:

   usage
   api
   file_format
   contributing