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 C++ docstrings for extended histentry #3234

Open
wants to merge 4 commits into
base: master
Choose a base branch
from

Conversation

clinssen
Copy link
Contributor

@clinssen clinssen commented Jun 20, 2024

Update C++ docstrings for extended histentry.

@clinssen clinssen added S: Normal Handle this with default priority T: Maintenance Work to keep up the quality of the code and documentation. I: No breaking change Previously written code will work as before, no one should note anything changing (aside the fix) labels Jun 20, 2024
Copy link
Contributor

@jstapmanns jstapmanns left a comment

Choose a reason for hiding this comment

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

Thank you, @clinssen, for updating the documentation. It is much more helpful now.

class histentry_extended
{
public:
histentry_extended( double t, double dw, size_t access_counter );

double t_; //!< point in time when spike occurred (in ms)
double t_; //!< point in time for the history entry spike occurred (in ms)
Copy link
Contributor

Choose a reason for hiding this comment

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

I think, the words "spike occurred" can be removed in this comment since it seems to be a remnant from the stdp documentation from where I copied it. Maybe one can refer to t_ as "time stamp of the entry".

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done!

@terhorstd
Copy link
Contributor

Could you please provide a short description for this PR?

@heplesser heplesser requested review from otcathatsya and removed request for abigailm September 9, 2024 08:02
@@ -247,16 +247,17 @@ clopath_synapse< targetidentifierT >::send( Event& e, size_t t, const CommonSyna
std::deque< histentry_extended >::iterator start;
std::deque< histentry_extended >::iterator finish;

// facilitation due to postsynaptic activity since last pre-synaptic spike
Copy link
Contributor

Choose a reason for hiding this comment

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

maybe move this comment down to the facilitate call to match the depress() one?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Done!

@@ -40,20 +40,25 @@ class histentry
double t_; //!< point in time when spike occurred (in ms)
double Kminus_; //!< value of Kminus at that time
double Kminus_triplet_; //!< value of triplet STDP Kminus at that time
size_t access_counter_; //!< access counter to enable removal of the entry, once all neurons read it
size_t
access_counter_; //! how often this entry was accessed (to enable removal, once read by all synapses which need it)
Copy link
Contributor

Choose a reason for hiding this comment

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

strange linebreak?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Oops, fixed!

//! how often this entry was accessed (to enable removal, once read by all
//! neurons which need it)
size_t access_counter_;
size_t
Copy link
Contributor

Choose a reason for hiding this comment

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

<br>

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Oops, fixed!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
I: No breaking change Previously written code will work as before, no one should note anything changing (aside the fix) S: Normal Handle this with default priority T: Maintenance Work to keep up the quality of the code and documentation.
Projects
Status: PRs pending approval
Development

Successfully merging this pull request may close these issues.

4 participants