-
Notifications
You must be signed in to change notification settings - Fork 217
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
FieldTmp Operations: Doxygen Strings #1789
FieldTmp Operations: Doxygen Strings #1789
Conversation
8985c1c
to
5545287
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
just a minor typo and some questions
*/ | ||
|
||
/* Density */ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
QUESTION:
Why did you remove this comment?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
it's not removed, there is a whole new block now with a real doxygen comment for this class.
* Each value is mapped per cell according to the species' spatial shape. | ||
* | ||
* @note for species that do not change their charge state, this is identical | ||
* to the density times a constant for the charge, |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
OPTIONAL:
better: a constant for the charge
-> the (constant) particle's charge
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
thanks, but better plural: the (constant) particles' charge
* Derives a scalar field with real particle numbers per cell from a particle | ||
* species at runtime. | ||
* Each macro particles weighting is assigned straight to the cell it belongs | ||
* to, which is in most cases as floor operation in space (and not necessarily |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
REQUIRED:
typo: as
-> a
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
thx, fixed
/** Energy Density Operation for Particle to Grid Projections | ||
* | ||
* Derives a scalar field for average kinetic particle energy per cell times the | ||
* particle density from a particle species at runtime. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
QUESTION:
Would kinetic particle energy density
be not more straight forward?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
nope, the term energy density is quite well defined to be kinetic. If someones does not get that in the title the brief directly explains it in detail.
75f9db1
to
842c03b
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice documentation!
* | ||
* Derives a scalar field with real particle numbers per cell from a particle | ||
* species at runtime. | ||
* Each macro particles weighting is assigned straight to the cell it belongs |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Each macro particle's weighting
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
updated
* | ||
* Derives a scalar field with number of macro particles per cell from a particle | ||
* species at runtime. | ||
* Each macro particles is counted straight to the cell it belongs |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Each macro particle
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
thx, updated
842c03b
to
0f3bacb
Compare
Adds doxygen strings to the classes that users need to define `FieldTmp` operations in `fileOutput.param` or algorithms such as Thomas Fermi. This can help to understand how to use those and can be more detailed then the small examples we give in `fileOutput.param`.
0f3bacb
to
71aab9e
Compare
Adds doxygen strings to the classes that users need to define
FieldTmp
operations infileOutput.param
or algorithms such as Thomas Fermi. This can help to understand how to use those and can be more detailed then the small examples we give infileOutput.param
.