Skip to main content

Django app that imports CAD drawings in Leaflet.js maps

Project description

Django app that imports CAD drawings in Leaflet maps

Overview

Show CAD drawings in interactive web maps, download previously uploaded files with geo location, download CSV files with extracted data.

Requirements

This app is tested on Django 5.1.1 and Python 3.12. It heavily relies on outstanding ezdxf for handling DXF files, pyproj for geographic projections, shapely for polygon verification, django-leaflet for handling maps, django-geojson for storing geodata, django-colorfield for admin color fields. The library relies on GDAL, which is system specific.

Installation from PyPI

Activate your virtual environment and install with:

python -m pip install django-geocad

In your Django project add:

INSTALLED_APPS = [
    # ...
    "easy_thumbnails",
    "leaflet",
    "djgeojson",
    "colorfield",
    "djeocad",
]
# my_project/urls.py
urlpatterns = [
    # ...
    path('geocad/', include('djeocad.urls', namespace = 'djeocad')),
]

Migrate and collectstatic. You also need to add initial map defaults to settings.py (these are the settings for Rome, change them to your location of choice):

LEAFLET_CONFIG = {
    "DEFAULT_CENTER": (41.8988, 12.5451),
    "DEFAULT_ZOOM": 10,
    "RESET_VIEW": False
}

Add two lists to my_project/settings.py:

CAD_LAYER_BLACKLIST = [...]
CAD_BLOCK_BLACKLIST = [...]

Here you can store names of layers and blocks you don’t want to be processed.

Templates

You also need a base.html template with following template blocks (a sample base.html is provided among package templates).

{% block extra-head %}
{% end block extra-head %}
...
{% block content %}
{% endblock content %}

Package comes with two templates, djeocad/drawing_list.html and djeocad/drawing_detail.html. Copy and override them in your project templates to add your styles.

View drawings

Locally browse to 127.1.1.0:8000/geocad/to see a List of all drawings, where drawings are just markers on the map. Click on a marker and follow the link in the popup: you will land on the Drawing Detail page, with layers displayed on the map. Layers may be switched on and off.

Create drawings

To create a Drawing you must be able to access the admin with GeoCAD Manager permissions. You will also need a DXF file in ASCII format. DXF is a drawing exchange format widely used in CAD applications. Try uploading files with few entities at the building scale, as the conversion may be inaccurate for small items (units must be in meters).

Geodata & Reference Point

If geodata is embedded in the file, the drawing will be imported in the exact geographical location. If geodata is unavailable, you will have to insert it manually: to geolocate the drawing you need to define a Reference point on the drawing of known Latitude / Longitude.

Design Point

Mark the point on the map and eventually insert it’s coordinates with respect to the DXF World Coordinate System origin (0,0,0). A good position for the Reference / Design point could be the cornerstone of a building, or another geographic landmark.

Rotation

Check also the rotation of the drawing with respect to the True North: it is typical to orient the drawings most conveniently for drafting purposes, unrespectful of True North. Please note that in CAD counterclockwise rotations are positive, so if you have to rotate the drawing clockwise to orient it correctly, you will have to enter a negative angle.

Geodata from Parent

Alternatively, you can select a Parent drawing, that will lend geolocation to uploaded file. This can be useful when you want to upload different floors of a single building.

Extraction

Press the Save button. If all goes well the DXF file will be extracted and a list of Layers will be attached to your drawing. Each layer inherits the Name and color originally assigned in CAD. POINT, ARC, CIRCLE, ELLIPSE, SPLINE, 3DFACE, HATCH, LINE and LWPOLYLINE entities are visible on the map panel, where they inherit layer color. If unnested BLOCKS are present in the drawing, they will be extracted and inserted on respective layer.

Downloading

In Drawing Detail view it is possible to download back the DXF file. GeoData will be associated to the DXF, so if you work on the file and upload it again, it will be automatically located on the map.

CSV

You can also download a CSV file that contains basic informations of some entities, notably Polylines and Blocks. Layer, surface (only if closed), perimeter, width and thickness are associated to Polylines, while block name, insertion point, scale, rotation and attribute key/values are associated to Blocks. If a TEXT/MTEXT is contained in a Polyline of the same layer, also the text content will be associated to the entity. This can be helpful if you want to label rooms.

Modify drawings

You can modify geolocation and appearance of drawings, but the DXF will not be affected. If you want to modify the file, download it and use your favourite CAD application, then upload it back again (it will be already geolocated!).

About Geodata

Geodata can be stored in DXF, but ezdxf library can’t deal with all kind of Coordinate Reference Systems (CRS). If Geodata is not found in the file (or if the CRS is not compatible) django-geocad asks for user input: the location of a point both on the map and on the drawing coordinates system, and the rotation with respect to True North. The pyproj library hands over the best Universal Transverse Mercator CRS for the location (UTM is compatible with ezdxf). Thanks to UTM, Reference / Design Point and rotation input, Geodata can be built from scratch and incorporated into the file.

Tests

Tests with unittest, 98% coverage, missing some special conditions in DXF extraction. Tested for Django 4.2 and 5.1 and Python 3.9, 3.10, 3.11, 3.12 versions.

Project details


Download files

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

Source Distribution

django_geocad-0.4.0.tar.gz (49.1 kB view details)

Uploaded Source

Built Distribution

django_geocad-0.4.0-py3-none-any.whl (50.9 kB view details)

Uploaded Python 3

File details

Details for the file django_geocad-0.4.0.tar.gz.

File metadata

  • Download URL: django_geocad-0.4.0.tar.gz
  • Upload date:
  • Size: 49.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.10.12

File hashes

Hashes for django_geocad-0.4.0.tar.gz
Algorithm Hash digest
SHA256 91f38ff2a265443356934bb4ae77618abe9b2b78f4d5f8d1f94c9cc2cf245a97
MD5 e038deea807b25b941e69135c72731c7
BLAKE2b-256 78448f02479b33b0be685163de1a49d641a032ca56a08ddf44a06f2dd2428c4f

See more details on using hashes here.

File details

Details for the file django_geocad-0.4.0-py3-none-any.whl.

File metadata

File hashes

Hashes for django_geocad-0.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8458649f5f392dfe597c3cf543049c378d68315c7e12b82c6817eb2ca6e17e58
MD5 7ac7b02e78cc7afdd1f25393a300e2df
BLAKE2b-256 330c67af1a091128aa13acada63cb309e5a390d1f6a6a745331cc6e18e4ef620

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page