Revit API-yə Python ilə giriş: başlanğıc alətləri və ilk iş axını

Bu bələdçidə nə öyrənəcəksiniz?

Revit API-yə başlayarkən məqsəd dərhal əhatəli plagin hazırlamaq deyil; modeldəki elementləri necə tapmağı, xüsusiyyətlərlə necə işləməyi və dəyişiklikləri necə idarə etməyi anlamaqdır. Autodesk-in başlanğıc dərsi Revit API-yə pulsuz alətlərlə çıxış yanaşmasını təqdim edir. Dərsin əsas mövzularına element filtrləri, əməliyyatlar (Transactions) və istifadəçi interfeysi daxildir. Python alətlərini saxlamaq və istifadə etmək də dərsin öyrənmə məqsədləri arasındadır.

Bu bələdçi həmin mövzuları otaq məlumatları üzərindən kiçik bir iş axınına çevirir. Otaq adı, nömrəsi, istifadə növü və tamamlama məlumatları kimi layihə məlumatları ilə bağlı xüsusiyyətləri araşdırmaq üçün anlaşıqlı nümunədir. Məqsəd konkret API çağırışı və ya icra edilə bilən kod təlimatı vermək deyil; mənbələrin dəstəklədiyi alətləri və öyrənmə ardıcıllığını izah etməkdir. Mənbələrdə qeyd olunmayan versiya, quraşdırma qaydası və ya kod nümunəsi fərz edilmir.

Tələblər və alətlər

Autodesk University dərsində istifadə olunan alətlər RevitPythonShell, Revit Lookup və pyRevit kimi göstərilir. Dərs iştirakçılardan Revit haqqında əsas biliklər və başlanğıc səviyyəsində Python bilikləri gözləyir. Revit API tərtibatçı səhifəsinə əsasən, API təkrarlanan tapşırıqları avtomatlaşdırmaq və Revit-in əsas funksiyalarını genişləndirmək üçün .NET əsaslı interfeys təqdim edir.

Başlamazdan əvvəl aşağıdakıları yoxlayın:

• İstifadə olunan Revit quraşdırması və layihə faylı.

• Revit-dən istifadə üzrə əsas biliklər və başlanğıc səviyyəsində Python bilikləri.

• RevitPythonShell, Revit Lookup və pyRevit üçün istifadə etdiyiniz Revit versiyasına aid quraşdırma və uyğunluq məlumatları.

Başlanğıc dərsində konkret Revit versiyası və ya hər alətin cari uyğunluq şərtləri göstərilmir. Buna görə quraşdırmadan əvvəl müvafiq alətlərin sənədlərini yoxlayın. Mənbələrdə hesab tələbləri də açıqlanmadığı üçün xüsusi hesab şərtinin olduğu fərz edilməməlidir.

Başlanğıc üçün addım-addım iş axını

1. Əvvəlcə Revit-də otaq məlumatlarını araşdırın. Bir otaq seçin və Properties palitrasındakı sahələrə nəzər salın. Autodesk-in otaq xüsusiyyətləri sənədində otaq adı, nömrəsi, istifadə növü, şöbə, həmçinin divar, tavan və döşəmə üzlükləri kimi nümunə xüsusiyyətlər sadalanır. Sahə və perimetr dəyərləri yalnız oxumaq üçündür; həcm də yalnız həcm hesablaması aktiv olduqda yalnız oxuna bilən kimi göstərilir. Bu fərqi anlamaq hansı məlumatları oxuyacağınızı və hansını dəyişdirməyi hədəflədiyinizi müəyyənləşdirməyə kömək edir.

2. İlk sınağı elementləri tapmaq problemi kimi müəyyənləşdirin. Məsələn, layihədəki otaq elementlərini müəyyən meyara görə ayırmağı öyrənməklə başlayın. Autodesk University dərsində RevitPythonShell ilə elementləri toplamaq və filtrləmək əsas öyrənmə məqsədlərindən biri kimi göstərilir. Kod yazmazdan əvvəl hansı elementlərin seçiləcəyini və filtr şərtinin nə demək olduğunu sadə dillə təsvir edin. Konkret API çağırışlarını isə Autodesk-in tərtibatçı bələdçisindən və kod nümunələrindən yoxlayın.

3. Revit Lookup-ı dərsin alətlər siyahısında nəzərə alın. Autodesk University mənbəsində Revit Lookup dərsdə istifadə olunan alətlərdən biri kimi qeyd edilir; lakin təqdim olunan açıqlamada alətin funksiyaları və ya istifadə addımları təfərrüatlandırılmır. Buna görə konkret yoxlama funksiyası və ya interfeys yolu fərz etmədən, alətin istifadəsi barədə məlumatı öz sənədlərindən yoxlayın. Beləcə, mənbələrin təsdiqləmədiyi xüsusiyyəti öyrənmə axınının qəti hissəsi kimi qəbul etməzsiniz.

4. Model dəyişikliklərini Transactions mövzusu ilə birlikdə öyrənin. Dərsdə RevitPythonShell vasitəsilə elementlər üzərində əməliyyat aparmaq əsas mövzular arasındadır. Model məlumatlarını dəyişdirən sınaqlardan əvvəl nəzərdə tutulan dəyişikliyi kiçik və aydın şəkildə müəyyənləşdirin. Otaq adı kimi məlumatı dəyişdirmək sahə kimi yalnız oxuna bilən dəyəri oxumaqla eyni əməliyyat deyil. Dəyişikliyin layihə faylına təsirini yoxlamadan genişmiqyaslı avtomatlaşdırmaya keçməyin. Mənbələrdə əməliyyatı başlatmaq və bitirmək üçün konkret kod nümunəsi olmadığından, tətbiq ediləcək üsulu müvafiq API sənədlərindən yoxlayın.

5. Python alətini saxlamaq və yenidən istifadə etmək üçün məqsəd müəyyənləşdirin. Başlanğıc dərsində Python alətlərini saxlamaq və istifadə etmək də öyrənmə məqsədləri sırasındadır. Əvvəlcə bir tapşırıq üçün kiçik sınaq hazırlayın, sonra həmin işi təkrar istifadə etməyə ehtiyac olub-olmadığını dəyərləndirin. pyRevit dərsin alətlər siyahısında yer alır, lakin mənbə mətnində konkret pyRevit əmri və ya istifadə axını təqdim edilmir. Quraşdırma və tətbiq təfərrüatlarını bu alətin cari sənədlərindən yoxlayın.

6. Nəticəni otaq xüsusiyyətləri ilə müqayisə edin. API ilə işləyərkən əldə etdiyiniz məlumatları Revit-də görünən otaq xüsusiyyətləri ilə müqayisə etmək oxunan məlumatı yoxlamağa kömək edir. Autodesk sənədinə əsasən, otaq nömrəsi layihə daxilində unikal olmalıdır; nömrə daha əvvəl istifadə olunubsa Revit xəbərdarlıq verir, lakin davam etməyə imkan yaradır. Sınaq zamanı xəbərdarlıq verilməsini əməliyyatın tamamilə bloklanması ilə qarışdırmayın. Sahə və perimetr yalnız oxumaq üçündür; həcmin yalnız oxuna bilən olması isə həcm hesablamasının aktivliyindən asılıdır.

Tez-tez rast gəlinən səhvlər

• Versiyanı fərz etmək: Başlanğıc dərsində konkret Revit və ya alət versiyası göstərilmir. Quraşdırma və uyğunluq məlumatlarını ayrıca yoxlayın.

• Hər otaq xüsusiyyətinin redaktə edilə biləcəyini düşünmək: Sahə və perimetr yalnız oxumaq üçündür. Həcm də yalnız həcm hesablaması aktiv olduqda yalnız oxuna bilən kimi göstərilir. Əməliyyatdan əvvəl xüsusiyyətin xarakterini yoxlayın.

• Filtri müəyyənləşdirmədən kod yazmaq: Əvvəlcə hansı elementlərin hansı şərtə əsasən seçiləcəyini müəyyənləşdirin, sonra API sənədləri və kod nümunələri ilə davam edin.

• Transactions mövzusunu ötürmək: Modeldə dəyişiklik etməyi nəzərdə tutan sınaqlarda əməliyyatlar mövzusunu öyrənmə planına daxil edin. Konkret tətbiq üsulunu API sənədlərindən yoxlayın.

• Alətin adından mənbədə göstərilməyən funksiyalar çıxarmaq: RevitPythonShell, Revit Lookup və pyRevit dərsin alətləri arasında sadalanır, lakin mənbə onların bütün funksiyalarını və cari quraşdırma addımlarını açıqlamır.

Növbəti addımlar: memarlıq və vizuallaşdırma iş axınları

Bu başlanğıc iş axınından otaq nömrəsi, adı, istifadə növü və üzlük məlumatları kimi layihə məlumatlarını anlamaq üçün istifadə edə bilərsiniz. Revit API səhifəsində avtomatlaşdırma, simulyasiya və tikinti kimi sahələrdə proqramın əsas funksiyalarını genişləndirmək imkanlarından bəhs olunur. Bu, təkrarlanan məlumat işlərini araşdırmaq üçün istiqamət verir, lakin konkret avtomatlaşdırmanın hər layihədə eyni nəticəni verəcəyi demək deyil.

Memarlar və interyer dizaynerləri üçün prioritet modeldəki məlumatların xarakterini və hansı xüsusiyyətlərdən istifadə oluna biləcəyini anlamaqdır. BIM və vizuallaşdırma komandaları isə ehtiyac duyduqları məlumatlarla necə işləyəcəklərini kiçik sınaqlarla qiymətləndirə bilərlər. Daha böyük alətə keçməzdən əvvəl istifadə olunan Revit versiyası ilə alətlərin uyğunluğunu, dəyişikliklərin layihəyə təsirini və lisenziya şərtlərini yoxlayın. Autodesk University dərsi API-yə pulsuz alətlərlə çıxış yanaşmasını izah edir; lakin bu ifadə bütün proqram və versiyaların cari lisenziya şərtlərini açıqlamır.

Mənbə və lisenziya

Bu bələdçi Autodesk-in Revit API tərtibatçı səhifəsi, Autodesk Revit 2025 yardım bölməsindəki otaq xüsusiyyətləri sənədi və Autodesk University-də yayımlanmış “Revit Programming for Beginners: Easily Access the Revit API Using Free Tools” dərsi əsasında Azərbaycan dilinə uyğunlaşdırılıb. Mənbə qeydlərində lisenziya statusu “sərbəst” kimi göstərilir; konkret Creative Commons lisenziyası barədə məlumat verilmədiyindən açıq lisenziya iddiası irəli sürülmür.