This is a github repository for issues and bugs related to Abinit. Users are invited to commit input files that can be used by developers to reproduce the issue, confirm the bug and then work on the bug fix. Please note that the purpose of this repository is to facilitate the exchange of input files between Abinit users and developers. This repo is not meant to replace our support forum. that, actually, represents the official reference to be consulted if you are encountering a problem or you need some help.
-
Search the forum and the github issue tracker to ensure that your issue is not a duplicate
-
If you think you've discovered a real bug, fork the repository and create a new issue on github (follow the instructions reported below)
-
Select the
Issues
tab on the github interface and click theNew Issue
button. -
Give a meaningful Title to your post that may help us to find/remember your post easily.
-
Fill the sections in the issue template. Be clear and concise in your description and take advantage of GitHub Flavored Markdown
-
Submit the issue and take note of the issue identifier generated by github. At this point, you can add the files needed to reproduce the issue. Please follow the instruction reported in the next section.
-
Fork the repository on github and get a local copy with:
git clone [email protected]:YOURNAME/abinit_issues.git
-
Create a new directory named
issue_id
whereid
is the identifier associated to the the issue you've just created on github -
Please provide whole/complete files neeeded to reproduce the error. More specifically:
- Abinit input files and files file
- Pseudopotential files
- The configuration options and the
config.log
file produced byconfigure
(if available) or, alternatively, a file with the output ofabinit -b
- Abinit output and log files
- Please do not add binary files to the repo, we only need the files needed to run the code
-
Add the files to the repo with
git add issue_id
whereissue_id
is the directory containing your file. -
Commit the changes with
git commit -a
and push them to github withgit push
-
Send us a pull request on github and mention the issue on the Abinit forum (just cut&paste the github issue and put a link to it so that other users of the forum will be aware of the problem)