geotools/README.html at master · BanjoInc/geotools · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
	<TITLE>GeoTools @RELEASE@ README</TITLE>
	<META NAME="GENERATOR" CONTENT="LibreOffice 3.3  (Linux)">
	<META NAME="CREATED" CONTENT="0;0">
	<META NAME="CHANGEDBY" CONTENT="Jody Garnett">
	<META NAME="CHANGED" CONTENT="20110428;21541200">
	<META NAME="CocoaVersion" CONTENT="1038.11">
	<META NAME="CHANGEDBY" CONTENT="Jody Garnett">
	<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
	<STYLE TYPE="text/css">
	<!--
		H1.western { font-family: "Liberation Sans", sans-serif }
		H2.cjk { font-family: "WenQuanYi Micro Hei" }
		H2.ctl { font-family: "Lohit Hindi" }
		H3.western { font-family: "Liberation Sans", sans-serif }
		H3.cjk { font-family: "WenQuanYi Micro Hei" }
		H3.ctl { font-family: "Lohit Hindi" }
	-->
	</STYLE>
</HEAD>
<BODY LANG="en-AU" DIR="LTR">
<a href="http://geotools.org"><img src="README-geotools-logo.png"></a>
<H1 CLASS="western">GeoTools @RELEASE@</H1>
<P>Thank you for downloading GeoTools @RELEASE@. This release was
created on @DATE@.</P>

<P>This release contains only a subset of the current GeoTools code
base. The full GeoTools code base contains additional unsupported
modules covering experiments with a range of additional data formats.
Only the modules which are considered to be stable have been included
in this release.</P>

<P>For more information, and documentation on the GeoTools library
please see the <A HREF="http://docs.geotools.org/latest/userguide/">GeoTools
User Guide</A>.</P>
<P>The user guide includes the following tutorials:</P>
<UL>
	<LI><P><A HREF="http://docs.geotools.org/latest/userguide/tutorial/quickstart/index.html">Quickstart</a> (<A HREF="http://docs.geotools.org/latest/userguide/tutorial/quickstart/eclipse.html">Eclipse
	</A>, <A HREF="http://docs.geotools.org/latest/userguide/tutorial/quickstart/netbeans.html">Netbeans
	</A> or <A HREF="http://docs.geotools.org/latest/userguide/tutorial/quickstart/maven.html">Maven</a>)</P>
	<LI><P><A HREF="http://docs.geotools.org/latest/userguide/tutorial/feature/csv2shp.html">Feature
	Tutorial</A></P>
	<LI><P><A HREF="http://docs.geotools.org/latest/userguide/tutorial/geometry/geometrycrs.html">Geometry
	CRS Tutorial</A></P>
	<LI><P><A HREF="http://docs.geotools.org/latest/userguide/tutorial/filter/query.html">Query
	Tutorial</A></P>
	<LI><P><A HREF="http://docs.geotools.org/latest/userguide/tutorial/raster/image.html">Image
	Tutorial</A></P>
	<LI><P><A HREF="http://docs.geotools.org/latest/userguide/tutorial/map/style.html">Map
	Style Tutorial</A></P>
	<LI>Additional <A HREF="http://docs.geotools.org/latest/userguide/tutorial/index.html"> tutorials</A> cover topics such as making your own function, process or datastore.</LI>
</UL>

<P>Welcome to GeoTools development!</P>
<H2 CLASS="western">Reference</H2>
<P>The following is provided as a quick reference only, please the the <A HREF="http://docs.geotools.org/latest/userguide/">GeoTools
User Guide</A>.</P>
<H3 CLASS="western">Runtime Envrionment</H3>
<P>To use the GeoTools libraries you will need:</P>
<UL>
	<LI>Java 8: Oracle and OpenJDK implementations tested</LI>
	<LI>Notice: to use Java 7 please use the earlier GeoTools 14 series.</LI>
	<LI>Notice: to use Java 6 please use the earlier GeoTools 11 series.</LI>
	<LI>Warning: Java 9 is not yet supported</LI>
</UL>
<P>GeoTools performance will benefit from the installation of Java Advanced Imaging
(JAI) and the Java Image IO (JIO) extensions in your JRE. GeoTools will use the pure java implementation of these libraries if the native extensions are not installed.</P>
<P>
Additional spatial
formats are provided by the ImageIO-Ext project including raster formats such as MRSID and ECW. Detailed instructions
on configuring your JDK with these optional extensions can be found
in our developers guide <A HREF="http://docs.geotools.org/latest/userguide/build/install/jdk.html">here</A>.</P>
<H3 CLASS="western">Oracle (Optional)</H3>
<P>In order to use the gt-oracle or gt-jdbc-oracle modules, you need
the Oracle JDBC driver from Oracle. Unlike most external libraries
used in GeoTools, we cannot redistribute this jar.</P>
<P>However, you can obtain them from the Oracle website, free of
charge, after registering:</P>
<UL>
	<LI><P><A HREF="http://www.oracle.com/technetwork/database/features/jdbc/index.html">http://www.oracle.com/technetwork/database/features/jdbc/</A></P>
</UL>
<P>Please see the users guide for detailed instructions.</P>
<H3 CLASS="western">Building (Optional)</H3>
<P>In order to build GeoTools you will need a copy of <A HREF="http://maven.apache.org/download.html">Maven</A>. Maven is a project management tool from the Apache group.</P>
<P>Once you have maven installed, you can perform a full build by
moving to the GeoTools folder and typing:</P>
<P STYLE="margin-left: 2cm">mvn install</P>
<P>Please read the <A HREF="http://docs.geotools.org/latest/userguide/build/maven/index.html">User
Guide</A> for more information about maven.</P>
<H3 CLASS="western">Getting Involved (Recommended)</H3>
<P>The <A HREF="mailto:geotools-gt2-users@lists.sourceforge.net">gt2-users
mailing list</A> is provided for general inquiries, with additional
<A HREF="http://docs.geotools.org/latest/userguide/welcome/support.html">support
options</A> are available in the user guide.</P>
<P>If you are interested in the future development of GeoTools join the <A HREF="http://docs.geotools.org/latest/developer/communication.html">geotools-devel</A>
mailing list. We welcome contributions of new modules as well as keen
developers who want to work on the project as a whole. For background on how the project functions see the <A HREF="http://docs.geotools.org/latest/developer/">Developers'
Guide</A>.
</P>
<P>For the latest news, or to find out more about the mailing lists visit the <A HREF="http://geotools.org/">GeoTools Homepage</A>.</P>
<P>Good luck and thanks for your interest in GeoTools,</P>
<P><I>The GeoTools Project Management Committee, Open Source
Geospatial Foundation</I></P>
</BODY>
</HTML>