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

add readme for tag parameter framework #3414

Closed
wants to merge 2 commits into from

Conversation

sanuj
Copy link
Contributor

@sanuj sanuj commented Aug 8, 2016

I have randomly placed it in doc for now. I think this will go to the wiki. Sending a PR for feedback.
@lisitsyn @vigsterkr


While defining a new Shogun class, `register_param()` or `register_member()` should be used in the constructor to register parameters and member variables of the class. This would allow the parameters or class member variables values to be queried or modified using `gets()` / `sets()`. These functions are required to prevent Shogun users to modify and query arbitrary parameters in an object but only those set of parameters which have been registered by using these two functions. The new Shogun class should also inherit `CSGObject` as these two functions are `protected` in `CSGObject`. Let's look at an example to make this more concrete.

```cpp
Copy link
Contributor Author

Choose a reason for hiding this comment

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

@lisitsyn I wrote the above paragraph and realized then we are now going to use SG_ADD which only has register_member(). How will register_param() be used? Do we need it anymore? Will the new plugin classes also use SG_ADD?

@OXPHOS This section is incomplete. Will complete it soon.


### What are Tags?

`Tag` is a Shogun class which stores name and type information of a parameter. This allows a `Tag` object to be used as an identifier for a parameter in this new framework. Eg:
Copy link
Member

Choose a reason for hiding this comment

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

E.g.

@OXPHOS
Copy link
Member

OXPHOS commented Aug 17, 2016

Cool! I think it's very clear and only minor stuff needs to be fixed!

@karlnapf karlnapf mentioned this pull request Oct 30, 2016
@lambday
Copy link
Member

lambday commented Oct 31, 2016

This should be a wiki, no?

@karlnapf
Copy link
Member

karlnapf commented Nov 1, 2016

Yes, I recently added a new repo for the wiki which can be cloned in a
standard way and then you can send a or against that

Wanna try?

On Monday, 31 October 2016, Soumyajit De notifications@github.com wrote:

This should be a wiki, no?


You are receiving this because you are subscribed to this thread.
Reply to this email directly, view it on GitHub
#3414 (comment),
or mute the thread
https://github.com/notifications/unsubscribe-auth/AAqqvwdVSZPUfCdPNfkA66boxL7gK-Roks5q5Zd4gaJpZM4JfP6Q
.

Sent from my phone

@karlnapf
Copy link
Member

karlnapf commented Nov 2, 2016

Ill do it

@karlnapf
Copy link
Member

karlnapf commented Nov 2, 2016

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants