Re: [Instrumentelem-user] documentation

[Teemu K. <te...@ka...>]

Hello Francesco and McKenzie,

 Sure, I would be interested in having a look at the code.

 Can you elaborate what is the "the IE end point that I give to you" that
you refer to? And is there some simple functional specification on what
functionality/services it provides?

Teemu

> Hi Teemu,
>    I finally find some spare time to dedicate to our OS project.
> Thx for initiating the conversation, I will keep you updated on that.
>
> I also add McKenzie in this conversation because in the past weeks she was
> helping a lot trying to fix our documentation.
>
> Talking about the P2P source code and other Instrument I did not yet
> upload
> them in SF because they need a clean-up otherwise you may find some
> difficulties in understanding it, btw if you need it now just let me know,
> I
> will be quite happy to send you a copy of the code.
>
> The HelloWordIE is a working example that is almost empty and it is a sort
> of template for implementing a new instruments. As I said before, more
> complicated instruments are coming. Btw, the IE end point that I give to
> you
> already implements more complex instruments
>
> Talk to you soon,
> Francesco
>
>
>
>
> On 5/24/09 11:18 PM, "Teemu Kanstrén" <te...@ka...> wrote:
>
>> Hello Francesco,
>>
>>   I set up a wiki page, as a basis for a guide, where you could maybe
>> answer the questions I put up. It is at
>> http://instrumentelem.sourceforge.net/wiki/index.php/Service_Concepts
>> . Feel free to move it to somewhere better and to change the terms I
>> use. I talk about services but maybe you can find a better terminology
>> etc. Hopefully you could write it in the style of a guide and not as a
>> set of answer to my questions. Also, I probably missed plenty of
>> topics, as I am still new to it, so please feel free to add anything
>> you find relevant and comes to mind. The javadoc is a good place for
>> documentation too, so maybe update that a bit with relevant info if
>> possible? Right now it is a bit sparse for someone like me who is new
>> to it all. You probably know it inside out as you seem to have
>> implemented the code, so for you i am sure it is clear :). Reminds me
>> of the nice article in May issue of CACM on API design and user
>> involvement (guess I am the user).
>>
>> Apparently the FAQ is still coming, so I guess it could use all kinds
>> of things. Maybe you can explain the basic concepts of instruments and
>> the IE project in general. Anyway, here are a few things I found
>> myself wondering.
>> -Where can I find the source code for the P2P example?
>> -Are there any (other) advanced instrument examples available ?
>>
>> Related to this, the HelloWorldIE example says it prints out received
>> events. It doesnt seem to implement anything really though. How is this?
>>
>> I will likely come back later with more questions and things to
>> explain as I try to use it. I will then ask again..:)
>>
>> Cheers,
>> Teemu
>>
>> On 23.5.2009, at 19.42, Francesco Lelli wrote:
>>
>>> Hi Teemu,
>>>    you can have a look on the javadoc
>>> http://instrumentelem.sourceforge.net/doc/ie/index.html
>>>
>>> In particular to the class IInstrumentElement
>>> http://instrumentelem.sourceforge.net/doc/ie/org/ie/IInstrumentElement.html
>>>
>>> Probably it is not enough but is a starting point,
>>>> From there I encourage you to prepare few "nice question" that I
>>>> will be
>>> happy to add to the FAQ section. If you want you can also draft an
>>> outline
>>> for a guide in our wiki and I will be happy to try to cover the
>>> various
>>> sections. What do you think about?
>>>
>>> Talk soon,
>>> Francesco
>>>
>>>
>>> On 5/22/09 9:39 PM, "Teemu Kanstrén" <te...@ka...> wrote:
>>>
>>>> Hello Francesco,
>>>>
>>>> I already had a look at all the docs I found, including the one at
>>>> http://instrumentelem.sourceforge.net/wiki/index.php/How_to_use_the_Web_Serv
>>>> ic
>>>> e_API_with_Axis_1.4.
>>>> This does not document sessions, top instrument managers or similar
>>>> concepts. Is that documented anywhere else or can you add it?
>>>>
>>>> Teemu
>>>>
>>>>> Hi Teemu,
>>>>>    you are asking the right questions :-)
>>>>>
>>>>> regarding point 1:
>>>>> the end point is the following:
>>>>> http://<yourMachineName>:<yourTomcatPort>/<yourAppName>/services/
>>>>> IEService
>>>>>
>>>>> I also update some information at this link
>>>>> http://instrumentelem.sourceforge.net/wiki/index.php/Installation_Guide
>>>>>
>>>>> So, talking about the Instruments of the demo valid end points are:
>>>>>
>>>>> http://sadgw.lnl.infn.it:2002/QoSInstrumentElement/services/
>>>>> IEService
>>>>>
>>>>> http://sadgw.lnl.infn.it:2002/InstrumentElementKeeper/services/IEService
>>>>>
>>>>> http://gladgw.lnl.infn.it:2002/SeedsFinder/services/IEService
>>>>>
>>>>>
>>>>> In general, if you click on the markers of the demo you will see a
>>>>> link
>>>>> named "end point" that point you the right location.
>>>>>
>>>>>
>>>>> In addition, if you run an instrument locally by clicking on the
>>>>> "join"
>>>>> button, you can have a valid end point local to your machine at
>>>>> this link:
>>>>> http://localhost:3003/axis/
>>>>>
>>>>>
>>>>>
>>>>> Regarding point 2:
>>>>> This is a step by step guide on how to access the service:
>>>>>
> http://instrumentelem.sourceforge.net/wiki/index.php/How_to_use_the_Web_Ser>>>>
> v
>>>>> ice_API_with_Axis_1.4
>>>>>
>>>>>
>>>>> If you have any problem just drop me a line,
>>>>> Francesco
>>>>>
>>>>>
>>>>>
>>>>> On 5/18/09 10:55 PM, "Teemu Kanstrén" <te...@ka...> wrote:
>>>>>
>>>>>> Hello all,
>>>>>>
>>>>>> I am trying to get familiar with using the project. I found the
>>>>>> docs on
>>>>>> the wiki and the javadocs, but can't seem to find everything I
>>>>>> need. I
>>>>>> tried to invoke some of the instruments linked in the demo. Here
>>>>>> are
>>>>>> some
>>>>>> things I am wondering for starters..
>>>>>>
>>>>>> 1. What are the different elements of an endpoint address?
>>>>>> I can copy paste the url from the demo but it was unclear to me
>>>>>> which
>>>>>> parts were needed, and if there are any options.
>>>>>>
>>>>>> 2. Apparently I need to start with opening a session, then get a
>>>>>> list of
>>>>>> all top instrument managers. I figured this mostly with trial and
>>>>>> error
>>>>>> and from the TestFunctionalityCreation.java class.
>>>>>> Where can I find the information on the required process such as
>>>>>> why do
>>>>>> I
>>>>>> need a session, what does it represent, what are top instrument
>>>>>> managers
>>>>>> and which one should I pick? From TestFunctionalityCreation.java it
>>>>>> seems
>>>>>> once I manage to figure this out and do it, I then need to get an
>>>>>> instance. What instance is this and why do I need it?
>>>>>> Don't really know how to proceed from here and so on, so I would
>>>>>> like to
>>>>>> know where I can find this information and other similar
>>>>>> information I
>>>>>> need to use it all?
>>>>>>
>>>>>> Thanks,
>>>>>> Teemu
>>>>>>
>>>>>>
>>>>>>
>>>>>> --------------------------------------------------------------------------
>>>>>> --
>>>>>> --
>>>>>> Crystal Reports - New Free Runtime and 30 Day Trial
>>>>>> Check out the new simplified licensing option that enables
>>>>>> unlimited royalty-free distribution of the report engine
>>>>>> for externally facing server and web deployment.
>>>>>> http://p.sf.net/sfu/businessobjects
>>>>>> _______________________________________________
>>>>>> Instrumentelem-user mailing list
>>>>>> Ins...@li...
>>>>>> https://lists.sourceforge.net/lists/listinfo/instrumentelem-user
>>>>>
>>>>>
>>>>>
>>>>>
>>>
> ----------------------------------------------------------------------------->>
>>
>>>>
>>> -
>>>>> Register Now for Creativity and Technology (CaT), June 3rd, NYC. CaT
>>>>> is a gathering of tech-side developers & brand creativity
>>>>> professionals.
>>>>> Meet
>>>>> the minds behind Google Creative Lab, Visual Complexity,
>>>>> Processing, &
>>>>> iPhoneDevCamp asthey present alongside digital heavyweights like
>>>>> Barbarian
>>>>> Group, R/GA, & Big Spaceship. http://www.creativitycat.com
>>>>> _______________________________________________
>>>>> Instrumentelem-user mailing list
>>>>> Ins...@li...
>>>>> https://lists.sourceforge.net/lists/listinfo/instrumentelem-user
>>>>>
>>>>
>>>>
>>>> -Teemu
>>>>
>>>>
>>>> ----------------------------------------------------------------------------
>>>> --
>>>> Register Now for Creativity and Technology (CaT), June 3rd, NYC. CaT
>>>> is a gathering of tech-side developers & brand creativity
>>>> professionals. Meet
>>>> the minds behind Google Creative Lab, Visual Complexity,
>>>> Processing, &
>>>> iPhoneDevCamp asthey present alongside digital heavyweights like
>>>> Barbarian
>>>> Group, R/GA, & Big Spaceship. http://www.creativitycat.com
>>>> _______________________________________________
>>>> Instrumentelem-user mailing list
>>>> Ins...@li...
>>>> https://lists.sourceforge.net/lists/listinfo/instrumentelem-user
>>>
>>>
>>>
>>>
> ----------------------------------------------------------------------------->>
> -
>>> Register Now for Creativity and Technology (CaT), June 3rd, NYC. CaT
>>> is a gathering of tech-side developers & brand creativity
>>> professionals. Meet
>>> the minds behind Google Creative Lab, Visual Complexity, Processing, &
>>> iPhoneDevCamp asthey present alongside digital heavyweights like
>>> Barbarian
>>> Group, R/GA, & Big Spaceship. http://www.creativitycat.com
>>> _______________________________________________
>>> Instrumentelem-user mailing list
>>> Ins...@li...
>>> https://lists.sourceforge.net/lists/listinfo/instrumentelem-user
>>
>>
>> ------------------------------------------------------------------------------
>> Register Now for Creativity and Technology (CaT), June 3rd, NYC. CaT
>> is a gathering of tech-side developers & brand creativity professionals.
>> Meet
>> the minds behind Google Creative Lab, Visual Complexity, Processing, &
>> iPhoneDevCamp asthey present alongside digital heavyweights like
>> Barbarian
>> Group, R/GA, & Big Spaceship. http://www.creativitycat.com
>> _______________________________________________
>> Instrumentelem-user mailing list
>> Ins...@li...
>> https://lists.sourceforge.net/lists/listinfo/instrumentelem-user
>
>
>
> ------------------------------------------------------------------------------
> Crystal Reports - New Free Runtime and 30 Day Trial
> Check out the new simplified licensing option that enables unlimited
> royalty-free distribution of the report engine for externally facing
> server and web deployment.
> http://p.sf.net/sfu/businessobjects
> _______________________________________________
> Instrumentelem-user mailing list
> Ins...@li...
> https://lists.sourceforge.net/lists/listinfo/instrumentelem-user
>


-Teemu