Qısaca
- Python 3 Script komponentini Grasshopper-da `Maths` bölməsinin `Script` panelindən əlavə etmək olar.
- Giriş parametrləri üçün Item, List və Tree məlumat girişi seçimləri mövcuddur.
- Type Hint skript işə düşməzdən əvvəl giriş məlumatını seçilmiş tipə çevirə bilər.
- İstifadə olunmayan standart çıxış parametrini söndürmək, xüsusilə çoxsaylı komponentlərin olduğu təriflərdə lazımsız emalı azalda bilər.
Bu bələdçi Rhino-nun tərtibatçı sənədlərində 29 sentyabr 2026-cı ildə yenilənmiş Grasshopper Python skriptləşdirmə izahına əsaslanır. Grasshopper-a Python 3 və ya IronPython 2 Script komponenti əlavə etmək mümkündür; ümumi Script komponentində də dil menyusundan Python 3 seçilə bilər. Aşağıdakı addımlar həndəsə yaratmazdan əvvəl komponentin girişlərini, məlumat girişini və çıxışlarını düzgün tənzimləməyə yönəlib. Sənəddə bəzi seçimlərin Rhino versiyasından asılı olduğu xüsusi olaraq qeyd edilir. Məsələn, giriş parametrini məcburi etmək seçimi Rhino 8.14-dən etibarən mövcuddur.
1. Script komponentini əlavə edin və adlandırın
Grasshopper kətanında Maths bölməsinin Script panelindən Python 3 Script komponentini əlavə edin. Başqa bir seçim ümumi Script komponentini yerləşdirib dil menyusundan Python 3 seçməkdir. Komponentə iki dəfə kliklədikdə skript redaktoru açılır; redaktorun status sətrində istifadə olunan Python dilinin versiyası göstərilir.
Skriptlər adətən komponentin daxilində yerləşdirilir və ayrıca fayl kimi saxlanmır. Tərifdə birdən çox skript varsa, komponenti məqsədini ifadə edən adla yenidən adlandırın. Script nişanı və kəsilmə nöqtələri panelində də həmin ad görünür. Giriş və çıxış parametrlərinə də mənalı adlar verin. Beləliklə, tərifi sonradan istifadə edən şəxs hansı məlumatın tələb olunduğunu və nəyin yaradıldığını daha asan anlayar.
2. İlk skripti giriş və çıxışlarla qurun
Script komponentində standart olaraq x və y girişləri, out və a çıxışları olur. Lazım olmadıqda bu parametrləri silmək mümkündür. Giriş və çıxış əlavə etmək və ya silmək üçün idarəetmə elementləri komponentə kifayət qədər yaxınlaşdırdıqda görünür. Bir tərəfdəki bütün parametrləri silmək də mümkündür; bu halda komponent həmin kənarı fərqli göstərir.
Ən sadə sınaqda iki ədədi toplayıb nəticəni a çıxışına mənimsədin:
a = x + yScript-Mode-da komponent giriş dəyişənlərini skript işləməzdən əvvəl təyin edir; çıxış dəyişənlərinə mənimsədilən dəyərlər isə komponentin çıxışlarına ötürülür. Bu nümunədə x və y girişlərinə uyğun dəyərlər qoşulmalıdır. Girişlər boş olarsa, dəyərləri None ola bilər və bu iki dəyəri toplamaq icra zamanı xətaya səbəb olar. Python tip təhlükəsizliyi təmin edən dil olmadığından, uyğun olmayan əməliyyatlar skript işləyərkən problem yarada bilər.
3. Giriş tipini və məlumat girişini seçin
Giriş parametrinə sağ klikləyərək Type Hint təyin etmək, komponentə gələn məlumatın skriptdən əvvəl çevrilməsini təmin edir. Sənəddə verilən nümunədə iki Line dəyəri float tip göstərişi ilə ədədi dəyərlərə çevrilir və skript onları toplayır. Type Hint seçimlərindən həm giriş, həm də çıxış parametrlərində istifadə etmək olar. Çevirmənin gözlənilən nəticəni verib-vermədiyini qoşulmuş məlumatlarla yoxlamaq lazımdır.
Parametr menyusundakı Parameter Access skriptin məlumatı hansı səviyyədə emal edəcəyini müəyyənləşdirir:
| Giriş növü | Skriptə ötürülən struktur | Nə vaxt istifadə olunur? |
|---|---|---|
| Item | Hər məlumat elementi ayrıca emal olunur | Elementləri bir-bir emal etmək üçün |
| List | Bir budaqdakı elementlər birlikdə emal olunur | Bir budağın siyahısını bütöv emal etmək üçün |
| Tree | Bütün məlumat strukturu birlikdə emal olunur | Budaqlar və elementlər üzərində bütöv işləmək üçün |
Item girişində ədəd Python tərəfində tək dəyər kimi, List girişində isə bir budağın dəyərləri siyahı şəklində görünür. Tree girişində Grasshopper məlumat ağacına çıxış əldə edilir. Tip göstərişi ümumi DataTree strukturundakı elementlərin tipini müəyyənləşdirməyə də kömək edə bilər. Giriş növünü seçməzdən əvvəl skriptin tək elementi, siyahını, yoxsa bütün ağacı emal edəcəyi dəqiqləşdirilməlidir.
4. Çıxışları və giriş tələblərini idarə edin
out parametri skriptdəki print() çağırışlarının yaratdığı mətni tutur. Standart davranışda hər sətir ayrıca çıxış elementinə çevrilir. Avoid Grafting Output Lines seçimi aktivləşdirildikdə çap olunan sətirlər vahid element kimi ötürülür. Skript konsola heç nə yazmırsa, komponentin kontekst menyusundakı Standard Output/Error Parameter seçimi ilə out parametrini söndürmək olar.
İstifadə olunmayan out parametrini söndürmək komponentin çap olunan mətni tutub emal etməsinin qarşısını alır. Sənədlərdə qeyd olunur ki, bir komponentdə bunun faydası az ola bilər, lakin çox sayda komponentin minlərlə dəfə işlədiyi böyük Grasshopper təriflərində bu tənzimləmə daha əhəmiyyətli ola bilər.
Script girişləri ilkin olaraq məcburi deyil. Girişə mütləq məlumat verilməlidirsə, giriş parametrinin sağ klik menyusundakı Required seçimindən istifadə etmək olar. Rəsmi sənəddə bu seçimin Rhino 8.14-dən etibarən mövcud olduğu bildirilir. Xüsusilə skripti paylaşmazdan əvvəl məcburi girişləri işarələmək, çatışmayan məlumatla icra riskini azaldır.
Memarlıq və vizuallaşdırma iş axınında istifadə
Memarlar, interyer dizaynerləri və vizuallaşdırma qrupları üçün bu parametrlər təkrarlanan modelləşdirmə addımlarını daha anlaşılan Grasshopper tərifinə çevirməyə kömək edir. Məsələn, skriptin hansı məlumatı gözlədiyini parametr adlarında göstərmək və giriş tipini müəyyənləşdirmək tərifi komanda daxilində təhvil verməyi asanlaşdırır. Item, List və ya Tree seçimi də əməliyyatın ayrı-ayrı elementlərə, yoxsa məlumat qrupuna tətbiq olunacağını müəyyən edir.
Daha mürəkkəb həndəsələr tələb olunduqda bu bələdçi təkbaşına kifayət etmir: mənbə Rhino və ya Grasshopper API-lərini əhatə etmir və bu mövzular üçün ayrıca sənədlərə yönləndirir. Buna görə əvvəlcə sadə skript və kiçik məlumat dəsti ilə iş axınını yoxlayın, sonra real tərifə keçin. Bu mənbələrdə iş stansiyası və ya lisenziya tələbləri barədə məlumat verilmədiyi üçün burada əlavə avadanlıq və ya xərc tövsiyəsi təqdim edilmir.
Tez-tez edilən səhvlər
Boş girişləri nəzərdən qaçırıb
Nonedəyərləri üzərində əməliyyat aparmaq: girişlərin qoşulduğunu və gözlənilən tipdə olduğunu yoxlayın.Parametr girişini skriptin məlumat ehtiyacına uyğun seçməmək: Item, List və Tree fərqli məlumat strukturları təmin edir.
İstifadə olunmayan
outparametrini aktiv saxlamaq:print()çıxışı lazım deyilsə, parametr söndürülə bilər.Parametrlərə aydın adlar verməmək: bu, xüsusilə paylaşılan təriflərdə giriş və çıxışların məqsədini qeyri-müəyyən edir.
Mənbələr
1 mənbəMənbə mətnləri yenidən dərc edilmir; qısa sitatlar işarələnir, qalanı bizim xülasə və şərhimizdir.
Bu sənəddəki tövsiyələrin Türkiyədəki memarlıq və vizuallaşdırma ofisləri üçün əsas dəyəri avadanlığı yeniləməkdən daha çox Grasshopper təriflərini etibarlı və başqasına ötürülə bilən etməsidir. Mənalı parametr adları, düzgün məlumat girişi və zəruri girişlərin müəyyənləşdirilməsi, xüsusilə eyni tərifdən müxtəlif komanda üzvlərinin istifadə etdiyi işlərdə vaxta qənaət edə bilər.
`out` parametrini söndürməyin təsiri bir komponentdə məhdud qala bilər. Lakin çoxsaylı komponentlərin intensiv işlədiyi təriflərdə lazımsız emalı azaltmaq potensialı var. Dəyişiklikləri real iş axınında sınaqdan keçirmək və Rhino versiyasından asılı seçimləri yoxlamaq vacibdir. Mənbələrdə avadanlıq, qiymət və ya lisenziya məlumatı olmadığından bu mövzularda qərar vermək üçün əlavə rəsmi sənədlərə ehtiyac var.
Tez-tez verilən suallar
Grasshopper-da Python 3 Script komponentini necə əlavə etmək olar?
Grasshopper-da `Maths` bölməsinin `Script` panelindən Python 3 Script komponenti əlavə etmək olar. Ümumi Script komponentindən istifadə edilirsə, dil menyusundan Python 3 seçilə bilər.
Grasshopper Python-da Item, List və Tree girişi nə deməkdir?
Item məlumatları bir-bir, List bir budaqdakı elementləri birlikdə, Tree isə bütün məlumat strukturunu emal edir. Seçim skriptin məlumatı necə emal edəcəyinə uyğun edilməlidir.
Grasshopper Python komponentində out parametri nə üçündür?
`out` skriptdə `print()` vasitəsilə çap olunan məzmunu tutur. Konsol çıxışından istifadə olunmursa, komponentin kontekst menyusundan söndürülə bilər.
