cfiles, tools for chemistry files analysis
cfiles is a collection of post-processing algorithms for molecular or quantum
chemical simulations. It offer both data managing capacities and analysis of
cfiles is implemented using the chemfiles library for
reading and writing trajectory data.
You can ask questions about cfiles in the chat, or in github issues.
- Radial distribution functions;
- Density profiles;
- Angles and dihedral angles distributions;
- Hydrogen bonds detection.
- Convert from one file format to another;
- Merge multiple trajectories in one file.
Get it, build it
To build it you can run
git clone --recursive https://github.com/chemfiles/cfiles cd cfiles mkdir build cd build cmake .. make
You can then copy the
cfiles executable to some place in your path
Note: When using the C++ standard library from GCC 4.8,
cfiles rely on
boost_regex library, which can be installed using your favorite package
You are welcome to contribute to cfiles, whatever your skill level. You can help with new analysis algorithms, improving existing ones, adding or improving documentation, etc. If you plan adding new code, please open an issue about it for discussion.
Don't forget to run the tests when changing the code; and to add new tests when
adding new algorithms. The tests are Python scripts in the
checking the output of the algorithms.
cd cfiles/build ctest
Here is a short check list to contribute to cfiles. If there is anything you don't understand, or if you have any question, please ask! You can reach me on github issues, by email, or in the chat.
- Fork cfiles;
- Create a local branch;
- Add code / correct typos / ...;
- Add new tests with your code;
- Add documentation for your code;
- Check that the tests still pass;
- Push to Github;
- Create a Pull-Request;
- Discuss your changes with the reviewers;
- Have your code merged;
🎉 🍰 🎉
Contributors and license
cfiles was created and is maintained by Guillaume Fraux, and put to your disposition under the terms of the 3 clauses BSD license. By contributing to cfiles, you agree to distribute your contributions under the same license.
All the contributors to chemfiles are listed in the AUTHORS file. Many thanks to all of them!