Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update symmform examples #68

Merged
merged 13 commits into from
Feb 23, 2024
Merged

Conversation

vaitkus
Copy link
Collaborator

@vaitkus vaitkus commented Feb 5, 2024

This PR aims at resolving issue #67.

This PR is currently marked as a draft since there are still a few minor issues with the symmform definitions that should be resolved.

…FS#67.

Specifically, examples were added for the
`_atom_site_moment_Fourier_param.modulus_symmform`,
`_atom_site_moment_Fourier_param.phase_symmform` and
`_atom_site_moment_Fourier_param_sin_symmform` data items.
The previous example was replaced by examples provided in issue COMCIFS#67.
The previous value was merge with the example of the
ATOM_SITE_MOMENT_FOURIER_PARAM category. The category example was only slightly
modified by replacing the dotless data names with their dotted counterparts
and correcting several symmform values that lacked a trailing modulation
number.
…OMCIFS#67.

The symmform symbolic expression description part was copied from the
definition of `_atom_site_moment_Fourier_param.cos_symmform` and adapted to
better reflect the syntax of each individual item.
As specified in
COMCIFS#67 (comment),
the 4th character is a numeric code as specified in the
_atom_site_moment_Fourier.wave_vector_seq_id data item.
@vaitkus
Copy link
Collaborator Author

vaitkus commented Feb 6, 2024

This PR became slightly more complex than I originally expected, but hopefully it is still granular enough to review (and potentially merge). If not, we can postpone it to the next dictionary release.

This PR now rewrites the descriptions of 4 symmform data items [1] to better reflect the syntax which applies for each individual data item. This was done by copying the description from _atom_site_moment_Fourier_param.cos_symmform, merging it with the description provided in [2] and then further modifying the symbol syntax description. For example, the 3rd character in the symbols of _atom_site_moment_Fourier_param.phase_symmform was restricted from [s,c,m,p] (sin, cos, modulated, phase) to only [p] (phase).

Furthermore, it was noted in each description that the 4th character which identifies the modulation vector is actually taken from _atom_site_moment_Fourier.wave_vector_seq_id (as stated in #67 (comment)).

Finally, examples for each of these data items were also added.

I think I applied all of the suggestions correctly, but I strongly suggest a mandatory review before merging.

[1] _atom_site_moment_Fourier_param.sin_symmform, _atom_site_moment_Fourier_param.cos_symmform, _atom_site_moment_Fourier_param.modulus__symmform, _atom_site_moment_Fourier_param.phase_symmform.
[2] #67 (comment)

@vaitkus vaitkus marked this pull request as ready for review February 6, 2024 16:53
@brantonc
Copy link
Collaborator

brantonc commented Feb 6, 2024 via email

@vaitkus vaitkus linked an issue Feb 21, 2024 that may be closed by this pull request
Copy link
Contributor

@jamesrhester jamesrhester left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving for merging, @brantonc can review after merging if that is preferred.

@vaitkus
Copy link
Collaborator Author

vaitkus commented Feb 23, 2024

Thank you for the review.

@vaitkus vaitkus merged commit 07565c6 into COMCIFS:main Feb 23, 2024
2 checks passed
@vaitkus vaitkus deleted the add-more-symmform-examples branch February 23, 2024 14:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Incorrect value example of _atom_site_moment_fourier_param.cos_symmform
3 participants