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

Documentation for rjd3toolkit::dictionary() #15

Closed
merangelik opened this issue Oct 12, 2023 · 1 comment
Closed

Documentation for rjd3toolkit::dictionary() #15

merangelik opened this issue Oct 12, 2023 · 1 comment

Comments

@merangelik
Copy link

merangelik commented Oct 12, 2023

Hi,

is there some kind of documentation available regarding the output of
rjd3toolkit::dictionary()
or will there be?

This issue is very much related to
rjdverse/rjd3x13#18
It just concerns a different subpackage of rjd3.

@palatej
Copy link
Contributor

palatej commented Apr 19, 2024

The "dictionary" function is just an easy way to find all the output generated by the the Java function "getData" (from the interface "jdplus.toolkit.base.api.information.Explorable". That mechanism, which can be extended dynamically, is used to generate output or to retrieve results in a generic (but less efficient) way. It is a low-level function that should probably be renamed as ".dictionary" (and "result" should be renamed ".result").
More specialized dictionaries with documentation are provided for advanced algorithms (x13, tramo-seats...). All the items provided in those dictionaries should be available in "dictionary" (not fully the case for the time being), but "dictionary" can contain other results (for internal purposes for instance), not necessary directly transformed in R structures.
So, "normal" users should always use the specialized and documented dictionaries (in rjd3x13...); the generic "dictionary" is more designed for developers or for "quick and dirty" developments.

@palatej palatej closed this as completed Apr 19, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants