In this exercise you will read the surfaces of a hull and check the result against the design on screen. Start with a working copy of a file that opens in Maxsurf Modeler.
1. Prepare the workspace
Use Windows x64, 64-bit CPython 3.12, Codex and a licensed Modeler installation with COM automation available. Run Modeler and the client under the same Windows account. Check the interpreter:
py -3.12 -c "import sys, struct; print(sys.version, struct.calcsize('P') * 8)"Look for Python 3.12.x and a pointer size of 64. Put the working copy in the design folder you authorize during setup.
2. Register the bridge
Follow the installation guide for your build. If a Codex plugin package is available, extract the full archive. With the package in C:\MaxsurfBridge, run:
codex plugin marketplace add "C:/MaxsurfBridge"
codex plugin add maxsurf-mcp@maxsurf-localFor a source installation, follow the PowerShell setup and Codex configuration sections in the same guide. Restart Codex and begin a new chat.
3. Connect to the open design
Ask “Run session_status. Show the workspace, running applications and connected sessions.” With Modeler closed, processes.modeler.running should be false.
Open Modeler, finish any license prompts and load the working copy. Ask “Use connect_maxsurf with module=modeler and policy=activate_existing. Verify the open design. If it matches, use list_surfaces to list the surfaces. Leave the file unchanged.”
4. Check the result
Record the file name, surface count and two surface names from Modeler and from the client. Resolve differences before continuing. If you call hull_summary, check the source, unit and confidence label for each value before using it in another calculation.
Record what you verified
Write down the active file name, the surface count and two surface names exactly as Modeler displays them. Compare those four entries with the client response. The 49-surface result in the release test belongs to that concept file. Your own hull may have a different count.
If the connection fails
Check that Modeler is running and license prompts are closed. If the file lies outside the permitted workspace, open the copy inside that folder. The tool reference lists the required module and inputs.
Read the engineering note: what the hull tests established →
Türkçe metin
Bu alıştırmanın hedefi, kendi bilgisayarınızda açtığınız bir Maxsurf tasarımının kimliğini doğrulamak ve yüzey listesini okumaktır. Sonunda hangi modelin açık olduğunu, hangi yüzeyleri gördüğünüzü ve sonuçları Modeler’da nasıl karşılaştırdığınızı kaydedebileceksiniz.
1. Ortamı hazırlayın
Windows x64, 64 bit CPython 3.12, Codex ve COM otomasyonuna erişebildiğiniz lisanslı bir Maxsurf Modeler kurulumu gerekir. Aşağıdaki komutta sürüm 3.12.x, mimari 64 görünmelidir.
py -3.12 -c "import sys, struct; print(sys.version, struct.calcsize('P') * 8)"Çalışma dosyanızın bir kopyasını belirlediğiniz tasarım klasörüne alın. Kurulumda bu klasörü yetkili çalışma alanı olarak tanımlayın. Modeler’ı ve istemciyi aynı Windows kullanıcısıyla çalıştırın.
2. İstemciye sunucuyu tanıtın
Kurulum belgesinden indirdiğiniz sürüme uygun yolu seçin. Codex paketi bir sürüm varlığı olarak sunuluyorsa arşivin tamamını örneğin C:\MaxsurfBridge klasörüne çıkarın. Bu örnekte yerel eklentiyi şu iki komutla kaydedebilirsiniz.
codex plugin marketplace add "C:/MaxsurfBridge"
codex plugin add maxsurf-mcp@maxsurf-localPaket henüz yayımlanmadıysa aynı belgede “PowerShell source installation” ve “Connect the source installation to Codex” adımlarını izleyin. Kaynak kurulumu için sunucunun Python ortamını oluşturup Codex yapılandırmasındaki yolları kendi klasörlerinize uyarlayın. Codex’i yeniden başlatın ve yeni sohbet açın.
3. Bağlantıyı iki adımda sınayın
Önce “Maxsurf MCP ile session_status sonucunu göster. Çalışma alanını, açık uygulamaları ve bağlı oturumları ayrı ayrı yaz.” isteğini verin. Örneğin Modeler kapalıyken processes.modeler.running alanının false olması beklenir. Sunucudan yanıt alınması ilk kontrolü tamamlar.
Modeler’ı açın, lisans pencerelerini tamamlayın ve çalışma kopyanızı yükleyin. Sonra “connect_maxsurf ile yalnız açık Modeler’a bağlan (module=modeler, policy=activate_existing). Açık tasarımın kimliğini doğrula. Doğrulanırsa list_surfaces ile yüzeyleri listele. Dosyayı değiştirme.” isteğini verin.
4. Sonucu kontrol edin
Dosya adı, yüzey sayısı ve iki örnek yüzey adı için Modeler ile istemcinin gösterdiklerini yan yana yazın. Tasarım kimliği belirsizse veya sayılar uyuşmuyorsa o noktada durup açık belgeyi kontrol edin. hull_summary ile boyutları incelerseniz her alanın kaynak, birim ve güven etiketini de okuyun. Birimi doğrulanmamış bir değeri başka bir hesapta kullanmadan önce Modeler’dan kontrol edin.
Sık karşılaşılan iki durum
Araçlar görünüyor, bağlantı kurulamıyor. Modeler işleminin çalıştığını, lisans pencerelerinin kapandığını ve otomasyon yetkisinin etkin olduğunu kontrol edin. Dosya çalışma alanının dışında. Tasarımın çalışma kopyasını izin verilen klasöre alın ve o kopyayı açın.
Bir sonraki analize geçmeden önce araç referansından gereken modül ve girdileri kontrol edin. Sürümün test edilen kapsamı doğrulama belgesinde açıklanır.
Leave A Comment