You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by Oliver Heger <ol...@oliver-heger.de> on 2012/08/20 14:32:25 UTC

[all] Question about release documentation

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: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [math] Convolution

Posted by Bruce A Johnson <jo...@umbc.edu>.
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: dev-unsubscribe@commons.apache.org
>>> For additional commands, e-mail: dev-help@commons.apache.org
>>> 
>>> 
>> 
>> 
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
> 
> 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: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
> 
> 


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [math] Convolution

Posted by Clemens Novak <cl...@familie-novak.net>.
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: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>>
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org

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: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [math] Convolution

Posted by Luc Maisonobe <Lu...@free.fr>.
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: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
> 
> 


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


[math] Convolution

Posted by Clemens Novak <cl...@familie-novak.net>.
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: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [all] Question about release documentation

Posted by Gilles Sadowski <gi...@harfang.homelinux.org>.
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: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [all] Question about release documentation

Posted by Oliver Heger <ol...@oliver-heger.de>.
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: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [all] Question about release documentation

Posted by Gilles Sadowski <gi...@harfang.homelinux.org>.
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: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [all] Question about release documentation

Posted by Oliver Heger <ol...@oliver-heger.de>.
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: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [all] Question about release documentation

Posted by Gilles Sadowski <gi...@harfang.homelinux.org>.
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: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [all] Question about release documentation

Posted by Oliver Heger <ol...@oliver-heger.de>.
Am 20.08.2012 18:35, schrieb sebb:
> On 20 August 2012 13:32, Oliver Heger <ol...@oliver-heger.de> 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: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Re: [all] Question about release documentation

Posted by sebb <se...@gmail.com>.
On 20 August 2012 13:32, Oliver Heger <ol...@oliver-heger.de> 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: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org