# HiVision

**Repository Path**: vev_hj/HiVision

## Basic Information

- **Project Name**: HiVision
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-05-24
- **Last Updated**: 2021-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HiVision


## [Online Demo1](http://www.higis.org.cn:8080/hivision/) 

## [Online Demo2](http://www.higis.org.cn:8080/hivision_with_pattern/)



## Setting: 

***Tab1. Datasets: Roads, POI and Farmland of Mainland China (10-million-scale)***

| Name                    | Type       | Records    | Size                 |
| ----------------------- | ---------- | ---------- | -------------------- |
| China_Mainland_Road     | LineString | 21,898,508 | 163,171,928 segments |
| China_Mainland_POI      | Point      | 20,258,450 | 20,258,450 points    |
| China_Mainland_Farmland | Polygon    | 10,520,644 | 133,830,561 edges    |

***Tab2.  Demo Environment***

| Item             | Description                                    |
| ---------------- | ---------------------------------------------- |
| CPU              | 4core, Intel(R) Xeon(R) CPU E5-2680 v3@2.50GHz |
| Memory           | 32 GB                                          |
| Operating System | Centos7                                        |

#### Application Scenarios:

The datasets (see Tab 1) used in the demonstration are provided by map service providers. As the datasets are not open published, the raw datasets are encrypted by adding offsets. The interface of the demonstration is simple to use, choose a dataset and click the Enter button, then the visualizing results will be added to the map in real time. Fig 1-4 show the visualizing results.

![fig1](./figures/f1.jpg)

*Fig1. China Mainland POI*

![fig2](./figures/f2.jpg)

*Fig2. China Mainland roads*

![fig3](./figures/f3.jpg)

*Fig3. China Mainland farmlands*

![fig4](./figures/f4.jpg)

*Fig4. Patterns filling for polygon objects*

## Open Source

#### Software dependencies（[tutorial](./dep_software/dep_software_install.txt) for installing the software from source code）:

[Redis](https://redis.io) (recommended version 3.2.12)

[hiredis](https://github.com/redis/hiredis) (recommended version 1.0.0)

[MPICH](http://www.mpich.org/) (recommended version 3.3.2)

[Boost C++ Libraries](https://www.boost.org/) (recommended version 1.72)

[Geospatial Data Abstraction Library (GDAL)](http://www.gdal.org/) >=2.0 (recommended version 2.4.4)

[libpng](http://www.libpng.org/pub/png//libpng.html) (recommended version 1.2.59)

#### Compile:

All the source codes are included in **HiVision_code**. Run the following command to generate the executable programs:

> ```shell
> cd HiVision_code # Go to source directory
> mkdir build # Create a build directory
> cd build # Move into build directory
> cmake .. # Configure for your system
> make # Generate the executable programs
> cd .. # Move back to source directory
> ```

#### Run& Stop:

Edit the following parameters in "start.sh":

**indexpath**: path to store the spatial indexes (default : "./indexes/")

**shppath**: path of the input shapefiles (default : "./datasets/alaska_OSM/")

**patternpath**: path of the input patterns(default : "./patterns/")

**process**: MPI process count (default:4)

**redishost**: host IP of Redis (default:"127.0.0.1")

**redisport**: host Port of Redis (default:6379)

**serviceport**: port of the service (default:10080)

Then run the following scripts to start/stop HiVision automatically:

> ```shell
> $ sh ./start.sh
> ```

> ```shell
> $ sh ./stop.sh
> ```

#### Registration& Visualization Service:

Registration (Point: type=0/ LineString: type=1/ Polygon: type=2):

> ```react
> http://localhost:10080/HiVision/add/{shapefile_name}/{id}/{type}
> ```

Visualization WMTS:

> ```react
> http://localhost:10080/HiVision/{index_id}/{R}/{G}/{B}/{A}/{z}/{x}/{y}.png
> ```

Example:

> ```react
> (Point) datasets/alaska_OSM/gis_osm_places_free_1.shp 
> http://localhost:10080/HiVision/add/gis_osm_places_free_1/places/0
> http://localhost:10080/HiVision/pplaces/{R}/{G}/{B}/{A}/{z}/{x}/{y}.png
> (LineString) datasets/alaska_OSM/gis_osm_roads_free_1.shp
> http://localhost:10080/HiVision/add/gis_osm_roads_free_1/roads/1
> http://localhost:10080/HiVision/lroads/{R}/{G}/{B}/{A}/{z}/{x}/{y}.png
> (Polygon) datasets/alaska_OSM/gis_osm_buildings_a_free_1.shp 
> http://localhost:10080/HiVision/add/gis_osm_buildings_a_free_1/buildings/2
> http://localhost:10080/HiVision/abuildings/{R}/{G}/{B}/{A}/{z}/{x}/{y}.png
> ```



## Contact

Mengyu Ma@ National University of Defense Technology

Email: mamengyu10@nudt.edu.cn

Tel:+8615507487344