#########################################################################
# This program is Copyright (C) 1998-1999 Stephen Kelley. MdSpatial.1.0 #
# and subsequent releases, unless stated explicitly are provided to you #
# you without charge, and with no warranty.  You may give away copies of#
# MdSpatial.1.0, including sources, provided that this notice is        #
# included in all the files.                                            #
#########################################################################

			Multi-dimensional Spatial Datablade Module

				MdSpatial.1.0

----------------------------------------------------------------------------
[Created November 1999]
[Original Author	Steve Kelley	skelley@umiacs.umd.edu]


	This Spatial Datablade module, based on both the Informix Shapes2
datablade module and on Rtree software developed by the original author,
provides multidimensional spatial (opague) types for the Informix Universal
Server.  It also provides the methods required by Informix to create and
maintain spatial (rtree) indexes, and various cast and type constructor
functions.


Contents
--------
	1) Read the Copyright - this will be put under GNU Copyleft
	as soon as the author has time.  If this turns out useful he'd
	like some credit, that's all.

	2) Software Requirements

	3) Getting Started


1) Software Requirements
   =====================
	To build and run MdSpatial.1.0, you need a C compiler that can build
a shared object and link it with Informix and the Informix Dynamic Server
with Universal Data Option (IDS-UDO) release 9.14 UC2 or higher.

	MdSpatial.1.0 was tested with the systems and software releases
listed below:

	SGI:
		IRIX 5.3
		IDS-UDO 9.14.UC2
		C compiler

	SUN:
		Solaris 2.5.1, 2.6
		IDS-UDO 9.14.UC2
		SUNpro, GNU C compilers

----------------------------------------------------------------------------

2) Getting Started
   ===============

Check/Initialize Your Informix Environment
------------------------------------------
	Make sure the following environmental variables are set correctly:
INFORMIXDIR	directory where Informix was installed
TARGET		$INFORMIXDIR/incl/dbdk/makeinc.solaris


Download the Distribution
-------------------------

Download the MdSpatial.1.0.tar.gz compressed tar archive from:
	ftp://

Uncompress and Extract the archive:
	gzcat MdSpatial.1.0.tar.gz | tar -xvf -

Create a directory:
	mkdir $INFORMIXDIR/extend/MdSpatial.1.0


The distribution creates a directory structure under MdSpatial.1.0 as
follows:

README		This text file

scripts/	SQL type and function creation scripts.  Copy these to
		$INFORMIXDIR/extend/MdSpatial.1.0

src/		Source code for the UDTs and UDRs

		Build a Solaris shared object:
		make -f Makefile mdspatial

		Install the shared object:
		cp MdSpatial.bld $INFORMIXDIR/extend/MdSpatial.1.0

utilities/	programs to create test data
		make all

bin/		utilitiy programs placed here

doc/		documentation for spatial types and methods, miscellaneous
		scripts and programs