This project was created during the IT-Project course at JKU by Feyza Bozkaya, Paul Feichtenschlager, Josef Niedereder and Alexander Wolf.
This project relies on the AWS S3 service and its SDK, therefore an AWS account is required. In our own deployment we used AWS EC2 and RDS aswell but you can use other services aswell.
After cloning the project on your own server, create a .env file with the following information: (Note: for the install script to work there need to no spaces before and after the equal signs and a new line at the end of the file)
COOKIE_SECRET=secret string used for cookie creation
HOST=host.ip.of.your.database.instance
DATABASE_USER=name of your database user
PASSWORD=password for your database user
PORT=Database port to be used (probably 3306)
AWS_ACCESS_KEY_ID=access key id used for pushing point clouds to S3
AWS_SECRET_ACCESS_KEY=secret access key used for pushing point clouds to S3
REGION=The region you are using for your AWS account
BASE_URL=The base URL of your project (depending on if in deployment or not)
S3_BUCKET_BASE_URL=The base URL for the S3 Bucket the point clouds are hosted on
After creating the file run the install.sh script.
On the main page, a user who is not logged in sees only a table "Public Clouds" with the links to the 3D point clouds.
In order to uploud own your own files or view the uploaded files, the user must log in. (If the user is not already registered, an acoount must be created)
It is also possible to search for desired point clouds in the respective tables or delete the file that are not needed.
The user can create a new account by filling in the two text fields "Username" and "Password" and then clicking the Submit button.
Users can log in by providing their username and password that they entered during registration and clicking "Submit".
On this page, users can uploud their LAS file, which should be illustrated. The file can be selected by cklicking the button "Datei auswählen". (If desited, after selecting the file name can be changed.) With a click on "Submit" the file will be uploaded and converted.
The progress of this operations is illustrated with the bars. It is possible to cancel or pause an upload by clicking of the particular button.
After the conversion is completed, the user gets the following message "Process now completed. You can view your pointcloud here".
With a click on "here" the user will be redirected to the uploaded point cloud.
