pmview(1)

NAMN

pmview — bakände för 3D-visualisering av prestandamått

SYNOPSIS

pmview [-Cz] [-A align] [-a archive[,archive,...]] [-c configfile]
       [-D debug] [-h host] [-n pmnsfile] [-O origin] [-p port]
       [-R logconfig] [-r addconfig] [-S starttime] [-t interval]
       [-T endtime] [-x version] [-Z timezone]
       [-geometry geometry] [-display display] [-name name] [-title title]

BESKRIVNING

pmview är ett generaliserat verktyg för 3D-visualisering av prestandamått i Performance Co-Pilot, se pcp(1).

pmview är grundverktyget bakom visualiseringsverktyg för prestandamått såsom dkvis(1), mpvis(1), osvis(1) och nfsvis(1). Det används också av en rad relaterade verktyg som är specifika för valfria Performance Domain Agents, PMDA, och/eller PCP-tilläggsprodukter. pmview kan även användas för att skapa anpassade 3D-visningar av prestanda.

pmview visar prestandamått som färgade block och cylindrar ordnade på monokroma basplan. Varje objekt kan representera ett enskilt prestandamått eller en stapel av flera prestandamått. Eftersom objekten moduleras av värdet på det mått de representerar kan endast numeriska mått visualiseras.

Objekt som representerar ett enskilt mått kan moduleras efter höjd, färg eller både höjd och färg. Objekt i en stapel kan endast höjdmoduleras, men stapeln kan normaliseras till maximal höjd. Etiketter kan läggas till i scenen för att hjälpa till att identifiera grupper av mått.

En konfigurationsfil, angiven med flaggan -c eller läst från standard in, används för att ange position, färg, maxvärde och etiketter för mått och måttinstanser i scenen. Maxvärdet fungerar som en normaliseringsfaktor och används för att skala objektets höjd och/eller färg i proportion till måttvärdena.

Måttvärden som överskrider det associerade maxvärdet visas som helt vita objekt. Om ett mått inte är tillgängligt får objektet minimal höjd och färgas grått.

Den fullständiga syntaxen för scenbeskrivningsspråket finns i pmview(5).

Normalt arbetar verktyget i ”live”-läge där prestandamått hämtas i realtid. Användaren kan visa mått från valfri värd som kör pmcd(1). pmview kan också spela upp arkiv med prestandamått, se pmlogger(1), och låta användaren styra aktuell uppspelningstid och uppspelningshastighet interaktivt enligt VCR-paradigmet.

Detta är särskilt användbart för retrospektiva jämförelser och för postmortem-analys av prestandaproblem där ett fjärrsystem inte är tillgängligt eller där en prestandaanalytiker inte finns på plats.

Alla mått i Performance Metrics Name Space, PMNS, med numerisk värdesemantik från valfritt antal värdar eller arkiv kan visualiseras. pmview undersöker måttens semantik och konverterar, där det är rimligt, måttvärden till en hastighet före skalning.

KOMMANDORADSFLAGGOR

Flaggorna -S, -T, -O och -A kan användas för att definiera ett tidsfönster som begränsar vilka sampel som hämtas, ange en initial utgångspunkt inom tidsfönstret eller ange en ”naturlig” justering av sampeltiderna. Se PCPIntro(1) för en fullständig beskrivning av dessa flaggor.

Övriga tillgängliga flaggor är:

-a archive[,archive,...]]

Ange ett archive från vilket mått kan hämtas för en viss värd. archive är basnamnet för ett arkiv, eller namnet på en katalog som innehåller arkiv, tidigare skapade av pmlogger(1).

Flera uppsättningar arkiv, separerade med kommatecken eller angivna i olika -a-flaggor, från olika värdar kan anges. Ett fel uppstår dock om det finns mer än en arkivuppsättning från samma värd.

Alla mått som inte är kopplade till en viss värd eller ett visst arkiv i konfigurationsfilen kommer att använda den första arkivuppsättningen som källa.

-C

Tolka konfigurationsfilen och avsluta innan pmview-fönstret visas. Eventuella fel i konfigurationsfilen visas.

-c configfile

Läs konfigurationen från configfile i stället för från standard in.

-h host

Hämta prestandamått från pmcd(1) på host, i stället för standardvärden localhost. Detta innebär att pmview körs i live-läge, så inga arkiv kan anges på kommandoraden eller i konfigurationsfilen. Endast en -h-flagga får anges.

-n pmnsfile

Normalt arbetar pmview mot det distribuerade Performance Metrics Name Space, PMNS. Om flaggan -n anges läses i stället ett alternativt lokalt PMNS från filen pmnsfile.

-p port

Anslut till tidskontrollerna, se pmtime(1), på denna port. Detta används när ett verktyg startar ett annat verktyg så att de kan ansluta till samma tidskontroller.

-R logconfig

Använd logconfig som konfiguration för pmlogger(1) vid inspelning.

-r addconfig

Lägg till addconfig i den pmlogger(1)-konfiguration som genereras av pmview vid inspelning.

-t interval

Uppdateringsintervallet som används för att hämta mått från live- eller arkivkällor. Argumentet interval följer syntaxen som beskrivs i PCPIntro(1), och i sin enklaste form kan det vara ett heltal utan tecken. Då antas enheten vara sekunder. Standardvärdet är 2,0 sekunder.

-x version

Använd den angivna version av specifikationen pmlaunch(5). De versioner som för närvarande stöds är ”1.0” och standardversionen ”2.0”.

-Z timezone

Som standard rapporterar pmview tid på dagen enligt den lokala tidszonen på systemet där pmview körs. Flaggan -Z ändrar standardtidszonen till timezone, som ska anges i formatet för miljövariabeln TZ enligt environ(7).

-z

Ändra rapporteringstidszonen till den lokala tidszonen på den värd som är källan till prestandamåtten, identifierad antingen via flaggan -h eller den första -a-flaggan.

-geometry geometry

-display display

-name name

-title title

FÖNSTER

pmview-fönstret består av en menyrad, tids- och skalningskontroller, mått- och tidsvärden samt en ”examiner”-visare.

EXAMINER-VISARE

Den vänstra, högra och nedre kanten av examiner-visaren innehåller olika tumhjul och knappar som kan användas för att justera visualiseringen av 3D-scenen.

Tumhjulen Rotx och Roty låter användaren rotera scenen runt x- respektive y-axeln. Tumhjulet dolly flyttar den virtuella kameran närmare eller längre bort från scenen, vilket gör att användaren kan granska vissa delar i detalj eller visa hela scenen.

På höger sida av visaren finns åtta knappar som påverkar hur användaren kan interagera med scenen.

Pointer

Ändrar markören till en pekare som gör att block kan väljas i scenen. Se avsnittet Måttval nedan.

Hand

Ändrar markören till en hand som gör att scenen kan roteras, flyttas och zoomas med en kombination av musknappar. Vänster musknapp kan användas för att rotera scenen i musens riktning.

Om vänster musknapp släpps innan musen har slutat röra sig fortsätter scenen att rotera. Detta kan stoppas genom att trycka på vänster musknapp igen. Den mellersta musknappen panorerar scenen, och båda musknapparna fungerar som en dolly för den virtuella kameran.

Question Mark

Visar SGI-hjälpinformationen för examiner-visaren.

Home

Återställer scenen till dess ursprungliga position, såvida inte hempositionen har ändrats med knappen Home Pointer.

Home Pointer

Ändrar scenens hemposition till den vy som för närvarande visas.

Eye

Ändrar storlek på scenen så att den helt passar in i 3D-visningsytan.

Cross-hairs

Flyttar objektet under markören till mitten av visningsytan, om handmarkören har valts. Att trycka på tangenten ”s” medan markören är över ett objekt har samma effekt.

Perspective Box

Växlar visningen mellan perspektivprojektion och ortogonal projektion.

Om man trycker på höger musknapp i scenfönstret visas en meny med alternativ som påverkar hur 3D-scenen ritas. Alternativen omfattar bland annat att rita blocken som trådramar och att aktivera stereovisning.

MÅTTVAL

När pekarmarkören är aktiv kan mer information om 3D-scenen hämtas. Text som beskriver måttet som representeras av blocket under markören visas i den övre textrutan i pmview-fönstret.

Texten innehåller måttets källa och namn, aktuellt värde och enheter samt procentandelen av det förväntade maxvärdet, eller normaliseringsvärdet. Textrutan uppdateras när scenen uppdateras med de senaste måttvärdena eller när markören flyttas över ett annat block i scenen.

Om markören flyttas över ett basplansblock, text eller omgivande tomrum töms textrutan.

Om vänster musknapp klickas på ett block låses textrutan till den måttinstansen, så att måttet kan övervakas medan andra åtgärder utförs med musen. Blocket markeras med en röd trådram.

Om vänster musknapp klickas på text eller utrymmet runt scenen avmarkeras objektet, vilket gör att textrutan återgår till sitt ursprungliga beteende och visar måttet under markören.

Om ett basplan väljs i stället för ett modulerat block markeras alla block på det basplanet. När mer än ett objekt är valt beter sig textrutan som om inget vore valt, så måttet som visas är det mått som för närvarande ligger under markören.

Flera val kan också göras genom att hålla ned SHIFT-tangenten medan ett objekt väljs med vänster musknapp.

MENYER

Det finns fyra menyer i pmviews användargränssnitt. De gör det möjligt att spela in, spara och skriva ut scener, via File; komma åt tidskontroller, via Options; starta andra verktyg, via Launch; och öppna direkthjälp, via Help.

File/Record

I live-läge startar detta alternativ pmlogger(1)-processer för att spela in den aktuella scenen i en arkivfolio, se pmafm(1), så att den kan spelas upp senare. Detta alternativ är inte tillgängligt i uppspelningsläge.

När File/Record väljs visas en filväljardialog där namnet på den nya arkivfolion anges. Om katalogen till folion inte finns försöker pmview skapa den. Det är oftast praktiskt att hålla varje folio i en egen katalog, eftersom flera andra filer kommer att associeras med folion, inklusive de genererade arkiven.

När en giltig folio har skapats startar pmview en pmlogger(1)-process för varje värd för att samla in de mått som krävs från den värden i den aktuella scenen. De aktuella markeringarna påverkar inte vilka mått som spelas in.

Medan inspelning pågår visas en röd punkt i tidskontrollknappen i det övre vänstra hörnet av pmview-fönstret. Alternativet File/Record ändras också till File/Stop Recording, eftersom endast en inspelningssession kan pågå åt gången. Att välja block eller starta andra verktyg påverkar inte inspelningssessionen.

Inspelningssessionen kan avslutas genom att välja File/Stop Recording. Då visas dialoger för varje pmlogger(1)-instans som beskriver storleken på och platsen för arkivfilerna innan varje process avslutas. När alla pmlogger(1)-processer har avslutats tas den röda punkten bort från tidskontrollknappen och menyn återgår till File/Record så att en ny inspelningssession kan startas.

Om programmet avslutas medan inspelning pågår visas en dialog som låter dig avsluta varje pmlogger(1)-process eller låta den fortsätta köras frikopplad.

En arkivfolio kan spelas upp med kommandot:

pmafm folio replay

Se pmafm(1) för mer information.

Det är inte ovanligt att ett front-end-skript som genererar en pmview-scen använder mått som inte ingår i själva scenen. Till exempel använder osvis(1) flera hinv-mått för att bestämma storlek och layout för vissa objekt.

Eftersom dessa mått också behövs när det genererade arkivet spelas upp med front-end-skriptet kan en komplett pmlogger(1)-konfiguration anges med -R, vilket ersätter den konfiguration som genereras av pmview. Alternativt kan en extra konfiguration läggas till med -r.

File/Save

Sparar den aktuella scenen till en läsbar Open Inventor-fil, se inventor(1). En fildialog frågar efter platsen för filen. Standardfiländelsen är ”.iv”, vilket känns igen av ivview(1) och vissa webbläsare.

File/Print

Skickar den aktuella scenen till en skrivare. En utskriftsdialog visas där en specifik skrivare kan väljas.

File/Quit

pmview avslutas omedelbart. Om inspelning var aktiv visas dialoger för varje pmlogger(1)-process så att de kan avslutas.

Options/Show Time Control

Visar tidskontrollerna, se pmtime(1), som styr denna instans av pmview. Tidskontrollerna kan delas med andra verktyg, inklusive pmchart(1), som har startats av andra instanser av pmview och oview(1).

Därför kan detta menyalternativ verka sakna effekt om tidskontrollerna redan är synliga.

Options/New Time Control

Kopplar bort från de aktuella tidskontrollerna, som kan delas med andra verktyg, se pmtime(1), och använder en ny tidskontroll som inte är ansluten till några andra verktyg. Den nya tidskontrollen visas omedelbart.

Launch

Startmenyn genereras från en menyspecifikationsfil, se pmlaunch(5). Menyn innehåller verktyg som kan startas baserat på källorna och namnen för de valda måtten i scenen.

Om de valda måtten till exempel kommer från tre olika värdar kan tre kopior av ett verktyg startas, en för varje värd. Hur en start fungerar beror på de valda måtten och vilka verktyg som startas.

När ett Launch-menyalternativ väljs genererar pmview tillståndsinformation i måttspecifikationsformatet för pmlaunch(5). Detta ger en beskrivning av de valda måtten, eller alla mått i scenen om inget är valt, utan någon geometrisk information.

Verktyg som kan övervaka flera värdar och användarvalda mått kan startas endast en gång för dessa mått, exempelvis pmdumptext(1). Andra verktyg som har en fast vy för en värd, exempelvis mpvis(1), kan startas flera gånger, en gång för varje värd i den valda måttlistan.

Om de startade verktygen har tidskontroller kommer de att dela tidskontroller med den pmview som startade dem.

Uppsättningen startade verktyg är konfigurerbar och kan innehålla IRIX- och användarprogram. Se pmlaunch(5) för mer information.

Help/...

Om pcp.books.help har installerats visas insight(1)-böckerna för pmview.

TIDSKONTROLLER

Förutom menyalternativen för tidskontroller visas den aktuella riktningen för tidskontrollerna, se pmtime(1), i en knapp i det övre vänstra hörnet av pmview-fönstret.

Om knappen trycks ned visas tidskontrollen. Detta är identiskt med beteendet för Options/Show Time Control.

SKALNINGSKONTROLLER

Ovanför examiner-fönstret finns ett tumhjul och en redigerbar textruta som låter användaren tillämpa en multiplikator på alla värden som representeras i scenen.

Om hjulet vrids åt höger och/eller textvärdet för skalan ökas, ökas staplarnas höjd. Om hjulet vrids åt vänster och/eller textvärdet sänks, minskas staplarnas höjd.

Knappen till höger om tumhjulet återställer skalan så att staplarna visas med sin ursprungliga höjd för det aktuella värdet.

TIDSINFORMATION

Bredvid skalningskontrollerna finns en annan textruta som visar tiden för de hämtade måtten. Tiden ändras tillsammans med tidskontrollen, se pmtime(1).

DIAGNOSTIK

Diagnostikmeddelanden är avsedda att vara självförklarande.

Miljövariabeln PCP_STDERR kan anges för att tvinga de flesta startvarningar och startfel att skickas till standard felström i stället för att visas i en dialog.

FILER

$PCP_VAR_DIR/pmns/*

Standardfiler för PMNS-specifikationer.

$PCP_VAR_DIR/config/pmlaunch/pmlaunchrc

Menyspecifikationsfil — tillhandahåller en koppling mellan menyalternativ och startat program.

$HOME/.pcp/pmlaunch/pmlaunchrc

Individuell användares menyspecifikation.

/usr/lib/X11/app-defaults/PmView

Programresurser.

/usr/lib/images/PmView.icon

Ikon för pmview.

$PCP_SHARE_DIR/lib/pmview-args

Skalprocedurer för tolkning av pmview-kommandoradsflaggor i front-end-skript.

/usr/lib/DPS/outline/base/

Katalog där Inventor normalt letar efter konturer för Type1-teckensnitt.

MILJÖ

Standardutseendet för 3D-teckensnittet i pmview-fönstret kan ändras via miljövariabeln PMVIEW_FONT, som kan sättas till basnamnet för en Type1-teckensnittsfil i standardkatalogen för Inventor-teckensnitt.

PCP-MILJÖ

Miljövariabler med prefixet PCP_ används för att parametrera fil- och katalognamn som används av PCP.

På varje installation innehåller filen:

/etc/pcp.conf

de lokala värdena för dessa variabler.

Variabeln $PCP_CONF kan användas för att ange en alternativ konfigurationsfil, enligt beskrivningen i pcp.conf(5).

FELSÖKNINGSFLAGGOR

Flaggan -D eller --debug aktiverar ytterligare diagnostik på stderr för att hjälpa till vid felsökning, även om informationen ibland är kryptisk och främst avsedd att ge vägledning för utvecklare snarare än slutanvändare.

debug är en kommaseparerad lista med felsökningsflaggor. Använd pmdbg(1) med flaggan -l för att få en lista över tillgängliga felsökningsflaggor och deras betydelse.

Felsökningsflaggor som är specifika för pmview är följande:

Alternativ	Beskrivning
appl0	Scenuppbyggnad.
appl1	Objektmarkering, avmarkering och start.
appl2	Hämtning och objektmodulering.
appl3	Objektuppdatering.
appl4	UI-objekt, utöver Inventor-fönstret.
pmc	Åtgärder för måttklasser, libpcp_qmc.
timecontrol	Interaktioner med pmtime(1).
qed	Metoder i libpcp_qed.

SE ÄVEN

dkvis(1), insight(1), inventor(1), mpvis(1), nfsvis(1), osvis(1), pcp(1), PCPIntro(1), pmafm(1), pmcd(1), pmchart(1), pmdumptext(1), pmlogger(1), pmtime(1), pmview(1), xconfirm(1), pcp.conf(5), pmview(5), environ(7) och pmlaunch(5).

Relevant information finns också i den nätbaserade PCP-handledningen.

COLOPHON

Denna sida är en del av projektet PCP — Performance Co-Pilot.

Information om projektet finns på:

http://www.pcp.io/

Om du har en felrapport för denna manualsida, skicka den till:

pcp@groups.io

Denna sida hämtades från projektets uppströms Git-arkiv:

https://github.com/performancecopilot/pcp.git

den 16 januari 2026.

Vid den tidpunkten var datumet för den senaste commit som hittades i arkivet den 16 januari 2026.

Om du upptäcker renderingsproblem i denna HTML-version av sidan, eller om du anser att det finns en bättre eller mer uppdaterad källa för sidan, eller om du har rättelser eller förbättringar av informationen i detta COLOPHON-avsnitt, som inte är en del av den ursprungliga manualsidan, skicka e-post till:

man-pages@man7.org

Performance Co-Pilot PMVIEW(1)

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/pmview.1.html Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på https://www.linux.se/kontaka-linux-se/

Tack till Datorhjälp hemma som har sponsrat Linux.se med webbhotell.