SVOCat Documentation

Version 3.1, April 2025, author: Carlos Rodrigo, Raúl Gutiérrez

HomeDownloadDocumentationExamplesCreditsHelp-Desk
1. Introduction
2. Install Docker version
3. The files
4. Example
5. Configure
    5.1. First
    5.2. Project
    5.3. Mysql
    5.4. Web
    5.5. VO options
    5.6. Fields
    5.7. Photometry
    5.8. Search Opts.
    5.9. File Paths
    5.10. Scripts
    5.11. Registry
    5.12. Spectra
    5.13. Links
    5.14. References
6. Edit
7. Web Design
    7.1. style.css
    7.2. Colors
    7.3. header.php
    7.4. footer.php
8. Extra tips
(You can see this documentation as a single web page if you wish)

  Next

Introduction

SVOCat is an application intended to make easier the publication of an astronomical catalogue, both as a web page and as a Virtual Observatory ConeSearch service.

Our intention is not no make it "magical" so that it makes all the work for you. We have tried to make it so that it's easier for you to learn about what is being done, to start the installation and configuration process at different steps if you wish, and to change the application if you need to do it for your case.

Requirements:

(See some technical details below)

We assume that:

  • Your catalogue can be seen as a single table with several columns (one for each property provided by the catalogue) and several lines (one for each catalogue entry, for instance, each observed object)
  • Two of the columns give RA and DEC in decimal degrees.

and that your have your data either:

  • as a csv file with different columns separated by commas. It can be a series of different csv files with the same structure if your catalogue is very big and you prefer to split it in different files.
  • as a table in a mysql database.

If you have the data in another format just transform it to csv. In any case, at the end of the day we will need the database table. If you already have it (or you want to create it in your own way) you don't need a csv file and you can skip some steps in the installation process.

Installation summary:

  1. Run the Docker images as described in Install Docker version.

  2. Access the admin.php file with a web navigator to configure everything.

  3. Create the database tables using the scripts that will be created in the configuration process (or any other method)

  4. Edit the style files to make the web pages look as you wish.

Technical details:

We have tested the application only in Ubuntu Linux, in particular in several different installations, at least:

  • Ubuntu 10.04+Apache 2.2.14+MySQL 5.1.63+PHP 5.3.2
  • Ubuntu 12.04+Apache 2.2.22+MySQL 5.5.35+PHP 5.3.10
  • Ubuntu 14.04+Apache 2.4.7 +MySQL 5.5.49+PHP 5.5.9
  • Ubuntu 16.04+Apache 2.4.18+MySQL 5.6.16+PHP 7.0.33
  • Ubuntu 18.04+Apache 2.4.29+MySQL 10.1.44(MariaDB)+PHP 7.2.24

and some examples in this documentation are specific for linux/unix systems.

We have created Docker images and a docker-compose configuration for your convenience, where everything is already set up for you.

  Next