Data

Tools

Indexes

Applications

Experiments

Open Source Science

https://github.com/acdh-oeaw/arche-mapserver

https://github.com/acdh-oeaw/arche-mapserver

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ○
    DOI references
  • ○
    Academic publication links
  • ○
    Committers with academic emails
  • ○
    Institutional organization owner
  • ○
    JOSS paper metadata
  • ○
    Scientific vocabulary similarity
    Low similarity (13.5%) to scientific vocabulary

Keywords

arche
Last synced: 6 months ago · JSON representation

Repository

Basic Info
  • Host: GitHub
  • Owner: acdh-oeaw
  • License: mit
  • Language: PHP
  • Default Branch: master
  • Homepage:
  • Size: 43 KB
Statistics
  • Stars: 0
  • Watchers: 5
  • Forks: 0
  • Open Issues: 5
  • Releases: 3
Topics
arche
Created almost 7 years ago · Last pushed 9 months ago
Metadata Files
Readme License

README.md

ARCHE maps dissemination service

Uses a mapserver to disseminate raster and vector ARCHE resources.

The mapserver is set up to:

  • expose itself at http://{container ip}/cgi-bin/mapserv
  • allow map config files only in the /data directory (subdirs can be used though)

The ARCHE dissemination service is set up to expose itself at http://{container ip}/?id={arche resource URI or ID}&{optional mapserver request parameters}.

The ARCHE dissemination service serves the request by:

  • checking if the ARCHE resource is not cached locally and if not
    • download it into the /data/{md5 sum of the ARCHE resource URI}
    • creating a map config file for it in /data/{md5 sum of the ARCHE resource URI}.map
  • redirecting to the mapserver

Deployment

On each GitHub release a Docker image is rebuild and redeployed on the ACDH-CH cluster using this GitHub Actions script.

Including static data

First of all, please consider if you need to publish your data using the mapserver service. If you have a raster file(s), then until you are forced to provide access to it over the WMS protocol (e.g. because you are bounded by the INSPIRE EU directive), you should be just fine with serving it as XYZ tiles (the protocol used by all web map services like Google Maps, Bing Maps or Open Street Maps and supported by all web map frameworks like Leaflet, Open Layers or Goole Map API). Generation of XYZ tiles pyramid is a matter of a single call to the gdal2tiles.py script and the resulting file structure can be published as static files. An example of doing the tiling inside a GitHub Workflow and publishing the tiles as a GitHub Page is provided by this repository. If you have questions or need help, please contact Mateusz Żółtak or Peter Andorfer.

If you still think you want to use the mapserver service, then static data can be added by extending this file and redeploying the service. This script is run just after the container startup. The data is downloaded after the container startup and not during the container build to avoid storing (potentially large amounts of) data inside the image.

Alternatively a share storing the static data can be mounted in the container under the /data directory or its subdirectory (see the redmine issue #22520).

Please remember you have to provide the map config files for your data. If you find the documentation linked above overwhelming, you can start with minimalistic-yet-useful templates used by the ARCHE dissemination service.

Owner

  • Name: Austrian Centre for Digital Humanities & Cultural Heritage
  • Login: acdh-oeaw
  • Kind: organization
  • Email: acdh@oeaw.ac.at
  • Location: Vienna, Austria

GitHub Events

Total
  • Push event: 1
Last Year
  • Push event: 1

Committers

Last synced: 9 months ago

All Time
  • Total Commits: 23
  • Total Committers: 1
  • Avg Commits per committer: 23.0
  • Development Distribution Score (DDS): 0.0
Past Year
  • Commits: 0
  • Committers: 0
  • Avg Commits per committer: 0.0
  • Development Distribution Score (DDS): 0.0
Top Committers
Name Email Commits
Mateusz Żółtak z****k@z****g 23
Committer Domains (Top 20 + Academic)
zozlak.org: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 2
  • Total pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Total issue authors: 1
  • Total pull request authors: 0
  • Average comments per issue: 0.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 0
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 0
  • Pull request authors: 0
  • Average comments per issue: 0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
  • zozlak (2)
Pull Request Authors
Top Labels
Issue Labels
enhancement (1)
Pull Request Labels

Dependencies

composer.json packagist
  • acdh-oeaw/easyrdf ^0.13.2
  • guzzlehttp/guzzle ~6.0
  • zozlak/rest ^4.4
.github/workflows/deploy.yaml actions
  • actions/checkout v4 composite
  • docker/login-action v3 composite
build/Dockerfile docker
  • php 8.1-apache build