nn# void - Visnjan Observatory Image Database

Setup

PostgreSQL

Ubuntu / Debian

1. cd into setup folder

2. Run bash install_requirements.sh and press [ENTER] to continue

3. Execute the following commands:

   1. sudo -i -u postgres
   2. createuser <user> -P --interactive

4. Answer "n" to superuser and "y" to other questions

5. Create a new database: createdb <db_name>

6. Run Setup.py <db> (--user=USER) (--passwd=PASSWORD) (--src=IMAGES_FOLDER_PATH) [--host=HOST] [--port=PORT]

7. The dataset folder contains sample images and can used for testing: --src dataset

Mac

Using Homebrew for simplicity, not required.

1. Install Homebrew
2. Install PostgreSQL bash brew install postgres

• or brew upgrade postgres if already installed

1. Permission for for OS X Mojave: bash sudo mkdir /usr/local/Frameworks sudo chown $(whoami):admin /usr/local/Frameworks
2. Install PostGIS bash brew install postgis
3. Start the service: bash brew services start postgresql

void package

virtual environment

It is a bad idea to use global Python installation. Here we are making a virtual environment using pyenv, but any similar solution will work.

brew install pyenv
pyenv install 3.7.1
pyenv virtualenv 3.7.1 void
cd somewhere
mkdir void_project
cd void_project
pyenv local void

source code

If you just wish to use void, download and install the release package:

curl -OL https://github.com/astrohr/void/archive/0.0.1.tar.gz
tar -xvzf 0.0.1.tgz
cd void-0.0.1
pip install .

For development, checkout the repo instead:

git clone git@github.com:frnhr/void.git .
pip install -e .[dev]

Testing

Two ways to run tests manually: * run tests as a python module: python -m void.tests * run directly: void/tests/__main__.py

Usage

...