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

FieldTmp Operations: Doxygen Strings #1789

Merged

Conversation

ax3l
Copy link
Member

@ax3l ax3l commented Jan 24, 2017

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.

@ax3l ax3l added the documentation regarding documentation or wiki discussions label Jan 24, 2017
@ax3l ax3l added this to the Next Stable: 0.3.0 / 1.0.0 milestone Jan 24, 2017
@ax3l ax3l requested review from PrometheusPi and n01r January 24, 2017 16:08
@ax3l ax3l force-pushed the doc-doxyFileOutput branch from 8985c1c to 5545287 Compare January 24, 2017 16:11
@PrometheusPi PrometheusPi self-assigned this Jan 24, 2017
Copy link
Member

@PrometheusPi PrometheusPi left a 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 */
Copy link
Member

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?

Copy link
Member Author

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,
Copy link
Member

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

Copy link
Member Author

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
Copy link
Member

Choose a reason for hiding this comment

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

REQUIRED:
typo: as-> a

Copy link
Member Author

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.
Copy link
Member

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?

Copy link
Member Author

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.

@ax3l ax3l force-pushed the doc-doxyFileOutput branch 2 times, most recently from 75f9db1 to 842c03b Compare January 25, 2017 09:00
Copy link
Member

@n01r n01r left a 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
Copy link
Member

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

Copy link
Member Author

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
Copy link
Member

Choose a reason for hiding this comment

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

Each macro particle

Copy link
Member Author

Choose a reason for hiding this comment

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

thx, updated

@ax3l ax3l force-pushed the doc-doxyFileOutput branch from 842c03b to 0f3bacb Compare January 25, 2017 10:06
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`.
@ax3l ax3l force-pushed the doc-doxyFileOutput branch from 0f3bacb to 71aab9e Compare January 25, 2017 10:08
@PrometheusPi PrometheusPi merged commit 51050a5 into ComputationalRadiationPhysics:dev Jan 25, 2017
@ax3l ax3l deleted the doc-doxyFileOutput branch January 25, 2017 13:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation regarding documentation or wiki discussions
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants