коротка інформація
Забезпечує доступ до властивостей і методів шару. Він може посилатися на шари в документі карти (.mxd) або в файлі шару (.lyr).
Об'єкт Layer призначений для роботи з шарами, які знаходяться в документі карти (.mxd) або в файлі шару (.lyr). Об'єкт layer забезпечує доступ до багатьох властивостями шару, які знаходяться в діалоговому вікні Властивості шару (Layer Properties) в ArcMap, а також пропонує методи для збереження файлів шарів. Функція Layer. функція ListLayers і метод listLegendItemLayers об'єкта Legend забезпечують посилання на об'єкт Layer.
Існує велика кількість різних типів шарів, і не всі вони підтримують однаковий набір властивостей. Наприклад, шар об'єктів підтримує визначає запит, тоді як растровий шар його не підтримує, але каталог растров підтримує. Замість того щоб працювати з різними, окремими об'єктами шару з усіх можливих типів шарів і комбінаціями властивостей, можна використовувати метод supports. який допомагає визначити, які типи шарів які властивості підтримують. Метод supports дає можливість перевірити, чи підтримує шар певну властивість, перш ніж намагатися отримати або задати його значення, що зменшує необхідність пошуку помилок.
Чи не до всіх властивостей шару можна отримати доступ за допомогою об'єкта Layer. Існує велика кількість властивостей в діалоговому вікні Властивості шару (Layer Properties) в ArcMap, які не використовуються в середовищі скриптів arcpy (наприклад, властивості відображення, псевдоніми полів, символи виділення і т.д.). Функція UpdateLayer дозволяє замінити всі властивості шару, доступні через діалогове вікно Властивості шару в ArcMap за допомогою файлу шару (.lyr), який містить відповідні налаштування.
Складові шари і інші підшари (наприклад, класи анотацій) обробляються як звичайні шари. Функція ListLayers повертає індексні значення, які генеруються зверху вниз відповідно до розташування в таблиці змісту або в файлі шару (.lyr). Те ж саме відбувається, якщо складовою шар знаходиться всередині іншого складового шару. Наприклад, документ карти з одним складовим шаром, який містить три подслоя, поверне список з чотирьох імен шарів, складеного шару і трьох підшарів, що входять в складовою. Є два способи визначення складеного шару. Можна перевірити, чи підтримує шар властивість isGroupLayer. Або, можна оцінити властивість longName. Значення longName шару буде містити ім'я складеного шару, крім імені шару. Наприклад, шар Layer1 в складеному шарі Group1 матиме значення longName. рівне Group1 \ Layer1. Якщо значення name дорівнює значенню longName. шар не є складовим або не входить в складовою.
Деякі верстви документа карти або файлу шару можуть мати захист паролем, оскільки ім'я користувача та пароль не зберігається разом з файлом шару або документом карти. Документи карти, які містять такі шари, вимагають введення пароля при відкритті. У середовищі скриптів arcpy.mapping, за замовчуванням, ці діалогові вікна не відображаються, але це означає, що шари будуть розглядатися як пошкоджені джерела даних. Іншими словами, захищені шари не будуть відображатися в вихідних даних. Якщо необхідно, щоб ці шари відображалися правильно, можна використовувати кілька опцій. Перш за все, збережіть ім'я користувача і пароль разом із шаром. Потім, функція геообработки CreateArcSDEConnectionFile дозволить створити файл підключення, який буде знаходитися в пам'яті. Якщо ця функція виконана до відкриття документа карти (.mxd) за допомогою функції MapDocument або файлу шару за допомогою Layer. шари SDE будуть відображатися правильно. На даний момент, іншого способу для захищених веб-сервісів немає.
Змінна, яка посилається на файл шару на диску, включить блокування цього файлу (.lyr). Рекомендується видаляти посилання на об'єкт, використовуючи команду Python del в кінці скрипта або в вираженні Python try / except.
Зміна джерела даних шару - це загальна вимога. Якщо два методу об'єкта Layer. які допомагають це зробити. Метод findAndReplaceWorkspacePath призначений для заміни частини або всього шляху робочої області шару. Метод replaceDataSource дозволяє змінити робочу область шару і набір даних джерела. Більш детальне обговорення, інформація про параметри, сценарії і приклади кодів знаходяться в розділі довідки Оновлення та встановлення джерел даних за допомогою arcpy.mapping.
Залежно від типу символів, символи шару можна змінити. Є обмежена кількість типів символів, для яких доступні властивості і методи. Рекомендується спочатку перевірити властивість шару symbologyType. Якщо повертається значення OTHER. символи шару змінити не можна. Якщо повертається інше значення, що не OTHER. властивість шару symbology повертає один з наступних класів символів, кожен зі своїм власним унікальним набором методів і властивостей: GraduatedColorsSymbology. GraduatedSymbolsSymbology. RasterClassifiedSymbology і UniqueValuesSymbology.
Над тимчасовими шарами можуть виконуватися операції управління часом. Не всі типи шарів підтримують властивість часу. Тому, рекомендується спочатку перевірити, чи підтримує шар роботу з часом, використовуючи метод supports. Якщо шар підтримує час, доступ до властивостей часу можна отримати з класу LayerTime.
(Читання і запис)
Дає можливість отримувати або задавати значення яскравості. Нормальна яскравість за замовчуванням - 0%. Введіть значення від + 100% до -100%. Введіть знак "плюс" або "мінус" зліва від значення, щоб визначити позитивне або негативне значення. Не всі шари підтримують властивість brightness (наприклад, складові шари і шари об'єктів), тому рекомендується перевіряти це заздалегідь за допомогою методу supports.
(Читання і запис)
Дає можливість отримувати або задавати значення контрасту. За замовчуванням, нейтральний контраст - 0%. Введіть значення від + 100% до -100%. Введіть знак "плюс" або "мінус" зліва від значення, щоб визначити позитивне або негативне значення. Не всі шари підтримують властивість contrast (наприклад, шари анотацій або шари земельних ділянок), тому рекомендується перевіряти це заздалегідь за допомогою методу supports.
(Читання і запис)
Надає доступ до інформації про підключення для прошарків ArcSDE і веб-сервісів. Повертається результат є парою ключових значень словника. Є два різних словника, які повертаються в залежності від типу шару. Перший - для підключень ArcSDE, другий - для всіх типів шарів веб-сервісів. Словник веб-сервісів містить ключі, які працюють з усіма типами шарів сервісів, а також включає окремі ключі, що працюють тільки в певних типах веб-сервісів (наприклад, WMS має ключ WMSTitle). Перед визначенням специфічних ключів, можна перевірити ключ ServiceType за допомогою скрипта, або використовувати метод get. який дозволяє пропускати недоступні ключі. Не всі шари підтримують властивість serviceProperties (наприклад, шари, що не відносяться до веб-сервісів або сервісів ArcSDE), тому рекомендується перевіряти це заздалегідь за допомогою методу supports.
Ключі для словника ArcSDE
Ключі для словника веб-сервісу
- ServiceType -Властивості, що відображає тип сервісу. Вони включають ImageServer, IMS, MapServer, TiledInternetLayer, WMS і WCS.
- URL -Властивості, що відображає URL сервісу. Якщо підключення до ArcGIS for Server здійснюється по локальній мережі (LAN), значення буде порожнім.
- Сервер -Властивості, що відображає ім'я сервера. Якщо підключення до ArcGIS for Server здійснюється через Інтернет (HTTP), значення буде порожнім.
- Ім'я користувача -Властивості, що відображає ім'я користувача, що використовується для доступу до захищеного сервісу. Якщо сервіс не захищений паролем, це властивість дорівнює нулю.
- ServiceName -Тільки шари сервісу IMS. Властивість відображає ім'я сервісу IMS.
- WMSName -Тільки шари сервісу WMS. Властивість відображає текстову рядок для сервісу WMS, що використовується для комунікації між комп'ютерами.
- WMSTitle -Тільки шари сервісу WMS. Властивість відображає рядок заголовка опису сервісу WMS.
- Name -Тільки шари сервісу WMS. Властивість відображає текстову рядок для шару WMS, що використовується для комунікації між комп'ютерами.
- Title -Тільки шари сервісу WMS. Властивість відображає рядок заголовка опису шару WMS.
(Читання і запис)
Управляє відображенням написів шару. Якщо задано True. написи відображаються; якщо задано False. написи не відображаються. Не всі шари підтримують властивість showLabels (наприклад, растрові шари і шари анотацій), тому рекомендується перевіряти це заздалегідь за допомогою методу supports. Типи шарів, які підтримують властивість showLabels також підтримують властивість labelClasses.
Повертає посилання на клас символів шару. У кожного підтримуваного класу символів шару є власний унікальний набір властивостей. Рекомендується спочатку визначити symbologyType шару, перш ніж змінювати властивості класу символів.
Повертає рядок, яка відображає тип класу символів шару. Не всі типи класів символів підтримуються; якщо клас не підтримується, повертається ключове слово OTHER. Список можливих значень наступний:
Повертає клас LayerTime. який забезпечує доступ до властивостей часу тимчасових шарів.
(Читання і запис)
Дає можливість отримувати або задавати значення прозорості. Це дозволяє бачити нижні шари крізь верхній. Введіть 0. якщо не хочете використовувати прозорість шару. Значення прозорості більше 90 відсотків зазвичай призводить до того, що шар не відображається зовсім. Не всі шари підтримують властивість transparency (наприклад, шари земельних ділянок і підшари веб-сервісів), тому рекомендується перевіряти це заздалегідь за допомогою методу supports.
(Читання і запис)
Управляє відображенням шару. Діє так само, як і відмітка поруч з ім'ям шару в таблиці змісту ArcMap. Якщо задано True. шар відображається; якщо задано False. шар не відображається. Не всі шари підтримують властивість visible (наприклад, заборонені шари веб-сервісу), тому рекомендується перевіряти це заздалегідь за допомогою методу supports.
Повертає шлях до робочої області шару або до файлу підключення. Не всі шари підтримують властивість workspacePath (наприклад, веб-сервіси), тому рекомендується перевіряти це заздалегідь за допомогою методу supports.
Ключове слово, що представляє тип робочої області нових даних.
- ACCESS_WORKSPACE - Персональна база геоданих або робоча область Access
- ARCINFO_WORKSPACE - Робоча область покриття ArcInfo
- CAD_WORKSPACE -Робоча область файлу САПР
- EXCEL_WORKSPACE -Робоча область файлу Excel
- FILEGDB_WORKSPACE -Робоча область файлової бази геоданих
- Немає стиснення (NONE) -Використовується для пропуску параметра
- OLEDB_WORKSPACE -Робоча область бази даних OLE
- PCCOVERAGE_WORKSPACE -Робоча область покриття PC ARC / INFO
- RASTER_WORKSPACE -Робоча область растра
- SDE_WORKSPACE -Робоча область бази геоданих SDE
- SHAPEFILE_WORKSPACE -Робоча область шейп-файлу
- TEXT_WORKSPACE -Робоча область текстового файлу
- TIN_WORKSPACE -Робоча область TIN
- VPF_WORKSPACE -Робоча область VPF
Рядок, що представляє ім'я набору даних в тому вигляді, в якому воно відображається в новій робочій області (не ім'я шару в таблиці змісту). Якщо параметр dataset_name не вказано, метод replaceDataSource спробує замінити набір даних, знайшовши таблицю з таким же ім'ям, що і поточного набору даних шару.
Якщо задано значення True. робоча область оновлюється, тільки якщо значенням workspace_path є допустима робоча область. Якщо значення неприпустимо, робоча область і не замінюється. Якщо задано значення False. метод задає джерело як workspace_path незалежно від допустимого відповідності. В цьому випадку, якщо відповідностей немає, джерело даних пошкоджений.
(Значення за замовчуванням - True)
Більш докладний опис, відомості про параметри, сценарії і приклади коду див. Розділ довідки Оновлення та фіксування джерел даних за допомогою модуля arcpy.mapping.