Python hạ cấp conda

Cài đặt với Anaconda/conda

Để cài đặt GeoPandas và tất cả các phụ thuộc của nó, chúng tôi khuyên bạn nên sử dụng trình quản lý gói conda. Điều này có thể đạt được bằng cách cài đặt Bản phân phối Anaconda [bản phân phối Python miễn phí cho khoa học dữ liệu] hoặc thông qua miniconda [bản phân phối tối thiểu chỉ chứa Python và trình quản lý gói conda]. Xem thêm tài liệu cài đặt để biết thêm thông tin về cách cài đặt Anaconda hoặc miniconda cục bộ

Ưu điểm của việc sử dụng trình quản lý gói conda là nó cung cấp các tệp nhị phân dựng sẵn cho tất cả các phụ thuộc bắt buộc và tùy chọn của GeoPandas cho tất cả các nền tảng [Windows, Mac, Linux]

Để cài đặt phiên bản mới nhất của GeoPandas, sau đó bạn có thể thực hiện

conda install geopandas

conda install --channel conda-forge geopandas

conda create -n geo_env
conda activate geo_env
conda config --env --add channels conda-forge
conda config --env --set channel_priority strict
conda install python=3 geopandas

Cài đặt bằng pip

GeoPandas cũng có thể được cài đặt bằng pip, nếu tất cả các phụ thuộc cũng có thể được cài đặt

pip install geopandas

Cảnh báo

Khi sử dụng pip để cài đặt GeoPandas, bạn cần đảm bảo rằng tất cả các phụ thuộc đã được cài đặt chính xác

• fiona cung cấp các bánh xe nhị phân với các phụ thuộc được bao gồm cho Mac và Linux, nhưng không dành cho Windows. Ngoài ra, bạn có thể cài đặt pyogrio có bánh xe cho Windows

• pyproj, rtree và cung cấp bánh xe nhị phân một cách khéo léo với các phụ thuộc được bao gồm cho Mac, Linux và Windows

Tùy thuộc vào nền tảng của bạn, bạn có thể cần biên dịch và cài đặt các phụ thuộc C của chúng theo cách thủ công. Chúng tôi tham khảo các gói riêng lẻ để biết thêm chi tiết về cách cài đặt các gói đó. Sử dụng conda [xem ở trên] để tránh phải tự biên dịch các phụ thuộc

Cài đặt từ nguồn

Bạn có thể cài đặt phiên bản phát triển mới nhất bằng cách sao chép kho lưu trữ GitHub và sử dụng pip để cài đặt từ thư mục cục bộ

git clone https://github.com/geopandas/geopandas.git
cd geopandas
pip install .

Cũng có thể cài đặt phiên bản phát triển mới nhất trực tiếp từ kho lưu trữ GitHub với

pip install git+git://github.com/geopandas/geopandas.git

Để cài đặt GeoPandas từ nguồn, điều tương tự cũng áp dụng cho nhu cầu cài đặt chính xác tất cả các phụ thuộc. Tuy nhiên, những phần phụ thuộc đó cũng có thể được cài đặt độc lập với conda trước khi cài đặt GeoPandas từ nguồn

conda install pandas fiona shapely pyproj rtree

Xem phần trên để biết thêm chi tiết về cách chạy với Anaconda

phụ thuộc

phụ thuộc bắt buộc

• cục mịch

• gấu trúc [phiên bản 1. 0 trở lên]

• tạo dáng [giao diện với GEOS; phiên bản 1. 7 trở lên]

• fiona [giao diện với GDAL; phiên bản 1. 8 trở lên]

• pyproj [giao diện cho PROJ; phiên bản 2. 6. 1 trở lên]

• đóng gói

Hơn nữa, có các phụ thuộc tùy chọn

• pyogrio [tùy chọn; thay thế thử nghiệm cho fiona]

• rtree [tùy chọn; chỉ mục không gian để cải thiện hiệu suất và cần thiết cho các hoạt động lớp phủ; giao diện với libspatialindex]

• psycopg2 [tùy chọn; cho kết nối PostGIS]

• GeoAlchemy2 [tùy chọn; để ghi vào PostGIS]

• geopy [tùy chọn; để mã hóa địa lý]

Để vẽ đồ thị, các gói bổ sung này có thể được sử dụng

• matplotlib [>= 3. 2. 0]

• mapclassify [>= 2. 4. 0]

Sử dụng phụ thuộc PyGEOS tùy chọn

Chú ý

Sắp tới Shapely 2. 0 sẽ hấp thụ tất cả các cải tiến từ PyGEOS. Nếu bạn đang cân nhắc dùng thử những cải tiến đó, thay vào đó, bạn cũng có thể thử nghiệm bản phát hành trước của Shapely. Xem ghi chú phát hành của Shapely 2. 0 và shapely/shapely#1464 về cách cài đặt cái này và đưa ra phản hồi

Công việc đang diễn ra để cải thiện hiệu suất của GeoPandas. Hiện tại, việc triển khai nhanh các hoạt động không gian cơ bản nằm trong gói PyGEOS [nhưng công việc đang được tiến hành để đóng góp những cải tiến đó cho Shapely, sắp ra mắt Shapely 2. 0]. Bắt đầu với GeoPandas 0. 8, bạn có thể tùy chọn sử dụng các phần tăng tốc thử nghiệm đó bằng cách cài đặt PyGEOS. Điều này có thể được thực hiện với conda [sử dụng kênh conda-forge] hoặc pip

# conda
conda install pygeos --channel conda-forge
# pip
pip install pygeos

Cụ thể hơn, việc tăng tốc có được sử dụng hay không được xác định bởi

• Nếu PyGEOS >= 0. 8 được cài đặt, nó sẽ được sử dụng theo mặc định [nhưng việc cài đặt GeoPandas sẽ không tự động cài đặt PyGEOS dưới dạng phần phụ thuộc, bạn cần thực hiện việc này theo cách thủ công]

• Bạn vẫn có thể chuyển đổi việc sử dụng PyGEOS khi có sẵn, bằng cách

  • Đặt biến môi trường [

    conda install --channel conda-forge geopandas
    

    0]. Lưu ý rằng biến này chỉ được kiểm tra khi nhập GeoPandas lần đầu tiên. Bạn có thể đặt biến môi trường này trước khi bắt đầu quy trình python hoặc trong mã của bạn ngay trước khi nhập geopandas

    import os
    os.environ["USE_PYGEOS"] = "0"
    import geopandas
    

  • Đặt một tùy chọn.

    conda install --channel conda-forge geopandas
    

    1. Lưu ý, mặc dù biến này có thể được đặt trong phiên tương tác, nhưng nó sẽ chỉ hoạt động nếu GeoDataFrames bạn sử dụng được tạo [e. g. đọc một tệp có

    conda install --channel conda-forge geopandas
    

    2] sau khi thay đổi giá trị này. Chú ý. thay đổi tùy chọn này sẽ không còn hoạt động trong mọi trường hợp khi có Shapely >=2. 0 cài đặt. Trong trường hợp đó, hãy sử dụng biến môi trường [xem tùy chọn ở trên]

Cảnh báo

Việc sử dụng PyGEOS là thử nghiệm. Mặc dù nó vượt qua tất cả các bài kiểm tra, nhưng vẫn có thể có sự cố và không phải tất cả các chức năng của GeoPandas đều được hưởng lợi từ việc tăng tốc [một sự cố đã biết. phép biến đổi tọa độ to_crs làm mất tọa độ z]. Nhưng thử điều này rất được hoan nghênh. Bất kỳ vấn đề nào bạn gặp phải [cũng như các báo cáo về việc sử dụng thành công đều thú vị. ] có thể được báo cáo tại https. // gièm pha. im/geopandas/geopandas hoặc geopandas/geopandas#issues