Skip to main content

ETC42 Universal Exposure Time Calculator

Project description

ETC42-docker-python
===================

# Authors

CeSAM (Centre de donnéeS Astrophysique de Marseille) at LAM (Laboratoire d'Astrophysique de Marseille)

# About ETC42-docker-python:

ETC42-docker-python is a python module use to launch etc42

# Requirements

1. For Linux users:

* python3

* virtualenv
```
pip install --user virtualenv
```
* docker

* The Docker daemon binds to a Unix socket instead of a TCP port. By default that Unix socket is owned by the user root and other users can only access it using sudo. The Docker daemon always runs as the root user.
The docker commands used by ETC42-docker-python can not be prefaced with sudo
To use ETC42-docker-python correctly we must create a Unix group called docker and add users to it:
```
sudo groupadd docker
sudo usermod -aG docker $USER
```
2. For MAC-OS users:

* python3

* venv
```
pip install --user venv
```
* You must have docker on your mac.(see [Mac-OS docker installation](https://docs.docker.com/docker-for-mac/install/))
* You have to install XQuartz with command line `brew cask install xquartz` (see [XQuartz installation](https://www.xquartz.org/index.html) for MacPorts or others installations type).

__*note*__: don't forget to select __Allow connections from network clients__ on XQuartz preferences (preferences -> security)

# Installation

1. Create a folder for the project ETC42 that will contain all the files needed to run an instance etc42:
```
mkdir ETC42
cd ETC42
```

2. Clone the etc42-docker-python repository:
```
git clone git@gitlab.lam.fr:etc42/etc42-docker-python.git
```

3. create virtualenv:
```
virtualenv -p python3 virtualenv_etc42
source virtualenv_etc42/bin/activate
```
or
```
python3 -m venv virtualenv_etc42
source virtualenv_etc42/bin/activate
```


4. install the python modules and the etc42:
```
cd etc42-docker-python
pip install -r pip-requirements.txt
pip install -e .
```

# How to use it

1. if it is not started, use the virtual environment created previously:
```
source virtualenv_etc42/bin/activate
```

2. launch the etc42:
```
etc42
```

To see all etc42 options available:
```
etc42 -h or --help
```



# Create sphinx documentation
```
source virtualenv_etc42/bin/activate
cd docs
sphinx-apidoc -f -o source/ ../etc42/
sphinx-build -b latex source/ build/
cd build
make
```


Project details


Release history Release notifications

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
etc42-1.0.1-py2.py3-none-any.whl (9.2 kB) Copy SHA256 hash SHA256 Wheel py2.py3

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page