Ramon,
GSD defines the bonding topology system with the number of bonds, types, the type id of each bond, and the ids of the particles that participate in each bond:
https://gsd.readthedocs.io/en/stable/schema-hoomd.html#topology
In the language of thermodynamics, think of the GSD file as defining the microstate of the system. It includes all of the degrees of freedom in the system. Reading a GSD file (either with HOOMD v2 or v3) only reads in that microstate. The operations that you specify in your script determine the equations of motion of the system, including the integration method and the Hamiltonian. So, while the GSD file defines which particles are bonded to each other in the topology, the bond potential you specify in your script determines how energies are evaluated on those bonds.
Regarding documentation improvements, the new tutorials explain this separation between state and operations using the same concepts as above:
https://hoomd-blue.readthedocs.io/en/latest/tutorial/00-Introducing-HOOMD-blue/00-index.html
Are you are looking for a way to read operations from a file that is not a script? This is something we are planning in a future v3 beta release. Operations will be picklable so that you save a set of operations from one script and read them in another. We have no plans to store operations in GSD files - there needs to be a clear separation in concepts between the state of the system and the operations that you apply to that state. If they were coupled, one could not conceptually consider using the final state of a MC simulation as the initial condition for an MD one, continue running a simulation at a lower temperature, or many other common use-cases.
------
Joshua A. Anderson, Ph.D.
Research Area Specialist, Chemical Engineering, University of Michigan
> To view this discussion on the web visit
https://groups.google.com/d/msgid/hoomd-users/4e99feb9-7703-4324-83ae-d09ae1171e26n%40googlegroups.com.