[all] Question about release documentation

classic Classic list List threaded Threaded
12 messages Options
Reply | Threaded
Open this post in threaded view
|

[all] Question about release documentation

Oliver Heger-3
Just a question about our current documentation about cutting releases:

[1] mentions that symbolic links should be created for the
distributions. I think this is outdated. Can anybody confirm this? I
will then update the instructions accordingly.

Thanks
Oliver

[1] http://wiki.apache.org/commons/UsingNexus

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [all] Question about release documentation

Gilles Sadowski
On Mon, Aug 20, 2012 at 02:32:25PM +0200, Oliver Heger wrote:
> Just a question about our current documentation about cutting releases:
>
> [1] mentions that symbolic links should be created for the
> distributions. I think this is outdated. Can anybody confirm this? I
> will then update the instructions accordingly.

I don't know, but there were several wrong or incomplete statements in that
document when, as a "newbie release manager" for Commons Math 3.0, I tried
to follow it step by step.
I collected the steps of a working procedure here:
  http://wiki.apache.org/commons/GillesSadowski/ReleaseMiniHowto


Regards,
Gilles

>
> Thanks
> Oliver
>
> [1] http://wiki.apache.org/commons/UsingNexus

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

[math] Convolution

Clemens Novak
Dear all,

I would like to work on some signal processing functions (as indicated
on the wiki WishList) and started with the convolution of 2 sequences
(represented as RealVector). I have completed a first working version
(some error checking code, formatting, unit tests etc are missing); I am
unsure of how to continue: Is the next step to create a new Jira ticket
and upload my final code there (for further discussion/review/...)?

Thanks for your help & kind regards - Clemens

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [all] Question about release documentation

sebb-2-2
In reply to this post by Oliver Heger-3
On 20 August 2012 13:32, Oliver Heger <[hidden email]> wrote:
> Just a question about our current documentation about cutting releases:
>
> [1] mentions that symbolic links should be created for the distributions. I
> think this is outdated. Can anybody confirm this? I will then update the
> instructions accordingly.

I don't think the symbolic links are very useful.
They are certainly not necessary, and it's easy for them to get out of date.

If a mirror is set up correctly, they do work, however anyone
downloading from the symbolic link will see the file as
   commons-dbutils-current-bin.zip
rather than
  commons-dbutils-1.5-bin.zip (for example).

> Thanks
> Oliver
>
> [1] http://wiki.apache.org/commons/UsingNexus
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [math] Convolution

Luc Maisonobe
In reply to this post by Clemens Novak
Le 20/08/2012 17:00, Clemens Novak a écrit :
> Dear all,

Hi Clemens,

>
> I would like to work on some signal processing functions (as indicated
> on the wiki WishList) and started with the convolution of 2 sequences
> (represented as RealVector). I have completed a first working version
> (some error checking code, formatting, unit tests etc are missing); I am
> unsure of how to continue: Is the next step to create a new Jira ticket
> and upload my final code there (for further discussion/review/...)?

Yes, you can do that.

>
> Thanks for your help & kind regards - Clemens

Thanks for your interest and contribution.

Luc

>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>
>


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [all] Question about release documentation

Oliver Heger-3
In reply to this post by sebb-2-2
Am 20.08.2012 18:35, schrieb sebb:

> On 20 August 2012 13:32, Oliver Heger <[hidden email]> wrote:
>> Just a question about our current documentation about cutting releases:
>>
>> [1] mentions that symbolic links should be created for the distributions. I
>> think this is outdated. Can anybody confirm this? I will then update the
>> instructions accordingly.
>
> I don't think the symbolic links are very useful.
> They are certainly not necessary, and it's easy for them to get out of date.
>
> If a mirror is set up correctly, they do work, however anyone
> downloading from the symbolic link will see the file as
>     commons-dbutils-current-bin.zip
> rather than
>    commons-dbutils-1.5-bin.zip (for example).
>

The older release instructions [2] even say, symbolic links should not
be used at all (section 2 Update Release Directory).

[2]http://commons.apache.org/releases/release.html

>> Thanks
>> Oliver
>>
>> [1] http://wiki.apache.org/commons/UsingNexus
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: [hidden email]
>> For additional commands, e-mail: [hidden email]
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [all] Question about release documentation

Oliver Heger-3
In reply to this post by Gilles Sadowski
Am 20.08.2012 16:08, schrieb Gilles Sadowski:

> On Mon, Aug 20, 2012 at 02:32:25PM +0200, Oliver Heger wrote:
>> Just a question about our current documentation about cutting releases:
>>
>> [1] mentions that symbolic links should be created for the
>> distributions. I think this is outdated. Can anybody confirm this? I
>> will then update the instructions accordingly.
>
> I don't know, but there were several wrong or incomplete statements in that
> document when, as a "newbie release manager" for Commons Math 3.0, I tried
> to follow it step by step.
> I collected the steps of a working procedure here:
>    http://wiki.apache.org/commons/GillesSadowski/ReleaseMiniHowto
>
Thanks for the link.

Publishing releases is already a surprisingly complex task. Having
multiple, partly outdated instructions makes it even harder :-(

We should try to come up with one standard document. So far, for the
release preparations the UsingNexus document worked well for me. I am
going to update it when I encounter problems.

Oliver

>
> Regards,
> Gilles
>
>>
>> Thanks
>> Oliver
>>
>> [1] http://wiki.apache.org/commons/UsingNexus
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [all] Question about release documentation

Gilles Sadowski
On Mon, Aug 20, 2012 at 07:58:52PM +0200, Oliver Heger wrote:

> Am 20.08.2012 16:08, schrieb Gilles Sadowski:
> >On Mon, Aug 20, 2012 at 02:32:25PM +0200, Oliver Heger wrote:
> >>Just a question about our current documentation about cutting releases:
> >>
> >>[1] mentions that symbolic links should be created for the
> >>distributions. I think this is outdated. Can anybody confirm this? I
> >>will then update the instructions accordingly.
> >
> >I don't know, but there were several wrong or incomplete statements in that
> >document when, as a "newbie release manager" for Commons Math 3.0, I tried
> >to follow it step by step.
> >I collected the steps of a working procedure here:
> >   http://wiki.apache.org/commons/GillesSadowski/ReleaseMiniHowto
> >
> Thanks for the link.
>
> Publishing releases is already a surprisingly complex task. Having
> multiple, partly outdated instructions makes it even harder :-(

If "UsingNexus" works for you, it is probably because you have additional
configuration set up which is not talked about in that document, randering
it useless for a newbie. People who know what to do don't need that document
and it is thus kept in an unusable state...

>
> We should try to come up with one standard document.

That's why I wrote the above, which is supposed to contain everything to
perform a release, with links to information not detailed there but likely
missing fomr a newbie's config (e.g. GPG key).

> So far, for the
> release preparations the UsingNexus document worked well for me. I
> am going to update it when I encounter problems.

I've encountered many problems, for some I got a solution from this list,
for others I figured a solution by trial and error.
Finally, I came up with a working recipe (the above document, which I asked
here for review). If you want to go down the same path again...


Regards,
Gilles

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [all] Question about release documentation

Oliver Heger-3
Am 21.08.2012 00:11, schrieb Gilles Sadowski:

> On Mon, Aug 20, 2012 at 07:58:52PM +0200, Oliver Heger wrote:
>> Am 20.08.2012 16:08, schrieb Gilles Sadowski:
>>> On Mon, Aug 20, 2012 at 02:32:25PM +0200, Oliver Heger wrote:
>>>> Just a question about our current documentation about cutting releases:
>>>>
>>>> [1] mentions that symbolic links should be created for the
>>>> distributions. I think this is outdated. Can anybody confirm this? I
>>>> will then update the instructions accordingly.
>>>
>>> I don't know, but there were several wrong or incomplete statements in that
>>> document when, as a "newbie release manager" for Commons Math 3.0, I tried
>>> to follow it step by step.
>>> I collected the steps of a working procedure here:
>>>    http://wiki.apache.org/commons/GillesSadowski/ReleaseMiniHowto
>>>
>> Thanks for the link.
>>
>> Publishing releases is already a surprisingly complex task. Having
>> multiple, partly outdated instructions makes it even harder :-(
>
> If "UsingNexus" works for you, it is probably because you have additional
> configuration set up which is not talked about in that document, randering
> it useless for a newbie. People who know what to do don't need that document
> and it is thus kept in an unusable state...
>
>>
>> We should try to come up with one standard document.
>
> That's why I wrote the above, which is supposed to contain everything to
> perform a release, with links to information not detailed there but likely
> missing fomr a newbie's config (e.g. GPG key).
>
>> So far, for the
>> release preparations the UsingNexus document worked well for me. I
>> am going to update it when I encounter problems.
>
> I've encountered many problems, for some I got a solution from this list,
> for others I figured a solution by trial and error.
> Finally, I came up with a working recipe (the above document, which I asked
> here for review). If you want to go down the same path again...
>

Not the same path. My goal is to have one consolidated document. It
seems to me that from the general structure your document is similar to
UsingNexus, sometimes you provide more details. So wouldn't it be
possible to merge the documents?

BTW, I did some updates on UsingNexus for some points I had trouble with.

Oliver

>
> Regards,
> Gilles
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [all] Question about release documentation

Gilles Sadowski
Hi.

> > [...]
> >
> >I've encountered many problems, for some I got a solution from this list,
> >for others I figured a solution by trial and error.
> >Finally, I came up with a working recipe (the above document, which I asked
> >here for review). If you want to go down the same path again...
> >
>
> Not the same path. My goal is to have one consolidated document. It
> seems to me that from the general structure your document is similar
> to UsingNexus, sometimes you provide more details. So wouldn't it be
> possible to merge the documents?

You are certainly welcome to do as you please.
What I was expecting from "UsingNexus" is that it would be a minimal
"howto" (i.e. follow the instructions and it works) but people have added
alternatives to some steps which, at some point, ceased to work (or might be
working on their machine pending some additional configuration files and/or
scripts/plugins not mentioned there). All this was extremely frustrating (in
addition to my own mistakes as a newbie).

I don't think that such a document is useful if it contains more than a
minimal, complete, and not redundant, set of instructions: when it starts
duplicating parts of another manual or providing several ways to achieve the
same goal, it becomes rapidly obsolete and next time someone needs it, he's
up for checking and correcting the document rather than performing the task
which the document is supposed to help achieving...


Best regards,
Gilles

>
> BTW, I did some updates on UsingNexus for some points I had trouble with.
>
> Oliver
>

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [math] Convolution

Clemens Novak
In reply to this post by Luc Maisonobe
On 2012-08-20 19:25, Luc Maisonobe wrote:

> Le 20/08/2012 17:00, Clemens Novak a écrit :
>> Dear all,
>
> Hi Clemens,
>
>>
>> I would like to work on some signal processing functions (as
>> indicated
>> on the wiki WishList) and started with the convolution of 2
>> sequences
>> (represented as RealVector). I have completed a first working
>> version
>> (some error checking code, formatting, unit tests etc are missing);
>> I am
>> unsure of how to continue: Is the next step to create a new Jira
>> ticket
>> and upload my final code there (for further discussion/review/...)?
>
> Yes, you can do that.
>
>>
>> Thanks for your help & kind regards - Clemens
>
> Thanks for your interest and contribution.
>
> Luc
>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: [hidden email]
>> For additional commands, e-mail: [hidden email]
>>
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]

Dear all,

besides the ongoing discussions in MATH-851, I would like to discuss
some extensions of this library in the area of discrete-time signal
processing:

(1) convolution of 1D and 2D sequences based on (i) straightforward
calculation of the convolution sum and (ii) using the FFT.

(2) filter functions for 1D sequences, i.e. y[n] = \sum_{l=0}^{L-1} b_l
x[n-l] - \sum_{m=1}^{M-1} a_m y[n-m]

(3) window functions (such as raised cosine, blackmann...) used in
conjunction with FFTs

(4) possibly some basic filter design (such as window method,
Parks-McClellan algorithm...)

However, first I want to ensure that you think these topics belong in
Commons math - I have been reading the intro (... is a library of
lightweight, self-contained mathematics and statistics components
addressing the most common problems...) and I am not perfectly sure
whether these topics really fit here?

In MATH-851 we shortly touched whether using RealVector or a simple
double array is better. What's your opinion here? The double array might
be better in terms of performance; when based on RealVector, however,
more basic functionality would be provided out of the box. Has anyone
made a performance comparison between arrays and RealVector in order to
have some guidelines here?

Kind regards - Clemens

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: [math] Convolution

Bruce A Johnson-2

On Aug 23, 2012, at 8:31 AM, Clemens Novak wrote:

> On 2012-08-20 19:25, Luc Maisonobe wrote:
>> Le 20/08/2012 17:00, Clemens Novak a écrit :
>>> Dear all,
>>
>> Hi Clemens,
>>
>>>
>>> I would like to work on some signal processing functions (as indicated
>>> on the wiki WishList) and started with the convolution of 2 sequences
>>> (represented as RealVector). I have completed a first working version
>>> (some error checking code, formatting, unit tests etc are missing); I am
>>> unsure of how to continue: Is the next step to create a new Jira ticket
>>> and upload my final code there (for further discussion/review/...)?
>>
>> Yes, you can do that.
>>
>>>
>>> Thanks for your help & kind regards - Clemens
>>
>> Thanks for your interest and contribution.
>>
>> Luc
>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: [hidden email]
>>> For additional commands, e-mail: [hidden email]
>>>
>>>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: [hidden email]
>> For additional commands, e-mail: [hidden email]
>
> Dear all,
>
> besides the ongoing discussions in MATH-851, I would like to discuss some extensions of this library in the area of discrete-time signal processing:
>
> (1) convolution of 1D and 2D sequences based on (i) straightforward calculation of the convolution sum and (ii) using the FFT.
>
> (2) filter functions for 1D sequences, i.e. y[n] = \sum_{l=0}^{L-1} b_l x[n-l] - \sum_{m=1}^{M-1} a_m y[n-m]
>
> (3) window functions (such as raised cosine, blackmann...) used in conjunction with FFTs
>
> (4) possibly some basic filter design (such as window method, Parks-McClellan algorithm...)
>
> However, first I want to ensure that you think these topics belong in Commons math - I have been reading the intro (... is a library of lightweight, self-contained mathematics and statistics components addressing the most common problems...) and I am not perfectly sure whether these topics really fit here?
>
> In MATH-851 we shortly touched whether using RealVector or a simple double array is better. What's your opinion here? The double array might be better in terms of performance; when based on RealVector, however, more basic functionality would be provided out of the box. Has anyone made a performance comparison between arrays and RealVector in order to have some guidelines here?
>
> Kind regards - Clemens
>

I use Commons Math extensively in signal processing applications so I, for one, would love to see more features in this area.

cheers,

Bruce


> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>
>


---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]