Visualize a collection of georeferenced panoramic photos. Celutz allows users to upload/share/visualize panoramic photos, using an intuitive HTML5 interface. It has been created for easily evaluating line-of-sight links in radio networks.
|Baptiste Jonglez cc57880556 Fix missing clustering change on minimap||1 year ago|
|altitude||2 years ago|
|api||3 years ago|
|celutz||1 year ago|
|media||4 years ago|
|panorama||1 year ago|
|upgrade||3 years ago|
|.gitignore||2 years ago|
|CHANGELOG.md||3 years ago|
|INSTALL.md||2 years ago|
|README.md||1 year ago|
|TODO||3 years ago|
|UPGRADE.md||3 years ago|
|manage.py||3 years ago|
|requirements.txt||1 year ago|
|update_prod.sh||2 years ago|
Visualize a collection of panoramic photos.
Celutz allows you to upload/share/visualize/reference panoramic photos. It has been created for evaluating lines-of-sight for radio networks.
The first version of this tool was written in PHP/js by Marc Souviron, Victor Pongnian, and subsequent work by Jocelyn Delalande. The project originated at tetaneutral.net, a non-profit radio ISP in France.
This is version 2 of celutz, with a backend rewritten in Django. For more
See also some tips on FAImaison wiki (french)
If this is a new installation, you first need to add reference points to the database.
Reference points are needed to visually calibrate panoramic photos: they can be high buildings, clock towers, radio towers, or even natural features such as mountains. In short, reference points should be easily and accurately recognisable when seen on a picture.
To add new reference points, go to the Django admin, for instance at http://localhost:8000/admin/panorama/referencepoint.
You need a name, GPS coordinates, and an altitude. The altitude is relative to the sea level. Celutz queries ground elevation from geonames api, you still have to add the height of the reference point (e.g. height of the building).
Hint: it is better to set the altitude of the topmost part of a building. This is because it will be much easier to aim when viewing a panorama.
You can upload a new panoramic photo from the home page. Besides the actual picture, you need to specify the GPS coordinates where the picture has been made, and the altitude (exactly like reference points). If the picture encompasses 360° (i.e. the left-most edge connects to the right-most edge), then tick the appropriate box.
Once the picture is uploaded, it may take a while for the tiles to be generated. If the visualisation only show grey squares, wait a bit and try to refresh. Depending on the size of the picture and the CPU of the server, generating tiles can take from a few seconds to a minute.
Now, you should be able to zoom and pan in your picture. But the azimuth and elevation are completely wrong, because the panorama is not yet calibrated.
To calibrate it, you need to do the following:
You should repeat these steps for as much reference points as possible, since it will increase the accuracy of the interpolation. The minimum number of reference points is two for normal pictures, and one for 360° pictures.
Once the panorama is calibrated, the azimuth and elevation should be meaningful! You should also see colored circle indicating the location of other panoramas.
This is the main view, where you can pan and scroll a panorama.
In a calibrated panorama, you should see colored circles:
Pgdown: zoom in/out
→: pan the image
End: turn backwards (180°)
You can use the "Locate a point" feature from the homepage. It allows you to locate a point (given its GPS coordinates) on all panoramas at the same time.
For each panorama that can "see" the target point, a direct link is provided to orient the view to the estimated position. This allows you to quickly ascertain whether the target point is actually visible from at least one existing location.
You can help translating celutz in your language! So far, English, French and Spanish translations are available.
To create or update a message file in your language:
./manage.py makemessages -l fr
You can then edit the PO file in
Once you are done, you need to compile your translation:
Then, add both the
django.mo files to git.
For more information, see https://docs.djangoproject.com/en/1.9/topics/i18n/translation/#localization-how-to-create-language-files