[GeoNetwork-devel] Documentation

Andrew_Watkins · June 4, 2010, 2:22am

Is there any technical documentation on how GN really does the following?

if not pointers to the relevant bits of source code would be good.

1 compares the search bounding box with those in the metadata records

2 ditto for the date ranges

3 puts keywords, titles and other elements into the search indexes.

Also how to set the default map view and search region to a specific region e.g. New Zealand.

Thanks Andrew

Andrew Watkins
Systems Development Team Manager
National Institute Water & Atmospheric Research (NIWA).

NIWA is the trading name of the National Institute of Water & Atmospheric Research Ltd.

Timo_Proescholdt · June 5, 2010, 8:39am

Dear Andrew,

Le 04.06.2010 04:22, Andrew Watkins a écrit :

Is there any technical documentation on how GN really does the following?

- if not pointers to the relevant bits of source code would be good.

the geonetwork documentation is in shambles... both for users and
developers. I'd invest some time in making it better, but it seems that
a more
concerted effort would be needed.
However, there is a lot of knowledge here on the list.

1 compares the search bounding box with those in the metadata records

the mechanism this works (for the different search modi like
z3959,csw,..) is the following.
Your query is parsed and converted into a gn internal xml query format.
This format in turn, is then converted into lucene queries.
Most of the conversions are done by xsl transformations, for which you
find the files in /geonetwork/xml/search/ .
Sourcecode-wise, have a look at LuceneSearcher.java

2 ditto for the date ranges

I just worked on the date ranges for z3950, they are in z3959Server.xsl

3 puts keywords, titles and other elements into the search indexes.

this is exactely what the xstt do... mapping between incoming attributes
and lucene indices.

Also how to set the default map view and search region to a specific
region e.g. New Zealand.

that I dont know.

Keep me up to date, there is some work to be done on dates and
boundinxboxes,
maybe we can share forces.

best
Timo

Thanks Andrew

Andrew Watkins

Systems Development Team Manager

National Institute Water & Atmospheric Research (NIWA).

NIWA is the trading name of the National Institute of Water &
Atmospheric Research Ltd.

------------------------------------------------------------------------------
ThinkGeek and WIRED's GeekDad team up for the Ultimate
GeekDad Father's Day Giveaway. ONE MASSIVE PRIZE to the
lucky parental unit. See the prize list and enter to win:
http://p.sf.net/sfu/thinkgeek-promo

_______________________________________________
GeoNetwork-devel mailing list
GeoNetwork-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geonetwork-devel
GeoNetwork OpenSource is maintained at http://sourceforge.net/projects/geonetwork

ticheler · June 9, 2010, 9:55am

Dear all,
I am working this week on moving the documentation to a Sphinx framework, just like GeoServer and other OSGeo projects do these days. I will set it up to also automatically include the Javadoc in the resulting website.

This should, together with a WIKI, give us enough flexibility to maintain better documentation while it also makes it easier for developers and users to generate and maintain new documentation.

I would like to see it replace the current geonetwork-opensource.org Plone based website and parts of the current developer WIKI can also be integrated quickly.

Back soon with more on this.
Cheers,
Jeroen

On 5 jun 2010, at 10:39, Timo Proescholdt wrote:

Dear Andrew,

Le 04.06.2010 04:22, Andrew Watkins a écrit :

Is there any technical documentation on how GN really does the following?

- if not pointers to the relevant bits of source code would be good.

the geonetwork documentation is in shambles... both for users and
developers. I'd invest some time in making it better, but it seems that
a more
concerted effort would be needed.
However, there is a lot of knowledge here on the list.

1 compares the search bounding box with those in the metadata records

the mechanism this works (for the different search modi like
z3959,csw,..) is the following.
Your query is parsed and converted into a gn internal xml query format.
This format in turn, is then converted into lucene queries.
Most of the conversions are done by xsl transformations, for which you
find the files in /geonetwork/xml/search/ .
Sourcecode-wise, have a look at LuceneSearcher.java

2 ditto for the date ranges

I just worked on the date ranges for z3950, they are in z3959Server.xsl

3 puts keywords, titles and other elements into the search indexes.

this is exactely what the xstt do... mapping between incoming attributes
and lucene indices.

Also how to set the default map view and search region to a specific
region e.g. New Zealand.

that I dont know.

Keep me up to date, there is some work to be done on dates and
boundinxboxes,
maybe we can share forces.

best
Timo

Thanks Andrew

Andrew Watkins

Systems Development Team Manager

National Institute Water & Atmospheric Research (NIWA).

NIWA is the trading name of the National Institute of Water &
Atmospheric Research Ltd.

------------------------------------------------------------------------------
ThinkGeek and WIRED's GeekDad team up for the Ultimate
GeekDad Father's Day Giveaway. ONE MASSIVE PRIZE to the
lucky parental unit. See the prize list and enter to win:
http://p.sf.net/sfu/thinkgeek-promo

_______________________________________________
GeoNetwork-devel mailing list
GeoNetwork-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geonetwork-devel
GeoNetwork OpenSource is maintained at http://sourceforge.net/projects/geonetwork

------------------------------------------------------------------------------
ThinkGeek and WIRED's GeekDad team up for the Ultimate
GeekDad Father's Day Giveaway. ONE MASSIVE PRIZE to the
lucky parental unit. See the prize list and enter to win:
http://p.sf.net/sfu/thinkgeek-promo
_______________________________________________
GeoNetwork-devel mailing list
GeoNetwork-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geonetwork-devel
GeoNetwork OpenSource is maintained at http://sourceforge.net/projects/geonetwork

Timo_Proescholdt · June 12, 2010, 8:27am

Hi Jeroen,

please keep me (us) posted and let me know if you need some help.
I'd be glad to assist.

regards
Timo

Le 09.06.2010 11:55, Jeroen Ticheler a écrit :

Dear all,
I am working this week on moving the documentation to a Sphinx framework, just like GeoServer and other OSGeo projects do these days. I will set it up to also automatically include the Javadoc in the resulting website.

This should, together with a WIKI, give us enough flexibility to maintain better documentation while it also makes it easier for developers and users to generate and maintain new documentation.

I would like to see it replace the current geonetwork-opensource.org Plone based website and parts of the current developer WIKI can also be integrated quickly.

Back soon with more on this.
Cheers,
Jeroen

On 5 jun 2010, at 10:39, Timo Proescholdt wrote:

Dear Andrew,

Le 04.06.2010 04:22, Andrew Watkins a écrit :

Is there any technical documentation on how GN really does the following?

- if not pointers to the relevant bits of source code would be good.

the geonetwork documentation is in shambles... both for users and
developers. I'd invest some time in making it better, but it seems that
a more
concerted effort would be needed.
However, there is a lot of knowledge here on the list.

1 compares the search bounding box with those in the metadata records

the mechanism this works (for the different search modi like
z3959,csw,..) is the following.
Your query is parsed and converted into a gn internal xml query format.
This format in turn, is then converted into lucene queries.
Most of the conversions are done by xsl transformations, for which you
find the files in /geonetwork/xml/search/ .
Sourcecode-wise, have a look at LuceneSearcher.java

2 ditto for the date ranges

I just worked on the date ranges for z3950, they are in z3959Server.xsl

3 puts keywords, titles and other elements into the search indexes.

this is exactely what the xstt do... mapping between incoming attributes
and lucene indices.

Also how to set the default map view and search region to a specific
region e.g. New Zealand.

that I dont know.

Keep me up to date, there is some work to be done on dates and
boundinxboxes,
maybe we can share forces.

best
Timo

Thanks Andrew

Andrew Watkins

Systems Development Team Manager

National Institute Water & Atmospheric Research (NIWA).

NIWA is the trading name of the National Institute of Water &
Atmospheric Research Ltd.

------------------------------------------------------------------------------
ThinkGeek and WIRED's GeekDad team up for the Ultimate
GeekDad Father's Day Giveaway. ONE MASSIVE PRIZE to the
lucky parental unit. See the prize list and enter to win:
http://p.sf.net/sfu/thinkgeek-promo

_______________________________________________
GeoNetwork-devel mailing list
GeoNetwork-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geonetwork-devel
GeoNetwork OpenSource is maintained at http://sourceforge.net/projects/geonetwork

------------------------------------------------------------------------------
ThinkGeek and WIRED's GeekDad team up for the Ultimate
GeekDad Father's Day Giveaway. ONE MASSIVE PRIZE to the
lucky parental unit. See the prize list and enter to win:
http://p.sf.net/sfu/thinkgeek-promo
_______________________________________________
GeoNetwork-devel mailing list
GeoNetwork-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geonetwork-devel
GeoNetwork OpenSource is maintained at http://sourceforge.net/projects/geonetwork

ticheler · June 12, 2010, 8:34am

Hi Timo,
Thanks a lot for that offer! I will try to get a first edit our next week on SVN. That will then need to be edited extensively on the content and structure part.
Cheers,
Jeroen

On 12 jun 2010, at 10:27, Timo Proescholdt wrote:

Hi Jeroen,

please keep me (us) posted and let me know if you need some help.
I'd be glad to assist.

regards
Timo

Le 09.06.2010 11:55, Jeroen Ticheler a écrit :

Dear all,
I am working this week on moving the documentation to a Sphinx framework, just like GeoServer and other OSGeo projects do these days. I will set it up to also automatically include the Javadoc in the resulting website.

This should, together with a WIKI, give us enough flexibility to maintain better documentation while it also makes it easier for developers and users to generate and maintain new documentation.

I would like to see it replace the current geonetwork-opensource.org Plone based website and parts of the current developer WIKI can also be integrated quickly.

Back soon with more on this.
Cheers,
Jeroen

On 5 jun 2010, at 10:39, Timo Proescholdt wrote:

Dear Andrew,

Le 04.06.2010 04:22, Andrew Watkins a écrit :

Is there any technical documentation on how GN really does the following?

- if not pointers to the relevant bits of source code would be good.

the geonetwork documentation is in shambles... both for users and
developers. I'd invest some time in making it better, but it seems that
a more
concerted effort would be needed.
However, there is a lot of knowledge here on the list.

1 compares the search bounding box with those in the metadata records

the mechanism this works (for the different search modi like
z3959,csw,..) is the following.
Your query is parsed and converted into a gn internal xml query format.
This format in turn, is then converted into lucene queries.
Most of the conversions are done by xsl transformations, for which you
find the files in /geonetwork/xml/search/ .
Sourcecode-wise, have a look at LuceneSearcher.java

2 ditto for the date ranges

I just worked on the date ranges for z3950, they are in z3959Server.xsl

3 puts keywords, titles and other elements into the search indexes.

this is exactely what the xstt do... mapping between incoming attributes
and lucene indices.

Also how to set the default map view and search region to a specific
region e.g. New Zealand.

that I dont know.

Keep me up to date, there is some work to be done on dates and
boundinxboxes,
maybe we can share forces.

best
Timo

Thanks Andrew

Andrew Watkins

Systems Development Team Manager

National Institute Water & Atmospheric Research (NIWA).

NIWA is the trading name of the National Institute of Water &
Atmospheric Research Ltd.

------------------------------------------------------------------------------
ThinkGeek and WIRED's GeekDad team up for the Ultimate
GeekDad Father's Day Giveaway. ONE MASSIVE PRIZE to the
lucky parental unit. See the prize list and enter to win:
http://p.sf.net/sfu/thinkgeek-promo

_______________________________________________
GeoNetwork-devel mailing list
GeoNetwork-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geonetwork-devel
GeoNetwork OpenSource is maintained at http://sourceforge.net/projects/geonetwork

------------------------------------------------------------------------------
ThinkGeek and WIRED's GeekDad team up for the Ultimate
GeekDad Father's Day Giveaway. ONE MASSIVE PRIZE to the
lucky parental unit. See the prize list and enter to win:
http://p.sf.net/sfu/thinkgeek-promo
_______________________________________________
GeoNetwork-devel mailing list
GeoNetwork-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geonetwork-devel
GeoNetwork OpenSource is maintained at http://sourceforge.net/projects/geonetwork

------------------------------------------------------------------------------
ThinkGeek and WIRED's GeekDad team up for the Ultimate
GeekDad Father's Day Giveaway. ONE MASSIVE PRIZE to the
lucky parental unit. See the prize list and enter to win:
http://p.sf.net/sfu/thinkgeek-promo
_______________________________________________
GeoNetwork-devel mailing list
GeoNetwork-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geonetwork-devel
GeoNetwork OpenSource is maintained at http://sourceforge.net/projects/geonetwork