Move PDAL java from PDAL repo

Author: pomadchin

.gitignore

@@ -0,0 +1,43 @@
+# Operating System Files
+
+# *.DS_Store
+Thumbs.db
+
+# Build Files
+
+bin
+target
+build/
+.gradle
+
+# Eclipse Project Files
+
+.classpath
+.project
+.settings
+
+# IntelliJ IDEA Files
+
+*.iml
+*.ipr
+*.iws
+*.idea
+
+# Spring Bootstrap artifacts
+
+dependency-reduced-pom.xml
+README.html
+
+# Sublime files
+
+*.sublime-workspace
+
+# Test data files #
+
+java/data
+
+# Compiled libs #
+
+java/*.dylib
+java/*.so
+java/*dll

LICENSE.txt

@@ -0,0 +1,46 @@
+Unless otherwise indicated, all files in the PDAL distribution are
+
+  Copyright (c) 2017, Hobu, Inc. ([email protected])
+
+and are released under the terms of the BSD open source license.
+
+This file contains the license terms of all files within PDAL.
+
+
+Overall PDAL license (BSD)
+===========================
+
+ Copyright (c) 2017, Hobu, Inc. ([email protected])
+
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following
+ conditions are met:
+
+     * Redistributions of source code must retain the above copyright
+       notice, this list of conditions and the following disclaimer.
+     * Redistributions in binary form must reproduce the above copyright
+       notice, this list of conditions and the following disclaimer in
+       the documentation and/or other materials provided
+       with the distribution.
+     * Neither the name of Hobu, Inc. or Flaxen Consulting LLC nor the
+       names of its contributors may be used to endorse or promote
+       products derived from this software without specific prior
+       written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+ OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+ AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
+ OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
+ OF SUCH DAMAGE.
+
+
+

README.md

@@ -0,0 +1,122 @@
+# PDAL Java bindings
+
+[![Join the chat at https://gitter.im/PDAL/PDAL](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/PDAL/PDAL?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+
+Java bindings to use PDAL on JVM (supports PDAL >= 1.4).
+
+## Using PDAL JNI with SBT
+
+```scala
+// pdal is published to maven central, but you can use following repos in addition
+resolvers ++= Seq(
+  Resolver.sonatypeRepo("releases"),
+  Resolver.sonatypeRepo("snapshots") // for snaphots
+)
+
+libraryDependencies ++= Seq(
+  "io.pdal" %% "pdal" % "1.6.0"
+)
+```
+
+It's required to have native JNI binary in `java.library.path`:
+
+```scala
+// Mac OS X example with manual JNI installation
+// Though it's strongly recommended to use WITH_PDAL_JNI during PDAL build
+// cp -f native/target/resource_managed/main/native/x86_64-darwin/libpdaljni.1.4.dylib /usr/local/lib/libpdaljni.1.4.dylib
+// place built binary into /usr/local/lib, and pass java.library.path to your JVM
+javaOptions += "-Djava.library.path=/usr/local/lib"
+```
+
+## PDAL-Scala
+
+Scala API to build pipeline expressions instead of writing a raw JSON.
+
+```scala
+libraryDependencies ++= Seq(
+  "io.pdal" %% "pdal-scala" % "1.6.0"
+)
+```
+
+Scala API covers PDAL 1.6.0 but is compatible with PDAL >= 1.4, to use any custom DSL
+that is not covered by the current Scala API you can use `RawExpr` type to build `Pipeline 
+Expression`.
+
+### Code examples
+
+```scala
+// To construct the expected json
+val expected =
+  """
+     |{
+     |  "pipeline" : [
+     |    {
+     |      "filename" : "/path/to/las",
+     |      "type" : "readers.las"
+     |    },
+     |    {
+     |      "type" : "filters.crop"
+     |    },
+     |    {
+     |      "filename" : "/path/to/new/las",
+     |      "type" : "writers.las"
+     |    }
+     |  ]
+     |}
+  """.stripMargin
+  
+// The same, but using scala DSL
+val pc: PipelineConstructor = LasRead("/path/to/las") ~ CropFilter() ~ LasWrite("/path/to/new/las")
+
+// The same, but using RawExpr, to support not implemented PDAL Pipeline API features
+// RawExpr accepts a circe.Json type, which can be a json object of any desired complexity
+val pcWithRawExpr = LasRead("/path/to/las") ~ RawExpr(Map("type" -> "filters.crop").asJson) ~ LasWrite("/path/to/new/las") 
+```
+
+## How to compile
+
+Development purposes (including binaries):
+  1. Install PDAL (using brew / package managers (unix) / build from sources / etc) _without_ `-DWITH_PDAL_JNI=ON` flag     
+  2. Build native libs `./sbt native/nativeCompile` (optionally, binaries would be built during tests run)
+  3. Run `./sbt core/test` to run PDAL tests
+
+Only Java development purposes:
+  1. Provide `$LD_LIBRARY_PATH` or `$DYLD_LIBRARY_PATH`
+  2. If you don't want to provide global variable you can pass `-Djava.library.path=<path>` into sbt:
+    `./sbt -Djava.library.path=<path>`
+  3. Set `PDAL_DEPEND_ON_NATIVE=false` (to disable `native` project build)
+  4. Run `PDAL_DEPEND_ON_NATIVE=false ./sbt`
+
+Finally the possible command to launch and build PDAL JNI bindings could be:
+
+```bash
+# Including binaries build
+# WARN: PDAL should be built without `-DWITH_PDAL_JNI=ON` flag
+./sbt
+```
+
+```bash
+# Java side development without binaries build
+# WARN: PDAL should be built with `-DWITH_PDAL_JNI=ON` flag
+PDAL_DEPEND_ON_NATIVE=false ./sbt -Djava.library.path=<path>
+```
+
+### Possible issues and solutions
+
+1. In case of not installed as global PDAL change [this](./java/native/src/CMakeLists.txt#L25) line to:
+
+  ```cmake
+  set(CMAKE_CXX_FLAGS "$ENV{PDAL_LD_FLAGS} $ENV{PDAL_CXX_FLAGS} -std=c++11")
+  ```
+  In this case sbt launch would be the following:
+
+  ```bash
+  PDAL_LD_FLAGS=`pdal-config --libs` PDAL_CXX_FLAGS=`pdal-config --includes` ./sbt
+  ```
+
+2. Sometimes can happen a bad dynamic linking issue (somehow spoiled environment),
+   the quick workaround would be to replace [this](./java/native/src/CMakeLists.txt#L25) line to:
+
+  ```cmake
+  set(CMAKE_CXX_FLAGS "-L<path to dynamic libs> -std=c++11")
+  ```

build.sbt

@@ -0,0 +1,81 @@
+name := "pdal-jni"
+
+lazy val commonSettings = Seq(
+  version := "1.7.0" + Environment.versionSuffix,
+  scalaVersion := "2.11.11",
+  crossScalaVersions := Seq("2.12.4", "2.11.11"),
+  organization := "io.pdal",
+  description := "PDAL JNI bindings",
+  licenses := Seq("BSD" -> url("https://github.com/PDAL/PDAL/blob/master/LICENSE.txt")),
+  homepage := Some(url("http://www.pdal.io")),
+  publishMavenStyle := true,
+  pomIncludeRepository := { _ => false },
+  scalacOptions ++= Seq(
+    "-deprecation",
+    "-unchecked",
+    "-language:implicitConversions",
+    "-language:reflectiveCalls",
+    "-language:higherKinds",
+    "-language:postfixOps",
+    "-language:existentials",
+    "-feature"
+  ),
+  test in assembly := {},
+  shellPrompt := { s => Project.extract(s).currentProject.id + " > " },
+  commands ++= Seq(
+    Commands.processJavastyleCommand("publish"),
+    Commands.processJavastyleCommand("publishSigned")
+  ),
+  publishArtifact in Test := false,
+  publishTo := {
+    val nexus = "https://oss.sonatype.org/"
+    if (isSnapshot.value)
+      Some("snapshots" at nexus + "content/repositories/snapshots")
+    else
+      Some("releases"  at nexus + "service/local/staging/deploy/maven2")
+  },
+  pomExtra := (
+    <scm>
+      <url>git@github.com:PDAL/PDAL.git</url>
+      <connection>scm:git:git@github.com:PDAL/PDAL.git</connection>
+    </scm>
+      <developers>
+        <developer>
+          <id>pomadchin</id>
+          <name>Grigory Pomadchin</name>
+          <url>http://github.com/pomadchin/</url>
+        </developer>
+      </developers>
+    )
+)
+
+lazy val root = (project in file("."))
+  .settings(commonSettings: _*)
+  .aggregate(`core-scala`, core, native)
+
+lazy val `core-scala` = project
+  .settings(commonSettings: _*)
+  .settings(name := "pdal-scala")
+  .settings(target in javah := (sourceDirectory in nativeCompile in native).value / "include")
+  .settings(libraryDependencies ++= Seq(
+    Dependencies.circeCore,
+    Dependencies.circeGeneric,
+    Dependencies.circeGenericExtras,
+    Dependencies.circeParser,
+    Dependencies.jtsCore,
+    Dependencies.scalaTest % Test
+  ))
+  .settings(headerLicense := Some(HeaderLicense.ALv2("2017", "Azavea")))
+  .settings(licenses := Seq("Apache-2.0" -> url("https://www.apache.org/licenses/LICENSE-2.0.html")))
+  .dependsOn(core)
+
+lazy val core = project
+  .settings(commonSettings: _*)
+  .settings(name := "pdal")
+  .settings(target in javah := (sourceDirectory in nativeCompile in native).value / "include")
+  .settings(libraryDependencies += Dependencies.scalaTest % Test)
+  .dependsOn(Environment.dependOnNative(native % Runtime): _*)
+
+lazy val native = project
+  .settings(sourceDirectory in nativeCompile := sourceDirectory.value)
+  .enablePlugins(JniNative)

core-scala/src/main/scala/io/pdal/pipeline/ExprType.scala

@@ -0,0 +1,34 @@
+/*
+ * Copyright 2017 Azavea
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.pdal.pipeline
+
+import scala.util.Try
+
+trait ExprType {
+  val `type`: String
+  lazy val name = s"${`type`}.${this.getClass.getName.split("\\$").last}"
+
+  override def toString = name
+}
+
+object ExprType {
+  def fromName(name: String): ExprType =
+    Try(FilterTypes.fromName(name))
+      .getOrElse(Try(ReaderTypes.fromName(name))
+        .getOrElse(Try(WriterTypes.fromName(name))
+          .getOrElse(throw new Exception(s"ExprType $name is not supported."))))
+}