การติดตั้ง Python - การติดตั้ง Conda


คุณติดตั้ง Earth Engine Python API ในเครื่องได้ผ่าน conda ซึ่งเป็นแพ็กเกจและเครื่องมือจัดการสภาพแวดล้อมของ Python Conda มาพร้อมกับ Anaconda และ Miniconda การกระจาย Python Anaconda คือแพลตฟอร์มการเขียนโปรแกรมด้านวิทยาศาสตร์ข้อมูล ที่มีแพ็กเกจกว่า 1, 500 รายการ ส่วน Miniconda มีเพียง conda และ การอ้างอิงเท่านั้น การกระจาย Python ทั้ง 2 แบบนี้เหมาะสำหรับ การติดตั้งและทำงานกับ Earth Engine API หากไม่คุ้นเคยกับการจัดจำหน่ายเหล่านี้ โปรดไปที่ลิงก์ของแพลตฟอร์มเพื่อดูข้อมูลเพิ่มเติม

คู่มือนี้จะแนะนำคุณเกี่ยวกับสิ่งต่อไปนี้

  • การตรวจสอบว่ามีการติดตั้ง conda อยู่หรือไม่
  • การติดตั้ง conda ในเครื่อง
  • การติดตั้ง Earth Engine Python API
  • การตั้งค่าข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์
  • การทดสอบ API

ตรวจสอบการติดตั้ง conda

หากติดตั้ง conda ไว้ในระบบแล้ว ให้ข้ามไปยังส่วนติดตั้ง API หากไม่แน่ใจว่าได้ติดตั้ง conda หรือไม่ ให้ตรวจสอบโดยป้อนคำสั่งต่อไปนี้ในอินเทอร์เฟซบรรทัดคำสั่ง

conda --help

หากติดตั้ง conda และลงทะเบียนเส้นทางระบบในตัวแปรสภาพแวดล้อม PATH เนื้อหาความช่วยเหลือของ conda ควรปรากฏใน เทอร์มินัล หากเนื้อหาความช่วยเหลือปรากฏขึ้น ให้ข้ามไปที่ส่วน ติดตั้ง API หากระบบไม่รู้จัก conda ผลลัพธ์จะมีลักษณะดังนี้ ไม่พบ conda หรือไม่รู้จักเป็นคำสั่ง เป็นไปได้ว่าโปรแกรมดังกล่าวมีอยู่ในระบบ แต่ไม่ได้ลงทะเบียนในตัวแปรสภาพแวดล้อม PATH แม้ว่าจะเป็นกรณีนี้ แต่เพื่อความสอดคล้องกัน โปรดทำตามส่วนติดตั้ง conda ต่อไป เนื่องจากเป็นการยากที่จะจัดการกับการกำหนดค่าระบบที่เป็นไปได้ทั้งหมด ตราบใดที่โฟลเดอร์ "miniconda3" ไม่มีอยู่ในโฟลเดอร์หน้าแรก คำสั่งติดตั้ง conda ต่อไปนี้ควรสำเร็จ ดูข้อมูลเพิ่มเติมเกี่ยวกับตำแหน่งการติดตั้งและการลงทะเบียน conda ได้ที่หน้าการติดตั้ง Miniconda และการติดตั้ง Anaconda

ติดตั้ง conda

ในส่วนนี้ คุณจะดาวน์โหลดและติดตั้ง Miniconda ซึ่งจะทำหน้าที่เป็นแพลตฟอร์ม Python เพื่อเข้าถึง Earth Engine API ดังที่อธิบายไว้ข้างต้น คุณอาจใช้ Miniconda หรือ Anaconda ก็ได้ แต่เพื่อลดผลกระทบต่อระบบ คู่มือนี้จะอธิบายการติดตั้ง Miniconda โดยไม่มีการเปลี่ยนแปลงตัวแปรสภาพแวดล้อมของระบบ หากต้องการใช้ Anaconda โปรดดู วิธีการติดตั้งที่ระบุไว้ ที่นี่ แล้วข้ามไปที่ส่วน ติดตั้ง API

ติดตั้ง Miniconda

การดาวน์โหลดและติดตั้ง Miniconda ทำได้ใน 3 ขั้นตอน ดังนี้

  1. ดาวน์โหลดโปรแกรมติดตั้ง Python 3 Miniconda แบบ 64 บิตไปยังไดเรกทอรีหน้าแรก
  2. เรียกใช้โปรแกรมติดตั้ง
  3. ลบโปรแกรมติดตั้ง

ทำตามขั้นตอนเหล่านี้โดยคัดลอกและวางบรรทัดต่อไปนี้ลงใน อินเทอร์เฟซบรรทัดคำสั่งที่เหมาะสมสำหรับระบบของคุณ การติดตั้ง จะทำให้ระบบเพิ่มโฟลเดอร์ชื่อ "miniconda3" ลงในไดเรกทอรีหน้าแรก

1. ดาวน์โหลดโปรแกรมติดตั้ง Miniconda ไปยังไดเรกทอรีหน้าแรก

Linux

wget https://repo.continuum.io/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda.sh

Mac

curl https://repo.anaconda.com/miniconda/Miniconda3-latest-MacOSX-x86_64.sh -o ~/miniconda.sh

Windows

powershell -command "Invoke-WebRequest -Uri https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe -OutFile ~\miniconda.exe"

2. ติดตั้ง Miniconda แบบเงียบๆ โดยยอมรับค่าเริ่มต้นในไดเรกทอรีหน้าแรก

Linux

bash ~/miniconda.sh -b

Mac

bash ~/miniconda.sh -b

Windows

start /B /WAIT %UserProfile%\miniconda.exe /InstallationType=JustMe /AddToPath=0 /RegisterPython=0 /S /D=%UserProfile%\miniconda3

3. นำโปรแกรมติดตั้ง Miniconda ออกจากไดเรกทอรีหน้าแรก

Linux

rm ~/miniconda.sh

Mac

rm ~/miniconda.sh

Windows

del %UserProfile%\miniconda.exe

ทดสอบการติดตั้ง Miniconda

พิมพ์เมนูความช่วยเหลือของคำสั่ง conda เพื่อทดสอบการติดตั้ง Miniconda เนื่องจากยังไม่ได้เพิ่ม Miniconda ลงในตัวแปรสภาพแวดล้อม PATH ของระบบ คุณจึงต้องเปิดใช้งาน conda สำหรับเซสชันนี้ก่อนโดย เรียกใช้คำสั่ง activate ตามเส้นทางระบบแบบเต็ม การทดสอบที่สำเร็จ จะทำให้condaเนื้อหาความช่วยเหลือปรากฏในเทอร์มินัล เรียกใช้ บรรทัดต่อไปนี้ในอินเทอร์เฟซบรรทัดคำสั่งของระบบ

Linux

source $HOME/miniconda3/bin/activate
conda --help

Mac

source $HOME/miniconda3/bin/activate
conda --help

Windows

%UserProfile%\miniconda3\condabin\activate
conda --help

เพิ่ม Miniconda ลงในตัวแปร PATH

คุณเลือกเพิ่มเส้นทางการติดตั้ง Miniconda ลงในตัวแปร PATH ของระบบได้ ซึ่งจะช่วยให้คุณโต้ตอบกับ conda ได้โดยการเรียกใช้ conda อย่างง่ายๆ โดยไม่ต้องเรียกใช้คำสั่ง activate ตามเส้นทางแบบเต็มก่อน วิธีการต่อไปนี้จะอธิบายขั้นตอนการเพิ่ม การติดตั้ง Miniconda ลงในตัวแปร PATH ของระบบ

Linux

เพิ่มเส้นทางต่อไปนี้ลงในตัวแปรสภาพแวดล้อม "PATH" โดย ทำตามวิธีการใน GUI หรือบรรทัดคำสั่งด้านล่าง

$HOME/miniconda3/bin

GUI

1. เปิดไฟล์ .bashrc ที่อยู่ในไดเรกทอรี $HOME ในเครื่องมือแก้ไขข้อความ

xdg-open ~/.bashrc

2. คัดลอกและวางบรรทัดต่อไปนี้ที่ด้านล่างของไฟล์

# add path to conda
export PATH="$HOME/miniconda3/bin:$PATH"

3. บันทึกไฟล์และปิดเครื่องมือแก้ไขข้อความ

บรรทัดคำสั่ง

ป้อนคำสั่งต่อไปนี้ในเทอร์มินัลเพื่อผนวกเส้นทาง conda เข้ากับไฟล์ ~/.bashrc 

printf '\n# add path to conda\nexport PATH="$HOME/miniconda3/bin:$PATH"\n' >> ~/.bashrc

Mac

เพิ่มเส้นทางต่อไปนี้ลงในตัวแปรสภาพแวดล้อม "PATH" โดย ทำตามวิธีการใน GUI หรือบรรทัดคำสั่งด้านล่าง

$HOME/miniconda3/bin

GUI

1. เปิดไฟล์ .bashrc ที่อยู่ในไดเรกทอรี $HOME ในเครื่องมือแก้ไขข้อความ

touch ~/.bashrc; open -t ~/.bashrc

2. คัดลอกและวางบรรทัดต่อไปนี้ที่ด้านล่างของไฟล์

# add path to conda
export PATH="$HOME/miniconda3/bin:$PATH"

3. บันทึกไฟล์และปิดเครื่องมือแก้ไขข้อความ

บรรทัดคำสั่ง

ป้อนคำสั่งต่อไปนี้ในเทอร์มินัลเพื่อผนวกเส้นทาง conda เข้ากับไฟล์ ~/.bashrc 

printf '\n# add path to conda\nexport PATH="$HOME/miniconda3/bin:$PATH"\n' >> ~/.bashrc

Windows

เพิ่มเส้นทางต่อไปนี้ไปยังตัวแปรสภาพแวดล้อม "Path" โดย ทำตามวิธีการ GUI หรือบรรทัดคำสั่งด้านล่าง

%UserProfile%\miniconda3\condabin

GUI

1. ป้อนบรรทัดต่อไปนี้ใน Command Prompt เพื่อเปิดกล่องโต้ตอบ "ตัวแปรสภาพแวดล้อม" 

rundll32 sysdm.cpl,EditEnvironmentVariables

2. ดับเบิลคลิกตัวแปร "Path" ในส่วน "ผู้ใช้" เพื่อเลือก ตัวแปรสำหรับการแก้ไข

3. คลิกปุ่ม "แก้ไขข้อความ" ในกล่องโต้ตอบ "แก้ไข" ใหม่เพื่อ เปิดเครื่องมือแก้ไข

4. เพิ่มสตริงต่อไปนี้ที่ส่วนท้ายของค่าตัวแปร "Path" ที่มีอยู่ ตรวจสอบว่ามีเครื่องหมายเซมิโคลอน (;) คร่อมรายการเพื่อแยกรายการนั้น ออกจากรายการที่อยู่ข้างเคียง

%UserProfile%\miniconda3\condabin;

5. คลิกปุ่ม "ตกลง" จนกว่าหน้าต่างกล่องโต้ตอบทั้งหมดจะปิด

บรรทัดคำสั่ง

ใช้คำสั่ง setx เพื่อต่อท้ายเส้นทาง จาก Command Prompt ให้ป้อนคำสั่งต่อไปนี้

setx Path "%Path%%UserProfile%\miniconda3\condabin;"

เริ่มต้น conda

เริ่มต้น conda สำหรับการโต้ตอบกับเชลล์ เรียกใช้คำสั่งต่อไปนี้เพื่อดู ข้อมูลเกี่ยวกับการเริ่มต้นสำหรับเชลล์ต่างๆ ทำตามวิธีการ ที่พิมพ์ในคอนโซลหลังจากป้อนคำสั่ง

conda init --help

หลังจากรีสตาร์ทอินเทอร์เฟซบรรทัดคำสั่งแล้ว คุณควรจะ เปิดใช้งานสภาพแวดล้อม conda ฐานได้ด้วยคำสั่งต่อไปนี้

conda activate

Install API

เราเผยแพร่ Python API ของ Earth Engine เป็นแพ็กเกจ conda-forge ที่ https://anaconda.org/conda-forge/earthengine-api โดยจะติดตั้งด้วยคำสั่ง conda install อย่างไรก็ตาม ก่อนติดตั้ง ให้สร้างสภาพแวดล้อม conda สำหรับ Earth Engine โดยเฉพาะ การติดตั้ง Earth Engine API ในสภาพแวดล้อมของตัวเองจะช่วยให้มั่นใจได้ว่า API และแพ็กเกจที่ขึ้นอยู่กับ API จะไม่ทำให้เกิดปัญหาการกำหนดเวอร์ชันกับสภาพแวดล้อมพื้นฐานหรือสภาพแวดล้อมอื่นๆ ที่คุณตั้งค่าไว้ก่อนหน้านี้ และในทางกลับกัน ดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการสภาพแวดล้อม conda ได้ที่เว็บไซต์นี้

1. เปิดใช้งานสภาพแวดล้อม conda ฐาน หากยังไม่ได้ดำเนินการ

Linux

source $HOME/miniconda3/bin/activate

Mac

source $HOME/miniconda3/bin/activate

Windows

%UserProfile%\miniconda3\condabin\activate

2. สร้างสภาพแวดล้อมเสมือนของ conda สำหรับ Earth Engine API

conda create --name ee

ระบบจะขอให้คุณยืนยันการสร้างสภาพแวดล้อม ให้ดำเนินการดังกล่าว

3. เปิดใช้งานสภาพแวดล้อม ee ของ conda

conda activate ee

4. ติดตั้ง API ในสภาพแวดล้อม ee ของ conda ตรวจสอบว่า (ee) ปรากฏที่จุดเริ่มต้นของบรรทัดคำสั่ง ซึ่งบ่งชี้ว่าคุณกำลังทำงาน จากสภาพแวดล้อม ee

conda install -c conda-forge earthengine-api

ระบบจะขอให้คุณยืนยันการติดตั้ง API และ การอ้างอิง หลังจากยืนยันแล้ว conda จะดาวน์โหลดและติดตั้ง การขึ้นต่อกัน หากทุกอย่างเป็นไปด้วยดี ตอนนี้คุณจะมีสภาพแวดล้อม conda ชื่อ "ee" พร้อมข้อกำหนดทั้งหมดสำหรับการเข้าถึง API รวมถึง earthengine เครื่องมือบรรทัดคำสั่ง

รับข้อมูลเข้าสู่ระบบ

ก่อนใช้ Earth Engine API หรือเครื่องมือบรรทัดคำสั่ง earthengine คุณต้องทำการตรวจสอบสิทธิ์แบบครั้งเดียวที่ให้สิทธิ์เข้าถึง Earth Engine ในนามของบัญชี Google หากต้องการตรวจสอบสิทธิ์ ให้ใช้คำสั่ง authenticate จากเครื่องมือบรรทัดคำสั่ง earthengine

ภายในสภาพแวดล้อม ee ของ conda ให้เรียกใช้คำสั่งต่อไปนี้และทำตาม วิธีการที่พิมพ์ออกมา เราจะระบุ URL ที่สร้าง รหัสการให้สิทธิ์เมื่อคุณยอมรับ คัดลอกรหัสการให้สิทธิ์และ ป้อนเป็นอินพุตบรรทัดคำสั่ง

earthengine authenticate

เมื่อป้อนรหัสการให้สิทธิ์ ระบบจะบันทึกโทเค็นการให้สิทธิ์ ลงในไฟล์ข้อมูลเข้าสู่ระบบซึ่งดูได้ที่ด้านล่าง การใช้คำสั่ง ee.Initialize() ของ API และเครื่องมือบรรทัดคำสั่ง earthengine ในครั้งต่อๆ ไป จะอ้างอิงไฟล์นี้เพื่อตรวจสอบสิทธิ์ หากต้องการเพิกถอน การให้สิทธิ์ เพียงลบไฟล์ข้อมูลเข้าสู่ระบบ

Linux

ls $HOME/.config/earthengine/credentials

Mac

ls $HOME/.config/earthengine/credentials

Windows

dir %UserProfile%\.config\earthengine\credentials

การทดสอบ API

เรียกใช้สคริปต์ Python อย่างง่ายที่พิมพ์ข้อมูลเมตาสำหรับชุดข้อมูล DEM เพื่อทดสอบ การติดตั้ง API ซึ่งควรพิมพ์ออบเจ็กต์ JSON ไปยังคอนโซล

1. เริ่มpythonอินเทอร์พรีเตอร์จากสภาพแวดล้อม ee ของ conda

python

2. เรียกใช้บรรทัด Python ต่อไปนี้ทีละบรรทัดเพื่อพิมพ์ข้อมูลเมตาสำหรับชุดข้อมูล DEM 

import ee

# Initialize the Earth Engine module.
ee.Initialize()

# Print metadata for a DEM dataset.
print(ee.Image('USGS/SRTMGL1_003').getInfo())

การใช้ API ในภายหลัง

หากต้องการใช้ Earth Engine API คุณต้องเปิดใช้งานสภาพแวดล้อม conda ee ก่อน ขั้นตอนการเปิดใช้งานจะขึ้นอยู่กับว่าได้ลงทะเบียน conda เพื่อใช้ในเชลล์หรือไม่ ทำตามวิธีการ ที่เกี่ยวข้องกับการติดตั้ง conda ด้านล่าง

ไม่ได้ลงทะเบียน Conda

คำสั่งเปิดใช้งานสภาพแวดล้อม ee ของ conda ต่อไปนี้ถือว่า ได้ติดตั้ง conda ตามวิธีการในส่วนติดตั้ง conda ด้านบนแล้ว กล่าวคือ ระบบจะถือว่าเส้นทางการติดตั้งเป็นไปตามขั้นตอนก่อนหน้า เรียกใช้คำสั่งต่อไปนี้ในอินเทอร์เฟซบรรทัดคำสั่ง

Linux

source $HOME/miniconda3/bin/activate ee

Mac

source $HOME/miniconda3/bin/activate ee

Windows

%UserProfile%\miniconda3\condabin\activate ee

ลงทะเบียน Conda แล้ว

คำสั่งเปิดใช้งานสภาพแวดล้อม ee ของ conda ต่อไปนี้ถือว่า มีการจดทะเบียน conda เพื่อใช้ใน Shell หรือ Command Prompt โดย วิธีการในคู่มือนี้ หรือโดยวิธีอื่นๆ เรียกใช้คำสั่งต่อไปนี้ในอินเทอร์เฟซบรรทัดคำสั่ง

conda activate ee

หลังจากเรียกใช้คำสั่งแล้ว คุณควรเห็น (ee) ที่จุดเริ่มต้นของ บรรทัดคำสั่ง ซึ่งบ่งบอกว่าคุณกำลังทำงานจากสภาพแวดล้อม ee

ตอนนี้คุณพร้อมที่จะเริ่มตัวแปล Python และเข้าถึง Earth Engine Python API แล้ว โปรดดูคำแนะนำทั่วไปเกี่ยวกับการทำงานกับ Python API ที่หน้าการติดตั้ง Python

การอัปเดต API

ใช้คำสั่ง conda update เพื่ออัปเดตสภาพแวดล้อม ee เป็น API เวอร์ชันล่าสุด อย่าลืมเปิดใช้งานสภาพแวดล้อม conda ee ก่อน หากยังไม่ได้เปิดใช้งาน

conda update -c conda-forge earthengine-api

รับหมายเลขเวอร์ชันที่ติดตั้งอยู่ใน Python โดยการพิมพ์พร็อพเพอร์ตี้ee ไลบรารี__version__ เริ่มตัวแปล Python โดยป้อน python ในบรรทัดคำสั่งของสภาพแวดล้อม ee conda แล้วป้อนคำสั่ง ต่อไปนี้

import ee
print(ee.__version__)

การแชร์สภาพแวดล้อม ee

การแชร์สภาพแวดล้อม Python ของ conda กับผู้อื่นอาจมีประโยชน์ในการ สร้างผลลัพธ์ที่ทำซ้ำและจำลองได้ โดยเฉพาะเมื่อคุณ ติดตั้งแพ็กเกจ Python เพิ่มเติม Conda เป็นวิธีที่สะดวกสำหรับ ผู้อื่นในการจำลองสภาพแวดล้อมของคุณ

จากสภาพแวดล้อม ee ของ conda ให้เรียกใช้คำสั่งต่อไปนี้เพื่อบันทึกไฟล์ YAML ชื่อ "ee-shared-env" ลงในไดเรกทอรีหลัก ซึ่งจะแสดงรายการข้อกำหนดของสภาพแวดล้อม

Linux

conda env export > $HOME/ee-shared-env.yml

Mac

conda env export > $HOME/ee-shared-env.yml

Windows

conda env export > %UserProfile%\ee-shared-env.yml

แชร์ไฟล์ที่ได้ และผู้รับจะจำลองสภาพแวดล้อมได้ โดยเรียกใช้คำสั่ง conda ต่อไปนี้

conda env create -f path-to-ee-shared-env.yml